Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

Označavanje osoba i dodavanje lokacije Instagram objavi putem API-ja

Instagram API označava osobe pomoću user_tags i dodaje mjesto pomoću location_id, a oba se postavljaju na medijski kontejner prije objave. user_tags prima javna korisnička imena s koordinatama x i y od 0.0 do 1.0, koje su obavezne na slikama. Meta to opisuje za slike, videozapise i Stories. location_id prima ID Pagea s podacima o lokaciji, koji se pronalazi putem Pages Search API-ja.

easyCoexistence objavljuje fotografije, karusele, Reels i Stories pomoću publish_instagram_post iz Claude, ChatGPT ili vlastitog koda.

0.0 to 1.0

Raspon koordinata x i y u user_tags, mjereno od lijevog i gornjeg ruba slike.

Images

Gdje su x i y obavezni u user_tags; na Stories su neobavezni, a primjenjuju se samo na slike i Stories.

Carousels

location_id nije podržan za slike ili videozapise unutar karusela, navodi Metina referenca za medije.

USER_TAGGING_FAILURE

Vrijednost config_issue kada se medij objavi bez svojih oznaka korisnika, što Meta naziva djelomičnim uspjehom.

13 Mar 2018

Kada je Meta omogućila označavanje lokacija i javnih Instagram korisnika na fotografijama objavljenima putem API-ja, najprije beta partnerima.

Kako označiti osobe u objavi?

Dodajte user_tags u kontejner. To je niz objekata, a svaki sadrži korisničko ime javnog Instagram računa i, na slici, x i y: brojeve s pomičnom točkom od 0.0 do 1.0 koji daju udaljenost oznake od lijevog i gornjeg ruba. Lokacija ide u location_id u istom pozivu, a kontejner se zatim objavljuje putem media_publish kao i obično.

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>"
}

Koje objave primaju oznake korisnika i lokaciju?

Metina referenca za medije opisuje user_tags za slike, videozapise i Stories, pri čemu se x i y primjenjuju samo na slike i Stories, te navodi parametre koje prima svaki kontejner. Na karuselu se lokacija stavlja na kontejner karusela, jer location_id nije podržan za slike ili videozapise unutar njega:

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

Kako pronaći location_id?

Potražite Page. location_id je ID Pagea povezanog s lokacijom. Metina referenca upućuje na Pages Search API, GET /pages/search s parametrima q i fields=id,name,location, zatim na provjeru ima li odabrana Page podatke o lokaciji. Page bez tih podataka vraća INSTAGRAM_PLATFORM_API__INVALID_LOCATION_ID. Pretraga se izvodi na Metinom Graph API-ju s tokenom vlastite Meta aplikacije: korisnički token ili, za javne podatke o Pageu, token aplikacije s funkcijom 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>

Što se događa ako oznaka ne uspije?

Objava i dalje može biti objavljena. media_publish tada vraća config_issue postavljen na USER_TAGGING_FAILURE, što znači da je medij objavljen bez svojih oznaka korisnika. Meta to naziva djelomičnim uspjehom i traži od aplikacija da to tretiraju kao signal za usklađivanje, a ne kao pogrešku, jer je ID medija valjan; ponovno objavljivanje stvorilo bi drugu objavu.

Rade li oznake korisnika s Instagram Loginom?

Metina referenca za medije navodi user_tags i location_id za stvaranje kontejnera, bez vezivanja uz jednu prijavu. Njezina stranica za Instagram API s Instagram Loginom, međutim, kaže da takva postavka ne može pristupiti oglasima ni označavanju, bez navođenja o kakvom označavanju je riječ. Prije nego što se oslonite na bilo koji parametar uz Instagram Login, objavite probnu objavu i provjerite odgovor i samu objavu.

Kako označiti osobe pomoću easyCoexistence?

Još ne možete. publish_instagram_post sam stvara kontejner i ne prima user_tags ni location_id, a Instagram tokeni se ne predaju za vlastiti poziv. Objavite post pomoću publish_instagram_post, a zatim dodajte oznake i lokaciju u aplikaciji Instagram, putem opcije Uredi na objavi.

Uobičajene pogreške

  • Izostavljanje x i y u oznaci na slici. Meta ih zahtijeva na slikama; samo ih Stories čine neobaveznima.
  • Zadavanje koordinata u pikselima ili postocima. x i y su brojevi s pomičnom točkom od 0.0 do 1.0, mjereni od lijevog i gornjeg ruba.
  • Postavljanje location_id na stavke karusela. Meta to ne podržava za slike ili videozapise unutar karusela.
  • Označavanje privatnog računa. user_tags prima korisnička imena javnih Instagram računa.
Radite ovo uz EasyCoexistence

Alat ne prima user_tags ni location_id, pa se osobe i mjesta označavaju u aplikaciji Instagram, putem opcije Uredi na objavi. Cijena: US$ 9 do US$ 0.75 po vezi mjesečno, uz sniženje kako dodajete veze, a prva 3 dana su besplatna.

Često postavljana pitanja

Mogu li putem API-ja označiti privatni Instagram račun?

Ne. Metina referenca za medije kaže da user_tags prima korisnička imena javnih Instagram računa, pa se privatni račun na taj način ne može označiti.

Koliko se osoba može označiti u jednoj objavi?

Metina referenca za user_tags ne navodi najveći broj. Ograničenje od 20 koje navodi odnosi se na oznake @ u opisu.

Mogu li putem API-ja dodati lokaciju na Story?

Ne. Metina sintaksa za kontejner Storyja navodi user_tags, ali ne i location_id.

Mogu li označiti proizvod umjesto osobe?

Oznake proizvoda su zasebna značajka koju Metin pregled navodi kao podržanu uz Facebook Login i Unified Login, a ne uz Instagram Login.

Nastavite čitati

Povežite svoj prvi kanal u dvije minute.

Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo službeni API-ji
  • Nadzor 24/7

Provjereno na