Επισήμανση ατόμων και προσθήκη τοποθεσίας σε ανάρτηση Instagram μέσω του API
Το API του Instagram επισημαίνει άτομα με user_tags και προσθέτει τοποθεσία με location_id. Και τα δύο ορίζονται στο container πριν δημοσιευτεί. Το user_tags δέχεται δημόσια ονόματα χρηστών, με συντεταγμένες x και y από 0.0 έως 1.0 που απαιτούνται στις εικόνες. Η Meta το περιγράφει για εικόνες, βίντεο και Stories. Το location_id δέχεται το ID μιας σελίδας με δεδομένα τοποθεσίας, που βρίσκεται μέσω του Pages Search API.
Το easyCoexistence δημοσιεύει φωτογραφίες, carousel, Reels και Stories με το publish_instagram_post, από το Claude, το ChatGPT ή τον δικό σας κώδικα.
Εύρος των συντεταγμένων x και y στο user_tags, μετρημένο από το αριστερό και το πάνω άκρο της εικόνας.
Πού το user_tags απαιτεί x και y· είναι προαιρετικά στα Stories, και ισχύουν μόνο για εικόνες και Stories.
Το location_id δεν υποστηρίζεται στις εικόνες ή τα βίντεο μέσα σε carousel, σύμφωνα με την αναφορά πολυμέσων της Meta.
Η τιμή config_issue όταν τα πολυμέσα δημοσιεύονται χωρίς τις επισημάνσεις τους, την οποία η Meta ονομάζει μερική επιτυχία.
Πότε άνοιξε η Meta την επισήμανση τοποθεσιών και δημόσιων λογαριασμών Instagram σε φωτογραφίες που δημοσιεύονται μέσω API, αρχικά μόνο για συνεργάτες beta.
Πώς επισημαίνονται άτομα σε μια ανάρτηση;
Προσθέστε το user_tags στο container. Είναι ένας πίνακας αντικειμένων, καθένα με το όνομα χρήστη ενός δημόσιου λογαριασμού Instagram και, σε εικόνα, τα x και y: δεκαδικοί αριθμοί από 0.0 έως 1.0 που δίνουν την απόσταση της ετικέτας από το αριστερό και το πάνω άκρο. Η τοποθεσία μπαίνει στο location_id στην ίδια κλήση, και το container δημοσιεύεται στη συνέχεια με media_publish, όπως συνήθως.
POST /<IG_ID>/media
Content-Type: application/json
{
"image_url": "https://example.com/team.jpg",
"caption": "<CAPTION>",
"user_tags": [
{ "username": "<USERNAME>", "x": 0.42, "y": 0.61 }
],
"location_id": "<PAGE_ID>"
}Ποιες αναρτήσεις δέχονται επισημάνσεις χρηστών και τοποθεσία;
Η αναφορά πολυμέσων της Meta περιγράφει το user_tags για εικόνες, βίντεο και Stories, με τα x και y να ισχύουν μόνο για εικόνες και Stories, και απαριθμεί τις παραμέτρους που δέχεται κάθε container. Σε carousel, η τοποθεσία μπαίνει στο container του carousel, επειδή το location_id δεν υποστηρίζεται στις εικόνες ή τα βίντεο που περιέχει:
Πώς βρίσκεται ένα location_id;
Αναζητήστε μια σελίδα. Το location_id είναι το ID μιας σελίδας που συνδέεται με τοποθεσία. Η αναφορά της Meta οδηγεί στο Pages Search API, GET /pages/search με q και fields=id,name,location, και μετά στον έλεγχο ότι η επιλεγμένη σελίδα έχει δεδομένα τοποθεσίας. Σελίδα χωρίς αυτά αποτυγχάνει με INSTAGRAM_PLATFORM_API__INVALID_LOCATION_ID. Η αναζήτηση εκτελείται στο Graph API της Meta με το token της δικής σας εφαρμογής Meta: token χρήστη ή, για δημόσιες πληροφορίες σελίδας, token εφαρμογής με τη λειτουργία Page Public Metadata Access.
GET /pages/search
?q=<PLACE_NAME>
&fields=id,name,location
&access_token=<ACCESS_TOKEN>Τι συμβαίνει αν μια επισήμανση δεν προσαρτηθεί;
Η ανάρτηση μπορεί παρ' όλα αυτά να δημοσιευτεί. Το media_publish επιστρέφει τότε το config_issue με τιμή USER_TAGGING_FAILURE, που σημαίνει ότι τα πολυμέσα δημοσιεύτηκαν χωρίς τις επισημάνσεις χρηστών. Η Meta το ονομάζει μερική επιτυχία και ζητά από τις εφαρμογές να το αντιμετωπίζουν ως σήμα για επανασυμφιλίωση και όχι ως σφάλμα, αφού το media ID είναι έγκυρο. Μια νέα δημοσίευση θα δημιουργούσε δεύτερη ανάρτηση.
Λειτουργούν οι επισημάνσεις χρηστών με το Instagram Login;
Η αναφορά πολυμέσων της Meta αναφέρει το user_tags και το location_id για τη δημιουργία container, χωρίς να τα περιορίζει σε μία μέθοδο σύνδεσης. Η σελίδα της για το Instagram API με Instagram Login, ωστόσο, λέει ότι αυτή η ρύθμιση δεν μπορεί να έχει πρόσβαση σε διαφημίσεις ή επισημάνσεις, χωρίς να προσδιορίζει ποια επισήμανση εννοεί. Πριν βασιστείτε σε οποιαδήποτε από τις δύο παραμέτρους με Instagram Login, δημοσιεύστε μια δοκιμαστική ανάρτηση και ελέγξτε την απόκριση και την ίδια την ανάρτηση.
Πώς επισημαίνετε άτομα μέσω του easyCoexistence;
Δεν γίνεται ακόμη. Το publish_instagram_post δημιουργεί το ίδιο το container και δεν δέχεται user_tags ή location_id, και τα tokens του Instagram δεν δίνονται για δική σας κλήση. Δημοσιεύστε την ανάρτηση με το publish_instagram_post και μετά προσθέστε τις επισημάνσεις και την τοποθεσία στην εφαρμογή Instagram, από την επιλογή Edit της ανάρτησης.
Συνηθισμένα λάθη
- Να μην βάζετε x και y σε επισήμανση εικόνας. Η Meta τα απαιτεί στις εικόνες· μόνο τα Stories τα κάνουν προαιρετικά.
- Δίνετε συντεταγμένες σε pixel ή σε ποσοστό. Τα x και y είναι δεκαδικοί αριθμοί από 0.0 έως 1.0, μετρημένοι από το αριστερό και το πάνω άκρο.
- Ορίζετε location_id σε στοιχεία carousel. Η Meta δεν το υποστηρίζει στις εικόνες ή τα βίντεο μέσα σε carousel.
- Επισημαίνετε ιδιωτικό λογαριασμό. Το user_tags δέχεται μόνο ονόματα χρηστών δημόσιων λογαριασμών Instagram.
Το εργαλείο δεν δέχεται user_tags ή location_id, γι' αυτό τα άτομα και τα μέρη επισημαίνονται στην εφαρμογή Instagram, από την επιλογή Edit της ανάρτησης. Από US$ 9 έως US$ 0.75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και με τις πρώτες 3 ημέρες ως δωρεάν δοκιμή.
Συχνές ερωτήσεις
Μπορώ να επισημάνω ιδιωτικό λογαριασμό Instagram μέσω του API;
Όχι. Η αναφορά πολυμέσων της Meta αναφέρει ότι το user_tags δέχεται ονόματα χρηστών δημόσιων λογαριασμών Instagram, οπότε ιδιωτικός λογαριασμός δεν μπορεί να επισημανθεί με αυτόν τον τρόπο.
Πόσα άτομα μπορούν να επισημανθούν σε μία ανάρτηση;
Η αναφορά της Meta για το user_tags δεν δίνει μέγιστο αριθμό. Το όριο 20 που αναφέρει αφορά τις @ επισημάνσεις σε λεζάντα.
Μπορώ να προσθέσω τοποθεσία σε Story μέσω του API;
Όχι. Η σύνταξη της Meta για το container Story αναφέρει το user_tags, αλλά όχι το location_id.
Μπορώ να επισημάνω ένα προϊόν αντί για άτομο;
Οι επισημάνσεις προϊόντων είναι ξεχωριστή λειτουργία, την οποία η επισκόπηση της Meta αναφέρει ως υποστηριζόμενη με Facebook Login και Unified Login, όχι με Instagram Login.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις