Oznaczanie osób i dodawanie lokalizacji do posta Instagrama przez API
API Instagrama oznacza osoby parametrem user_tags i dodaje miejsce parametrem location_id; oba ustawia się w kontenerze multimediów przed publikacją. user_tags przyjmuje publiczne nazwy użytkowników, a na zdjęciach wymagane są współrzędne x i y od 0.0 do 1.0; Meta opisuje to dla zdjęć, filmów i Relacji. location_id przyjmuje ID Strony z danymi lokalizacji, znalezione przez Pages Search API.
easyCoexistence publikuje zdjęcia, karuzele, Reels i Relacje za pomocą publish_instagram_post z poziomu Claude, ChatGPT lub Twojego własnego kodu.
Zakres współrzędnych x i y w user_tags, mierzony od lewej i górnej krawędzi zdjęcia.
Miejsce, w którym user_tags wymaga x i y; są opcjonalne w Relacjach, a parametry dotyczą tylko zdjęć i Relacji.
location_id nie jest obsługiwane na zdjęciach ani filmach wewnątrz karuzeli, według dokumentacji multimediów Meta.
Wartość config_issue, gdy multimedia zostaną opublikowane bez oznaczeń użytkowników; Meta nazywa to częściowym sukcesem.
Kiedy Meta otworzyła oznaczanie lokalizacji i publicznych kont Instagrama w zdjęciach publikowanych przez API, najpierw dla partnerów beta.
Jak oznaczać osoby w poście?
Dodaj user_tags do kontenera. To tablica obiektów, każdy z nazwą użytkownika publicznego konta Instagrama oraz, dla zdjęcia, x i y: liczby zmiennoprzecinkowe od 0.0 do 1.0 określające odległość oznaczenia od lewej i górnej krawędzi. Lokalizacja trafia do location_id w tym samym wywołaniu, a kontener jest następnie publikowany przez media_publish jak zwykle.
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>"
}Które posty przyjmują oznaczenia użytkowników i lokalizację?
Dokumentacja multimediów Meta opisuje user_tags dla zdjęć, filmów i Relacji; x i y dotyczą tylko zdjęć i Relacji. Podaje też parametry, jakie przyjmuje każdy kontener. W karuzeli lokalizacja trafia do kontenera karuzeli, ponieważ location_id nie jest obsługiwane na zdjęciach ani filmach wewnątrz niej:
Jak znaleźć location_id?
Wyszukaj Stronę. location_id to ID Strony powiązanej z lokalizacją. Dokumentacja Meta wskazuje Pages Search API, czyli GET /pages/search z q i fields=id,name,location, a następnie sprawdzenie, czy wybrana Strona ma dane lokalizacji. Strona bez nich kończy się błędem INSTAGRAM_PLATFORM_API__INVALID_LOCATION_ID. Wyszukiwanie działa w Graph API Meta z tokenem Twojej własnej aplikacji Meta: tokenem użytkownika lub, dla publicznych informacji o Stronie, tokenem aplikacji z funkcją Page Public Metadata Access.
GET /pages/search
?q=<PLACE_NAME>
&fields=id,name,location
&access_token=<ACCESS_TOKEN>Co się stanie, gdy oznaczenie nie zostanie dodane?
Post może mimo to zostać opublikowany. media_publish zwraca wtedy config_issue z wartością USER_TAGGING_FAILURE, co oznacza, że multimedia opublikowano bez oznaczeń użytkowników. Meta nazywa to częściowym sukcesem i prosi aplikacje, by traktowały to jako sygnał do uzgodnienia, a nie jako błąd, ponieważ ID multimediów jest prawidłowe; ponowna publikacja utworzyłaby drugi post.
Czy oznaczenia użytkowników działają z Instagram Login?
Dokumentacja multimediów Meta wymienia user_tags i location_id przy tworzeniu kontenera, nie wiążąc ich z jednym logowaniem. Jej strona o Instagram API z Instagram Login mówi jednak, że taka konfiguracja nie ma dostępu do reklam ani oznaczeń, nie precyzując, jakich oznaczeń dotyczy. Zanim oprzesz się na którymkolwiek z tych parametrów przy Instagram Login, opublikuj testowy post i sprawdź odpowiedź oraz sam post.
Jak oznaczać osoby przez easyCoexistence?
Jeszcze nie można. publish_instagram_post sam tworzy kontener i nie przyjmuje user_tags ani location_id, a tokeny Instagrama nie są wydawane do własnego wywołania. Opublikuj post przez publish_instagram_post, a następnie dodaj oznaczenia i lokalizację w aplikacji Instagram, z opcji Edytuj przy poście.
Typowe błędy
- Pominięcie x i y przy oznaczeniu zdjęcia. Meta wymaga ich na zdjęciach; tylko Relacje czynią je opcjonalnymi.
- Podawanie współrzędnych w pikselach lub procentach. x i y to liczby zmiennoprzecinkowe od 0.0 do 1.0, mierzone od lewej i górnej krawędzi.
- Ustawianie location_id na elementach karuzeli. Meta nie obsługuje tego na zdjęciach ani filmach wewnątrz karuzeli.
- Oznaczanie konta prywatnego. user_tags przyjmuje nazwy użytkowników publicznych kont Instagrama.
Narzędzie nie przyjmuje user_tags ani location_id, więc osoby i miejsca oznacza się w aplikacji Instagram, z opcji Edytuj przy poście. Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem kolejnych połączeń, z bezpłatnym okresem próbnym na pierwsze 3 dni.
Najczęściej zadawane pytania
Czy mogę oznaczyć prywatne konto Instagrama przez API?
Nie. Dokumentacja multimediów Meta mówi, że user_tags przyjmuje nazwy użytkowników publicznych kont Instagrama, więc prywatnego konta nie da się w ten sposób oznaczyć.
Ilu osób mogę oznaczyć w jednym poście?
Dokumentacja Meta dla user_tags nie podaje maksimum. Limit 20, który wymienia, dotyczy oznaczeń @ w podpisie.
Czy mogę dodać lokalizację do Relacji przez API?
Nie. Składnia Meta dla kontenera Relacji wymienia user_tags, ale nie location_id.
Czy mogę oznaczyć produkt zamiast osoby?
Oznaczenia produktów to osobna funkcja, którą przegląd Meta wymienia jako obsługiwaną przy Facebook Login i Unified Login, a nie przy Instagram Login.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w