Etichetarea persoanelor și adăugarea unei locații la o postare prin API-ul Instagram
API-ul Instagram etichetează persoane cu user_tags și adaugă o locație cu location_id, ambele setate pe containerul media înainte de publicare. user_tags primește nume de utilizator publice, iar pe imagini sunt necesare coordonatele x și y, între 0.0 și 1.0. Meta o descrie pentru imagini, videoclipuri și Story-uri. location_id primește ID-ul unei pagini cu date de locație, găsit prin Pages Search API.
easyCoexistence publică fotografii, carusele, Reels și Story-uri cu publish_instagram_post din Claude, ChatGPT sau din propriul cod.
Intervalul coordonatelor x și y din user_tags, măsurat de la marginea stângă și de sus a imaginii.
Unde user_tags cere x și y; sunt opționale la Story-uri, iar etichetele se aplică doar imaginilor și Story-urilor.
location_id nu este acceptat pentru imaginile sau videoclipurile dintr-un carusel, conform referinței media Meta.
Valoarea config_issue când media se publică fără etichetele de utilizator, pe care Meta o numește succes parțial.
Când Meta a deschis etichetarea locațiilor și a conturilor Instagram publice în fotografiile publicate prin API, mai întâi partenerilor beta.
Cum etichetați persoane într-o postare?
Adăugați user_tags la container. Este un array de obiecte, fiecare cu numele de utilizator al unui cont Instagram public și, pentru o imagine, x și y: valori float de la 0.0 la 1.0, care indică distanța etichetei față de marginea stângă și cea de sus. O locație merge în location_id în același apel, iar containerul se publică apoi cu media_publish, ca de obicei.
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>"
}Ce postări primesc etichete de utilizator și o locație?
Referința media a Meta descrie user_tags pentru imagini, videoclipuri și Story-uri, cu x și y aplicabile doar imaginilor și Story-urilor, și enumeră parametrii pe care îi primește fiecare container. Pe un carusel, locația merge pe containerul de carusel, deoarece location_id nu este acceptat pentru imaginile sau videoclipurile din interior:
Cum găsiți un location_id?
Căutați o pagină. location_id este ID-ul unei pagini asociate cu o locație, iar referința Meta indică Pages Search API, GET /pages/search cu q și fields=id,name,location, apoi verificarea că pagina aleasă are date de locație. O pagină fără ele eșuează cu INSTAGRAM_PLATFORM_API__INVALID_LOCATION_ID. Căutarea rulează pe Graph API al Meta, cu token-ul propriei aplicații Meta: un token de utilizator sau, pentru informații publice despre pagină, un token de aplicație cu funcția Page Public Metadata Access.
GET /pages/search
?q=<PLACE_NAME>
&fields=id,name,location
&access_token=<ACCESS_TOKEN>Ce se întâmplă dacă o etichetă nu se atașează?
Postarea poate fi tot publicată. media_publish returnează atunci config_issue setat la USER_TAGGING_FAILURE, adică media a fost publicată fără etichetele de utilizator. Meta numește aceasta succes parțial și cere aplicațiilor să o trateze ca semnal de reconciliere, nu ca eroare, deoarece ID-ul media este valid; o nouă publicare ar crea o a doua postare.
Funcționează etichetele de utilizator cu Instagram Login?
Referința media a Meta listează user_tags și location_id pentru crearea containerului, fără a le lega de un singur login. Pagina sa pentru API-ul Instagram cu Instagram Login, însă, spune că această configurare nu poate accesa reclame sau etichetare, fără a preciza ce fel de etichetare înseamnă. Înainte de a construi pe oricare parametru cu Instagram Login, publicați o postare de test și verificați răspunsul și postarea în sine.
Cum etichetați persoane prin easyCoexistence?
Încă nu se poate. publish_instagram_post creează singur containerul și nu primește user_tags sau location_id, iar token-urile Instagram nu se oferă pentru un apel propriu. Publicați postarea cu publish_instagram_post, apoi adăugați etichetele și locația în aplicația Instagram, din opțiunea Edit a postării.
Greșeli frecvente
- Omiterea lui x și y la o etichetă pe imagine. Meta le cere pentru imagini; doar Story-urile le fac opționale.
- Oferirea coordonatelor în pixeli sau procente. x și y sunt float-uri de la 0.0 la 1.0, măsurate de la marginea stângă și de sus.
- Setarea lui location_id pe elementele unui carusel. Meta nu o acceptă pentru imaginile sau videoclipurile dintr-un carusel.
- Etichetarea unui cont privat. user_tags acceptă doar numele de utilizator ale conturilor Instagram publice.
Instrumentul nu primește user_tags sau location_id, așa că persoanele și locurile se etichetează în aplicația Instagram, din opțiunea Edit a postării. De la US$ 9 la US$ 0.75 pe conexiune pe lună, care scade pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.
Întrebări frecvente
Pot eticheta un cont Instagram privat prin API?
Nu. Referința media a Meta spune că user_tags acceptă numele de utilizator ale conturilor Instagram publice, deci un cont privat nu poate fi etichetat astfel.
Câte persoane pot fi etichetate într-o postare?
Referința Meta pentru user_tags nu indică un maxim. Limita de 20 pe care o menționează este pentru etichetele @ dintr-o legendă.
Pot adăuga o locație la un Story prin API?
Nu. Sintaxa Meta pentru containerul de Story listează user_tags, dar nu location_id.
Pot eticheta un produs în loc de o persoană?
Etichetele de produs sunt o funcție separată, pe care prezentarea generală a Meta o listează ca acceptată cu Facebook Login și Unified Login, nu cu Instagram Login.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la