Τα API κοινωνικών μέσων έχουν αυξηθεί πολύ από τότε που η Google κυκλοφόρησε την πρώτη έκδοση του API του YouTube τον Μάιο του 2008 και από τότε που το Facebook κυκλοφόρησε την πρώτη έκδοση του Graph API τον Απρίλιο του 2010. Σήμερα, αυτά τα API σάς δίνουν την ευκαιρία να αναζητήσετε πλατφόρμες κοινωνικών μέσων: δημοσιεύσεις, χρήστες, κανάλια και δημογραφικά δεδομένα. Σας επιτρέπουν επίσης να δημιουργήσετε τη δική σας υπηρεσία ή να μάθετε περισσότερα για τη βάση χρηστών σας.
Σε αυτό το άρθρο, θα εξετάσουμε τους τρόπους με τους οποίους μπορούμε να χρησιμοποιήσουμε μερικά από τα δημοφιλή API κοινωνικών μέσων:
- Facebook (API γραφικών και μάρκετινγκ)
- Ίνσταγκραμ
- Κελάδημα
- Youtube
Θα συζητήσουμε επίσης τους περιορισμούς του και θα διερευνήσουμε μερικά από τα πιο χρήσιμα εργαλεία που διατίθενται με αυτά τα API. Στη συνέχεια, στο άρθρο, θα ρίξουμε μια ματιά στον τρόπο ενσωμάτωσης αυτών των API σε οποιαδήποτε εφαρμογή του Ράγες .
Χρησιμοποιήστε ένα API κοινωνικού δικτύου για να γνωρίσετε τους χρήστες σας καλύτερα από ό, τι γνωρίζουν οι ίδιοι » Τιτίβισμα
Θα επικεντρωθώ στο API ενός κοινωνικού δικτύου κάθε φορά, για να εξηγήσω τις δυνατότητες, τους περιορισμούς και τα διαθέσιμα εργαλεία του. Θα υπάρχει ένας πίνακας με τα διαφορετικά API και τις ιδιότητές τους για καλύτερη σύγκριση αργότερα στο άρθρο.
Προτού μπορέσετε να χρησιμοποιήσετε τα API, πρέπει πρώτα να εγκαταστήσετε μια εφαρμογή που δημιουργεί ερωτήσεις εκ μέρους της εφαρμογής σας με αιτήματα που βασίζονται στο OAuth. Οι χρήστες θα ελέγχουν τα στοιχεία τους στην εφαρμογή σας και μετά από αυτό, μπορείτε να έχετε πρόσβαση στα δεδομένα τους με το αναγνωριστικό πρόσβασης χρήστη που προκύπτει.
Το ξεπερασμένο FQL (Facebook Query Language) χρησιμοποιείται για μια γλώσσα ερωτήματος παρόμοια με τη SQL, η οποία θα μπορούσε να χρησιμοποιηθεί για πρόσβαση σε όλα τα δεδομένα του Facebook.
Το Facebook κυκλοφόρησε την πρώτη έκδοση του Graph API του τον Απρίλιο του 2010. Η πιο πρόσφατη έκδοση, από αυτήν τη γραφή, είναι η 2.6, η οποία παρουσιάστηκε στις 12 Απριλίου 2016. Πρόκειται για ένα API χαμηλού επιπέδου HTTP. Που μπορεί να χρησιμοποιηθεί για ζητήστε δεδομένα, δημιουργήστε αναρτήσεις και ακόμη δημιουργήστε αυτοματοποιημένες διαφημιστικές καμπάνιες.
Εργαλεία
ο API Εξερεύνηση γραφημάτων Είναι το πιο συχνά χρησιμοποιούμενο εργαλείο όταν εργάζεστε με το API του Facebook. Σας επιτρέπει να εκτελείτε τις ερωτήσεις API γραφημάτων στη μηχανή αναζήτησης, καθώς και να εξετάζετε τα αποτελέσματα: μπορείτε να χρησιμοποιήσετε ένα από τα μπλοκ πρόσβασης της εφαρμογής σας ή να δημιουργήσετε ένα εν κινήσει με επιλεγμένα πεδία.
Δεξιότητες
Το Graph API είναι ένα API βασισμένο σε REST που σας επιτρέπει να δημιουργείτε, να ενημερώνετε και να διαγράφετε αντικείμενα από κάθε αίτημα HTTP σε ορισμένους κόμβους.
Διακριτικό πρόσβασης
Για να εκτελέσετε ερωτήσεις στο Graph API, χρειάζεστε ένα διακριτικό πρόσβασης που λαμβάνεται μόλις ένας χρήστης εγκρίνει με επιτυχία την αίτησή σας.
Πεδίο εφαρμογής
Τα πεδία προσδιορίζουν ποιες ενέργειες μπορούν να εκτελεστούν για λογαριασμό του χρήστη. Η εφαρμογή ζητά συγκεκριμένα πεδία όταν ένας χρήστης εξουσιοδοτεί σε μια εφαρμογή. Το εύρος publish_actions, για παράδειγμα, επιτρέπει σε μια εφαρμογή να δημοσιεύει αναρτήσεις από έναν χρήστη. Το εύρος email επιτρέπει στην εφαρμογή να διαβάσει το email του χρήστη. Μπορείτε να βρείτε μια πλήρη ανασκόπηση όλων των πεδίων στο η τεκμηρίωση om .
Ορισμένα πεδία όπως το publish_actions ή ads_management απαιτούν έλεγχο από το Facebook πριν από την έναρξη της εφαρμογής.
Παράδειγμα
Για να δείξω πώς λειτουργεί το Graph API, θα σας δείξω πώς να δημιουργήσετε, να ενημερώσετε και να διαγράψετε αναρτήσεις με το API.
Για να λάβετε τις δικές σας αναρτήσεις, μπορείτε να εκτελέσετε την ερώτηση GET /me/posts Το αποτέλεσμα θα είναι μια συμβολοσειρά JSON με μια λίστα αναρτήσεων, συμπεριλαμβανομένου του μηνύματός τους, του create_time και του id. Μπορείτε να χρησιμοποιήσετε την παράμετρο pretty ή α Διαμορφωτής JSON οπότε η απάντηση δεν φαίνεται τόσο βρώμικη.
Για να λάβετε περισσότερα δεδομένα σχετικά με τις αναρτήσεις σας, μπορείτε να επεκτείνετε την ερώτηση με πεδία ως παραμέτρους ερώτησης. Για παράδειγμα, η ερώτηση me/posts?fields=reactions, picture θα σας δώσει τη φωτογραφία και τις αντιδράσεις της ανάρτησης.
οπτικός σχεδιαστής εναντίον γραφίστα
Για να δημιουργήσετε μια ανάρτηση, μπορείτε να στείλετε μια ενέργεια POST στο τροφή άκρων , π.χ. me/feed, με παραμέτρους όπως message: hello world. Το Graph API θα επιστρέψει ένα αντικείμενο JSON με το αναγνωριστικό της ανάρτησης που δημιουργήσατε. Μπορείτε να δείτε την ανάρτηση στη διεύθυνση http://facebook.com/[post_id].
Για να ενημερώσετε μια ανάρτηση, μπορείτε να στείλετε ένα αίτημα POST στον κόμβο ανάρτησης με τα πεδία που πρέπει να ενημερωθούν ως παράμετροι. π.χ. /[post_id] και παραμέτρους όπως Message: lorem ipsum. Θα επιστραφεί ένας επιτυχημένος δείκτης με τιμή true ή false.
Για να διαγράψετε μια ανάρτηση, μπορείτε απλώς να υποβάλετε αίτημα ΔΙΑΓΡΑΦΗ στον κόμβο με το αναγνωριστικό ανάρτησης (π.χ. /[post_id]). Η τιμή επιστροφής θα είναι αντικείμενο JSON με τιμή επιτυχίας true ή false.
Μια πλήρης ανασκόπηση όλων των κόμβων και ενεργειών είναι διαθέσιμη στο Αναφορά γραφήματος API .
API μάρκετινγκ
ο API μάρκετινγκ αξίζει μια ειδική αναφορά, καθώς είναι ένα από τα πιο ισχυρά εργαλεία διαχείρισης διαφημίσεων στο Facebook και αποκτά μια εικόνα από τους εμπιστευτικούς για τη διαφήμιση μέσω της εφαρμογής σας.
Λειτουργεί με τον ίδιο τρόπο όπως και άλλες μέθοδοι Graph API. Ωστόσο, χρειάζεστε το εύρος ads_management για να αποκτήσετε πρόσβαση σε διαφημίσεις χρηστών. Το Facebook πρέπει επίσης να ελέγξει την εφαρμογή σας πριν μπορέσετε να τη δημοσιεύσετε.
Δοκιμή
Μόλις δημιουργήσετε την εφαρμογή σας, βρίσκεται σε λειτουργία ανάπτυξης και γίνεται αυτόματα ορατή στον πίνακα ελέγχου της εφαρμογής σας (π.χ. https://developers.facebook.com/apps/).
Στην κατάσταση ανάπτυξης, μόνο οι διαχειριστές, οι προγραμματιστές και οι υπεύθυνοι δοκιμών έχουν πρόσβαση στην εφαρμογή σας. Μπορείτε να προσθέσετε υπεύθυνους δοκιμών και διαχειριστές και την ενότητα ρόλων του πίνακα ελέγχου της εφαρμογής σας.
Διαδικασία επανεξέτασης
Όταν προστίθενται ορισμένα δικαιώματα, το Facebook πρέπει να ελέγξει την εφαρμογή σας πριν μπορέσετε να τη δημοσιεύσετε. Η διαδικασία αναθεώρησης ορίζεται από αυτό το σύνολο οδηγών .
Για να εισαγάγετε ορισμένα στοιχεία για έλεγχο, απλώς πρέπει να τα προσθέσετε στην ενότητα ελέγχου του πίνακα ελέγχου της εφαρμογής σας. Το Facebook θα σας καθοδηγήσει στη διαδικασία ελέγχου και θα σας ειδοποιήσει μόλις εγκριθεί η εφαρμογή σας.
Περιορισμοί και εναλλακτικές μέθοδοι
Όρια τιμών
Μια εφαρμογή μπορεί να πραγματοποιήσει 200 κλήσεις ανά ώρα για κάθε χρήστη συνολικά. Εάν φτάσετε αυτό το όριο, οι κλήσεις API θα οδηγήσουν σε σφάλμα.
Αναζήτηση αναρτήσεων στο Facebook
Το Facebook περιορίζει την αναζήτηση αναρτήσεων και ετικετών στο Facebook μέσω του Graph API και του FQL. Ωστόσο, μπορείτε να χρησιμοποιήσετε το Αναζήτηση Google API για αναζήτηση δημόσιων αναρτήσεων στο Facebook και, στη συνέχεια, χρησιμοποιήστε το post-id στη διεύθυνση URL για να λάβετε περισσότερες πληροφορίες σχετικά με συγκεκριμένες αναρτήσεις μέσω του Graph API.
Λάβετε εξατομικευμένα δεδομένα κοινού
Δημόσια αντίληψη στο Facebook είναι ένα σημαντικό εργαλείο αναζήτησης για να μάθετε περισσότερα σχετικά με ένα κοινό βάσει ενδιαφερόντων, δημογραφικών στοιχείων ή άλλων χαρακτηριστικών (π.χ. μια συλλογή διευθύνσεων email).
Ωστόσο, δεν βρήκα τρόπο να δημιουργήσω αυτόματα μια αντίληψη κοινού μέσω του API διαφήμισης. Ενημερώστε μας στα σχόλια εάν έχετε οποιεσδήποτε δημιουργικές ιδέες ή προτάσεις για αυτό.
Ίνσταγκραμ
ο API Instagram Κυκλοφόρησε τον Απρίλιο του 2014 και σας επιτρέπει να δημιουργήσετε εφαρμογές που αναλύουν αναρτήσεις χρηστών και τους βοηθούν να διαχειρίζονται τις δικές τους αναρτήσεις.
Εργαλεία
Δεδομένου ότι η κονσόλα API του Instagram καταργήθηκε τη στιγμή της σύνταξης αυτού του άρθρου, σας συνιστώ να το χρησιμοποιήσετε Apigee με σκοπό να το δοκιμάσετε στο πρόγραμμα περιήγησής σας.
Δεξιότητες
Το Instagram API είναι ένα API που βασίζεται σε REST. Όλα του σημεία εξόδου περιγράφονται στην επίσημη τεκμηρίωσή τους.
Διακριτικό πρόσβασης
Για να εκτελέσετε τις ερωτήσεις στο Instagram API, χρειάζεστε ένα διακριτικό πρόσβασης το οποίο λαμβάνεται μόλις ο χρήστης εξουσιοδοτήσει στην αίτησή σας. Προκειμένου ένας χρήστης να λάβει ένα διακριτικό πρόσβασης, πρέπει να κατευθυνθεί στη διεύθυνση URL εξουσιοδότησης της αίτησής σας. Ο διακομιστής θα ανακατευθύνει τον χρήστη αφού εξουσιοδοτήσει την εφαρμογή σας και αργότερα μπορείτε να διαβάσετε το διακριτικό.
Πεδίο εφαρμογής
Η αίτησή σας μπορεί να σας ζητήσει άδειες διαφορετικός Για παράδειγμα, το 'βασικά' σας περιορίζει στην ανάγνωση πληροφοριών προφίλ, καθώς και σε φωτογραφίες και εικόνες ενός χρήστη. Το 'Public_content' σάς επιτρέπει να διαβάσετε οποιοδήποτε δημόσιο προφίλ και υλικό πολυμέσων εκ μέρους ενός χρήστη.
Παραδείγματα
Για να δείξω πώς λειτουργεί το Instagram API, θα δείξω παραδείγματα βάσει του σημείου εξόδου πολυμέσων https://api.instagram.com/v1/media/popular.
Αυτό το σημείο εξόδου επιστρέφει τα τρέχοντα δημοφιλή μέσα Instagram, εάν περάσει ένα μπλοκ πρόσβασης ως παράμετρος. Το αποτέλεσμα θα είναι μια αλυσίδα αναρτήσεων JSON που περιέχουν, για κάθε μία, την αναγνώριση πολυμέσων, έναν σύνδεσμο για την εικόνα του, μου αρέσει , σχόλια, ο χρήστης που το δημοσίευσε και άλλα χαρακτηριστικά.
Μπορείς να χρησιμοποιήσεις apigee για να δοκιμάσετε και να μάθετε περισσότερα σχετικά με τα σημεία εξόδου API και τις παραμέτρους τους.
Δοκιμές
Ξεκινά κάθε νέα εφαρμογή που έχει δημιουργηθεί στην πλατφόρμα Instagram τρόπος κουτί άμμου . Αυτό είναι ένα πλήρως λειτουργικό περιβάλλον που σας επιτρέπει να δοκιμάσετε τα δημόσια διαθέσιμα σημεία εξόδου API, προτού υποβάλετε την αίτησή σας για έλεγχο.
Για να δοκιμάσετε την αίτησή σας, πρέπει απλώς να δημιουργήσετε μια σταδιακή έκδοση και να εκτελέσετε όλες τις ερωτήσεις μέσω αυτής της έκδοσης αντί για τη ζωντανή έκδοση που πέρασε από τον έλεγχο.
Διαδικασία επανεξέτασης
Εφαρμογές σε λειτουργία κουτί άμμου Μπορείτε να χρησιμοποιήσετε οποιοδήποτε σημείο εξόδου API, αλλά αυτά περιορίζονται σε περιορισμένο αριθμό χρηστών και μέσων. Είναι ένας εξαιρετικός μηχανισμός για την ανάπτυξη και τον έλεγχο μιας εφαρμογής.
Για να ξεκινήσετε ζωντανά και να αποκτήσετε πρόσβαση σε όλο το περιεχόμενο του Instagram, θα πρέπει να περάσετε την αίτησή σας μέσω ενός ανασκόπηση . Μόλις ελεγχθεί, μπορείτε να ζητήσετε εύρη μόνο για χρήστες για τους οποίους εγκρίθηκε η αίτησή σας.
Περιορισμοί και εναλλακτικές μέθοδοι
Δημογραφική ανάλυση
Τη στιγμή αυτής της γραφής, δεν υπήρχε τρόπος να λάβετε πληροφορίες σχετικά με την ηλικία, το φύλο ή τα ενδιαφέροντα ενός δημόσιου χρήστη, επειδή το Instagram δεν σας παρέχει αυτές τις πληροφορίες.
Για να λάβετε τα δημογραφικά δεδομένα για τους ακόλουθους ή μια λίστα χρηστών του Instagram, θα πρέπει να επαναλάβετε κάθε έναν από αυτούς και να προσπαθήσετε να προσδιορίσετε την ηλικία και το φύλο τους, με βάση τους οπαδούς τους ή τις πληροφορίες στις βιογραφίες τους.
Μια εξαιρετική λύση δεδομένων σε αυτό το πρόβλημα θα μπορούσε να είναι μια πολύτιμη υπηρεσία για ορισμένες εταιρείες.
Όρια τιμών
Ολα τα όρια τιμών Στην πλατφόρμα Instagram ελέγχονται από ένα μπλοκ πρόσβασης σε συρόμενο παράθυρο 1 ώρας. Οι ζωντανές εφαρμογές έχουν υψηλότερα όρια ρυθμού από τις εφαρμογές λειτουργίας Sandbox . Το συνολικό όριο τιμών για μια ζωντανή εφαρμογή είναι επί του παρόντος 5.000 κλήσεις ανά ώρα.
Κελάδημα
Το Twitter API ήταν απελευθερώθηκε τον Σεπτέμβριο του 2006. Είναι ένα Δημόσιο API REST που παρέχει πρόσβαση ανάγνωσης και γραφής σε δεδομένα Twitter. Ο έλεγχος ταυτότητας γίνεται χρησιμοποιώντας το OAuth. Οι απαντήσεις είναι σε μορφή JSON.
Εργαλεία
Το Twitter έχει Εργαλείο κονσόλας API οδηγείται apigee , το οποίο μπορεί να χρησιμοποιηθεί για τον έλεγχο αιτημάτων στη μηχανή αναζήτησης.
Δεξιότητες
Το REST API σάς επιτρέπει να λαμβάνετε τα tweets, τους ακόλουθους και τα άτομα που ακολουθεί ένας χρήστης. Μπορείτε επίσης να βρείτε τις ετικέτες σε άλλα tweets.
Διακριτικό πρόσβασης
Το Twitter σάς επιτρέπει να δημιουργείτε εφαρμογές που μπορούν οι χρήστες πιστοποιώ την αυθεντικότητα κατά την επιστροφή του διακριτικού πρόσβασης. Το μοντέλο ελέγχου ταυτότητας είναι OAuth.
Πεδίο εφαρμογής
Υπάρχουν μόνο δύο δικαιώματα που πρέπει να οριστούν στη σελίδα ρυθμίσεων της εφαρμογής: Μόνο για ανάγνωση και Ανάγνωση και εγγραφή. Το τελευταίο από αυτά σας επιτρέπει να δημιουργείτε tweets και να εκτελείτε άλλες ενέργειες στις δημοσιεύσεις του χρήστη.
Παραδείγματα
Για να αποδείξω τη χρήση του Twitter API, θα λάβω τα tweet εξουσιοδοτημένα από τον χρήστη. Το αποτέλεσμα είναι μια συμβολοσειρά χαρακτήρων JSON με τις εικόνες, τα αγαπημένα, τα retweets, τα URL, την ημερομηνία δημιουργίας και άλλα χαρακτηριστικά των tweets. Χρήση Apigee για να δοκιμάσετε και να μάθετε περισσότερα σχετικά με τα σημεία εξόδου API και τις παραμέτρους τους.
Διαδικασία δοκιμών και αναθεώρησης
Προς το παρόν δεν υπάρχει διαθέσιμη διαδικασία ελέγχου ή δοκιμαστική λειτουργία για το API του Twitter.
Περιορισμοί και εναλλακτικές μέθοδοι
Δημογραφική ανάλυση
Προς το παρόν δεν υπάρχει εύκολος τρόπος απόκτησης δημογραφικών δεδομένων από τους ακόλουθους Twitter ενός χρήστη. Η προσέγγιση ωμής βίας θα ήταν να επανεξετάσουμε κάθε ακόλουθο και να προσπαθήσουμε να λάβουμε τα δεδομένα μέσω των βιογραφιών τους και των σχετικών λογαριασμών άλλων κοινωνικών δικτύων.
Αργότερα, μπορείτε να κάνετε υποθέσεις με βάση τα δεδομένα που συλλέγονται από τους ακόλουθους μέσω της ανάλυσης δεδομένων. Ένας άλλος τρόπος για να λάβετε περισσότερες πληροφορίες είναι μέσω της πλατφόρμας API του έργου επί πληρωμή που ονομάζεται Twitter GNIP . Μεταξύ άλλων, σας επιτρέπει να δημιουργήσετε ένα κοινό και να λάβετε περισσότερες πληροφορίες σχετικά με αυτά μέσω του API. Το API βρίσκεται σε κατάσταση BETA.
Όρια τιμών
Το Twitter έχει όρια τιμών για κάθε χρήστη και σε 15 λεπτά. Εάν η εφαρμογή σας έχει πολλαπλά διακριτικά, μπορείτε να εναλλάξετε διακριτικά για δημόσιες λειτουργίες, για να αποφύγετε το όριο.
Youtube
Το YouTube Data API κυκλοφόρησε τον Ιανουάριο του 2013. Σας επιτρέπει να προσθέσετε λειτουργίες YouTube στην εφαρμογή σας, να αναζητήσετε περιεχόμενο και να αναλύσετε τα δημογραφικά κανάλια του YouTube. Πρόκειται για ένα OAuth, το REST API που βασίζεται σε διακριτικά, το οποίο επιστρέφει τις απαντήσεις JSON.
Εργαλεία
ο Εξερευνητής API σας επιτρέπει να δοκιμάσετε μη εξουσιοδοτημένα καθώς και εξουσιοδοτημένα αιτήματα. Μπορείτε να εκτελέσετε αιτήματα από το πρόγραμμα περιήγησής σας στα σημεία εξόδου που παρέχονται.
Δεξιότητες
Μεταξύ άλλων, μπορείτε να εργαστείτε με δραστηριότητες, συζητήσεις, ζωντανές μεταδόσεις, κανάλια, βίντεο και συνδρομές. Τα περισσότερα σημεία εξόδου απαιτούν να εξουσιοδοτήσετε με λογαριασμό YouTube.
Διακριτικό πρόσβασης
Το YouTube Data API υποστηρίζει το πρωτόκολλο OAuth 2.0 για εξουσιοδότηση πρόσβασης στα προσωπικά δεδομένα χρήστη. Μόλις εξουσιοδοτηθεί ένας χρήστης στην αίτησή σας, θα ανακατευθυνθεί στην εφαρμογή σας όπου θα πρέπει να αποθηκευτεί το διακριτικό πρόσβασης.
Για να χρησιμοποιήσετε την εξουσιοδότηση OAuth 2.0, πρέπει πρώτα να λάβετε διαπιστευτήρια εξουσιοδότησης από την κονσόλα προγραμματιστή Google.
Πεδίο εφαρμογής
Το YouTube Data API λειτουργεί προς το παρόν με τα ακόλουθα πεδία:
- Δύναμη SSL - Διαχειριστείτε τον λογαριασμό σας στο YouTube, αλλά μόνο με σύνδεση SSL.
- Προκαθορισμένο - Διαχειριστείτε τον λογαριασμό σας στο YouTube. Αυτό το εύρος είναι λειτουργικά πανομοιότυπο με το εύρος youtube.force-ssl αλλά δεν απαιτεί σύνδεση SSL.
- Μόνο για ανάγνωση - Κοιτάξτε τον λογαριασμό σας στο YouTube.
- Ανεβαίνω - Ανεβάστε βίντεο στο YouTube και διαχειριστείτε τα βίντεό σας στο YouTube.
- Ελέγξτε ένα κανάλι φίλων - Καταργεί τις πληροφορίες που χρησιμοποιούνται από τα δίκτυα Multichannel ως κριτήριο αποδοχής ή απόρριψης ενός καναλιού στο δίκτυό τους.
Παραδείγματα
Ως παράδειγμα χρήσης του API δεδομένων YouTube, εμφανίζω τις ακόλουθες ερωτήσεις για βίντεο με 'κωδικοποίηση' στον τίτλο και την περιγραφή τους:
https://www.googleapis.com/youtube/v3/search?part=snippet&q=coding&key={YOUR_API_KEY} Το αποτέλεσμα είναι ένα αντικείμενο JSON που περιέχει τον τίτλο, την περιγραφή, το βίντεο και το κανάλι. Μπορείτε να χρησιμοποιήσετε το τελευταίο από αυτά για να μάθετε περισσότερα σχετικά με το κανάλι.
Η παράμετρος part απαιτείται για οποιοδήποτε αίτημα API που επιστρέφεται από κάποια πηγή. Η παράμετρος προσδιορίζει τις ιδιότητες πόρου που πρέπει να περιλαμβάνονται σε μια απόκριση API. Για παράδειγμα, μια ροή βίντεο έχει τα ακόλουθα μέρη: snippet, contentDetails, fileDetails, player, processingDetails, recordingDetails, στατιστικά στοιχεία, κατάσταση, προτάσεις, topicDetails.
Οι υπόλοιπες παράμετροι, εκτός από το κλειδί API, διαφέρουν ανάλογα με την κλήση. Διαβάστε περισσότερα για αυτό στο Οδηγός αναφοράς API .
ο API Pinterest Αρχικά κυκλοφόρησε τον Απρίλιο του 2015. Πρόκειται για ένα RESTful API, το οποίο παρέχει πρόσβαση στα δεδομένα του χρήστη Pinterest, όπως οι πίνακες, οι ακόλουθοι και άλλα. Το Pinterest API χρησιμοποιεί OAuth και επιτρέπει δικαιώματα ανάγνωσης και εγγραφής όταν αλληλεπιδρά με περιεχόμενο χρήστη.
Εργαλεία
Όπως και οι άλλοι, το Pinterest παρέχει μια Εξερεύνηση API για να ελέγξει τα σημεία εξόδου σας και να υποβάλει ερωτήσεις σε αυτά. Μπορείτε να δείτε τα εργαλεία τους εδώ .
Δεξιότητες
ο ΑΠΟΔΟΣΗ API Το Pinterest σάς επιτρέπει να δημιουργείτε καρφίτσες, πίνακες και να κάνετε ερωτήσεις σχετικά με δεδομένα Pinterest με το OAuth.
Διακριτικό πρόσβασης
Το Pinterest χρησιμοποιεί το OAuth 2.0 για τον έλεγχο ταυτότητας αιτημάτων μεταξύ της εφαρμογής σας και των χρηστών σας. Όλα τα αιτήματα πρέπει να υποβάλλονται μέσω HTTPS.
Πεδίο εφαρμογής
Τα πεδία καθορίζουν τι μπορεί να κάνει μια ανάρτηση για έναν χρήστη. Το Pinterest χρησιμοποιεί τα ακόλουθα πεδία:
none(πρέπει να γνωρίζετε το αναγνωριστικό) Χρησιμοποιήστε τη μέθοδο GET στο προφίλ του χρήστη, στις λεπτομέρειες της πλακέτας και στην καρφίτσα και στην καρφίτσα στον πίνακα.read_public: Χρησιμοποιήστε τη μέθοδο GET στο Pin, board και του χρήστη μου αρέσει .write_public: Χρησιμοποιήστε μεθόδους PATCH, POST και DELETE σε καρφίτσες και πίνακες χρήστη.read_relationships: Χρησιμοποιήστε τη μέθοδο GET στους ακόλουθους και ποιος ακολουθεί ο χρήστης (σε πίνακες, χρήστες και ενδιαφέροντα).write_relationships: Χρησιμοποιήστε τις μεθόδους PATCH, POST και DELETE σε ακόλουθους και ποιος ακολουθεί ο χρήστης (σε πίνακες, χρήστες και ενδιαφέροντα).
Παραδείγματα
Για να δείξω τη χρήση του API Pinterest, θα δείξω πώς να διαβάσω τις τελευταίες καρφίτσες του χρήστη:
https://api.pinterest.com/v1/me/pins/?access_token={your_token}&fields=id,link,note,url,counts,board,created_at θα επιστρέψει τις καρφίτσες του χρήστη με την ταυτότητά τους, τον σύνδεσμο, τη σημείωση, τη διεύθυνση URL, μου αρέσει και επαναλαμβάνει.
Διαδικασία δοκιμών και αναθεώρησης
Οι αιτήσεις αρχικά βρίσκονται σε κατάσταση ανάπτυξης και πρέπει να υποβληθούν για έλεγχο πριν κυκλοφορήσουν σε κατάσταση παραγωγής.
Περιορισμοί και εναλλακτικές μέθοδοι
Δημογραφική ανάλυση
Δεν υπάρχει κοινός τρόπος απόκτησης δημογραφικών δεδομένων από έναν πίνακα ελέγχου. Ωστόσο, μπορείτε να προσπαθήσετε να λάβετε τους οπαδούς και τις πληροφορίες τους από το βιογραφικό στο ταμπλό, καθώς και συνδέσμους προς άλλους λογαριασμούς κοινωνικών μέσων. Μια εξαιρετική λύση δεδομένων για κοινές συνδέσεις χρηστών είναι επίσης μια πιθανότητα.
Αναζήτηση καρφιτσών
Προς το παρόν, δεν υπάρχει τρόπος αναζήτησης καρφιτσών με συγκεκριμένες ετικέτες ή λέξεις-κλειδιά μέσω του API. Μπορείτε να παρακάμψετε αυτόν τον περιορισμό χρησιμοποιώντας το API προσαρμοσμένης αναζήτησης Google για αναζήτηση αποτελεσμάτων μόνο σε καρφίτσες Pinterest και συλλογή του αναγνωριστικού PIN μέσω διεύθυνσης URL. Η αναγνώριση μπορεί αργότερα να χρησιμοποιηθεί για τη λήψη πληροφοριών σχετικά με την καρφίτσα μέσω του API.
Όρια τιμών
Σε κάθε εφαρμογή (με μοναδικό αναγνωριστικό εφαρμογής) επιτρέπονται 1.000 κλήσεις ανά σημείο εξόδου ανά ώρα για κάθε μοναδικό διακριτικό χρήστη.
Κάθε απόκριση API επιστρέφει μια κεφαλίδα που σας δίνει μια ενημέρωση σχετικά με τα όρια τιμών. X-Ratelimit-Limit είναι το όριο τιμής για αυτό το συγκεκριμένο αίτημα και X-Ratelimit-Υπόλοιπο είναι ο αριθμός των αιτημάτων που έχετε αφήσει σε ένα παράθυρο 60 λεπτών.
Εάν υπερβείτε το όριο τιμής για το δεδομένο σημείο εξόδου, θα λάβετε έναν κωδικό σφάλματος 429 'Πάρα πολλά αιτήματα' .
Σύγκριση API κοινωνικών μέσων
| Εκδοχή | OAuth | Μορφή | δημογραφικά στοιχεία | |
|---|---|---|---|---|
| v2.6 Αρχική κυκλοφορία: Απρίλιος 2010 | OAuth 2 | Αιτήματα REST με απαντήσεις JSON | Υποστηρίζεται | |
| Ίνσταγκραμ | v1 Αρχική κυκλοφορία: Απρίλιος 2014 | OAuth 2 | Αιτήματα REST με απαντήσεις JSON | Δεν υποστηρίζεται |
| Κελάδημα | v1.1 Αρχική κυκλοφορία: Σεπτέμβριος 2006 | OAuth 1 | Αιτήματα REST με απαντήσεις JSON | Υποστηρίζεται μόνο με GNIP |
| Youtube | v3 Αρχική κυκλοφορία: Ιανουάριος 2013 | OAuth 2 | Αιτήματα REST με απαντήσεις JSON | Υποστηρίζεται |
| v1 Αρχική κυκλοφορία: Απρίλιος 2015 | OAuth 2 | Αιτήματα REST με απαντήσεις JSON | Δεν υποστηρίζεται |
Επίδειξη εφαρμογής Ρητό
Με την ενσωμάτωση αυτών των API στις νέες ή τις υπάρχουσες εφαρμογές σας, χάρη στο πλήθος των πακέτων και των βιβλιοθηκών API κοινωνικών μέσων, αυτή η διαδικασία είναι ευκολότερη από ποτέ. Οι περισσότερες πλατφόρμες και πλαίσια έχουν αποδείξει βιβλιοθήκες τρίτων μερών που ενοποιούν ακόμη και την πτυχή ελέγχου ταυτότητας όλων αυτών των API σε μία βιβλιοθήκη με μια τακτοποιημένη αρχιτεκτονική προσθηκών.
Για αυτό το άρθρο, θα ρίξουμε μια ματιά στο πώς Ρητό , ένα στολίδι της Ruby, το κάνει πολύ κομψά για εφαρμογές Rails. Ρητό είναι μια ευέλικτη βιβλιοθήκη ελέγχου ταυτότητας με βάση Φύλακας που υλοποιεί, έλεγχο ταυτότητας, εγγραφή, πρόσβαση και αποθήκευση δεδομένων για παροχή πολλαπλής πρόσβασης. Εάν είστε ένα πιο διασκεδαστικό πρόσωπο και θέλετε να δείτε κάτι παρόμοιο με το AngularJS, ρίξτε μια ματιά αυτό το άρθρο .
Ρητό Όπως πολλές βιβλιοθήκες αυτού του τύπου, δεν έχουν ήδη δημιουργηθεί με υποστήριξη για κανένα από τα API κοινωνικών μέσων. Η υποστήριξη για καθένα από αυτά τα API κοινωνικών μέσων παρέχεται μέσω πρόσθετων πολύτιμων λίθων. Τα ακόλουθα πετράδια είναι διαθέσιμα για έλεγχο ταυτότητας Rails, καλύπτοντας τους πέντε παρόχους που συζητούνται σε αυτό το άρθρο:
gem 'omniauth-facebook' gem 'omniauth-pinterest' gem 'omniauth-twitter' gem 'omniauth-google-oauth2' gem 'omniauth-instagram' Ένα από τα καλύτερα πράγματα για το Rails είναι ότι υπάρχουν πολλά πρόσθετα γραμμένα από την κοινότητα ανοιχτού κώδικα. Αυτά διανέμονται σαν πολύτιμοι λίθοι. Παρατίθενται σε ένα κεντρικό αρχείο διαμόρφωσης, αυτά τα πολύτιμα διαχειρίζονται ο Bundler.Δεδομένου ότι αυτά παρέχουν μόνο έλεγχο ταυτότητας, εγγραφή, πρόσβαση και αποθήκευση για καθέναν από αυτούς τους παρόχους, θα χρειαστεί επίσης να αποκτήσουμε τους ακόλουθους πολύτιμους λίθους για τους πελάτες API:
gem 'twitter' # https://github.com/sferik/twitter gem 'instagram' # https://github.com/facebookarchive/instagram-ruby-gem gem 'koala' # (Facebook API) https://github.com/arsduo/koala gem 'google-api-client' # (YouTube API), https://github.com/google/google-api-ruby-client gem 'pinterest-api' # https://github.com/realadeel/pinterest-api Omniauth και έλεγχος ταυτότητας
Για να μπορεί ένας χρήστης να εξουσιοδοτήσει την αίτησή σας με τον παροχέα σας, μπορείτε να παρέχετε έναν σύνδεσμο με την ακόλουθη διαδρομή:
omniauth_authorize_path('user', :facebook) omniauth_authorize_path('user', :instagram) ... Για να μπορέσετε να αντιδράσετε στην κλήση μετά τον έλεγχο ταυτότητας ενός χρήστη, μπορείτε να ορίσετε ένα OmniauthCallbacksController με εύρος ως λειτουργίες όπως αυτή:
class AuthenticationsController Αυτό είναι το μέρος για να προσθέσετε ένα νέο μοντέλο ελέγχου ταυτότητας με το διακριτικό και τα δεδομένα στην εφαρμογή σας:
authentication = where(provider: omniauth.provider, user_id: user.id) .first_or_create do |auth| auth.user = user auth.uid = omniauth.uid auth.secret = omniauth.credentials.secret auth.token = omniauth.credentials.token ... end Πραγματοποίηση κλήσεων API
Εδώ είναι ένα παράδειγμα του τρόπου χρήσης Δενδρόβιο ζώο της αυστραλίας για να κάνετε ερωτήσεις στο API του Facebook. Οι υπόλοιποι πάροχοι λειτουργούν λίγο πολύ με παρόμοιο τρόπο και τεκμηριώνονται στο README του στολιδιού.
Έτσι λαμβάνετε τα δεδομένα χρήστη σας χρησιμοποιώντας το Koala:
authentication = user.authentication_for_provider(:facebook) token = authentication.token api = Koala::Facebook::API.new(token) results = api.get_object('me') Στη συνέχεια, μπορείτε να χρησιμοποιήσετε το αποτέλεσμα επιστροφής JSON που δημιουργήθηκε από το API. Ο πηγαίος κώδικας για αυτήν την επίδειξη εφαρμογής είναι διαθέσιμο στο GitHub .
Να τελειωσει
Τα API κοινωνικών μέσων σάς παρέχουν ένα ισχυρό εργαλείο για να κάνετε ερωτήσεις σχετικά με το σύνολο δεδομένων μεγάλης κλίμακας των κοινωνικών μέσων, καθώς και να συλλέγετε μεγάλα δεδομένα για την εφαρμογή σας. Μπορείτε να δημιουργήσετε μια υπηρεσία πάνω από αυτά τα API ή να τα χρησιμοποιήσετε για να αυξήσετε τη δική σας εφαρμογή ή πληροφορίες χρήστη.
Οι ράγες και οι διαθέσιμοι πολύτιμοι λίθοι διευκολύνουν την ενσωμάτωση αυτών των API στην εφαρμογή σιδηροτροχιών και την αναζήτηση των διεπαφών με ένα επίπεδο αφαίρεσης μεταξύ της εφαρμογής σας και του API.
