Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

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.

0.0 to 1.0

Zakres współrzędnych x i y w user_tags, mierzony od lewej i górnej krawędzi zdjęcia.

Images

Miejsce, w którym user_tags wymaga x i y; są opcjonalne w Relacjach, a parametry dotyczą tylko zdjęć i Relacji.

Carousels

location_id nie jest obsługiwane na zdjęciach ani filmach wewnątrz karuzeli, według dokumentacji multimediów Meta.

USER_TAGGING_FAILURE

Wartość config_issue, gdy multimedia zostaną opublikowane bez oznaczeń użytkowników; Meta nazywa to częściowym sukcesem.

13 Mar 2018

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.

An image container with a user tag and a location
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:

Imageuser_tags with x and y, and location_id
Reeluser_tags by username, and location_id
Storyuser_tags, with x and y optional; no location_id in its syntax
Carousel containerlocation_id, and no user_tags in its syntax
Carousel itemsNo location_id

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.

Searching for a Page with a location
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.
Z EasyCoexistence zrobisz to

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