AccediInizia la prova gratuita
easyCoexistence API ufficiali

Taggare persone e aggiungere una località a un post Instagram tramite API

L'API di Instagram tagga le persone con user_tags e aggiunge un luogo con location_id, entrambi impostati sul container del media prima della pubblicazione. user_tags accetta username pubblici, con coordinate x e y da 0.0 a 1.0 obbligatorie sulle immagini; Meta lo descrive per immagini, video e Storie. location_id accetta l'ID di una Pagina con dati di località, trovata tramite la Pages Search API.

easyCoexistence pubblica foto, caroselli, Reels e Storie con publish_instagram_post da Claude, ChatGPT o dal tuo codice.

0.0 to 1.0

Intervallo delle coordinate x e y in user_tags, misurate dai bordi sinistro e superiore dell'immagine.

Images

Dove user_tags richiede x e y: sono facoltative sulle Storie, e si applicano solo a immagini e Storie.

Carousels

location_id non è supportato sulle immagini o sui video all'interno di un carosello, secondo il riferimento media di Meta.

USER_TAGGING_FAILURE

Il valore config_issue quando il media viene pubblicato senza i suoi tag utente, che Meta chiama successo parziale.

13 Mar 2018

Quando Meta ha aperto il tagging di località e di account Instagram pubblici nelle foto pubblicate via API, prima ai partner beta.

Come si taggano le persone in un post?

Aggiungi user_tags al container. È un array di oggetti, ciascuno con lo username di un account Instagram pubblico e, su un'immagine, x e y: float da 0.0 a 1.0 che indicano la distanza del tag dai bordi sinistro e superiore. Una località va in location_id nella stessa chiamata, e il container viene poi pubblicato con media_publish come di consueto.

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

Quali post accettano tag utente e località?

Il riferimento media di Meta descrive user_tags per immagini, video e Storie, con x e y che si applicano solo a immagini e Storie, ed elenca i parametri che ogni container accetta. Su un carosello, la località va nel container del carosello, perché location_id non è supportato sulle immagini o sui video al suo interno:

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

Come si trova un location_id?

Cerca una Pagina. location_id è l'ID di una Pagina associata a una località, e il riferimento di Meta indirizza alla Pages Search API, GET /pages/search con q e fields=id,name,location, poi a verificare che la Pagina scelta abbia dati di località. Una Pagina senza questi dati fallisce con INSTAGRAM_PLATFORM_API__INVALID_LOCATION_ID. La ricerca gira sulla Graph API di Meta con il token della tua app Meta: un token utente o, per le informazioni pubbliche della Pagina, un token dell'app con la funzionalità 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>

Cosa succede se un tag non viene collegato?

Il post può comunque andare online. media_publish restituisce allora config_issue impostato su USER_TAGGING_FAILURE, cioè il media è stato pubblicato senza i suoi tag utente. Meta lo definisce un successo parziale e chiede alle app di trattarlo come un segnale da verificare, non come un errore, poiché l'ID del media è valido; pubblicare di nuovo creerebbe un secondo post.

I tag utente funzionano con Instagram Login?

Il riferimento media di Meta elenca user_tags e location_id per la creazione del container senza legarli a un solo login. La sua pagina sull'API di Instagram con Instagram Login, però, dice che quella configurazione non può accedere a annunci o al tagging, senza specificare quale tagging intenda. Prima di costruire su uno dei due parametri con Instagram Login, pubblica un post di prova e controlla la risposta e il post stesso.

Come si taggano le persone tramite easyCoexistence?

Per ora non si può. publish_instagram_post crea il container da sé e non accetta user_tags né location_id, e i token di Instagram non vengono consegnati per una chiamata propria. Pubblica il post con publish_instagram_post, poi aggiungi i tag e la posizione nell'app Instagram, dall'opzione Modifica del post.

Errori comuni

  • Omettere x e y su un tag di un'immagine. Meta li richiede sulle immagini; solo le Storie li rendono facoltativi.
  • Indicare coordinate in pixel o percentuali. x e y sono float da 0.0 a 1.0, misurati dai bordi sinistro e superiore.
  • Impostare location_id sugli elementi di un carosello. Meta non lo supporta sulle immagini o sui video al suo interno.
  • Taggare un account privato. user_tags accetta gli username di account Instagram pubblici.
Farlo con EasyCoexistence

Lo strumento non accetta user_tags né location_id, quindi persone e luoghi si taggano nell'app Instagram, dall'opzione Modifica del post. Da US$ 9 a US$ 0,75 per connessione al mese, con il calo man mano che aggiungi connessioni, e i primi 3 giorni di prova gratuita.

Domande frequenti

Posso taggare un account Instagram privato tramite API?

No. Il riferimento media di Meta dice che user_tags accetta gli username di account Instagram pubblici, quindi un account privato non può essere taggato in questo modo.

Quante persone si possono taggare in un post?

Il riferimento di Meta per user_tags non indica un massimo. Il limite di 20 che riporta riguarda i tag @ in una didascalia.

Posso aggiungere una località a una Storia tramite API?

No. La sintassi di Meta per un container di Storia elenca user_tags ma non location_id.

Posso taggare un prodotto invece di una persona?

I tag prodotto sono una funzione separata, che la panoramica di Meta indica come supportata con Facebook Login e Unified Login, non con Instagram Login.

Continua a leggere

Collega il tuo primo canale in due minuti.

Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.

  • 3 giorni gratis
  • Disdici quando vuoi
  • Solo API ufficiali
  • Monitorato 24/7

Verificato il