Tag

Rappresenta una raccolta di oggetti Contenuto multimediale di IG in cui un utente di IG è stato taggato da un altro utente Instagram.

Creazione

Questa operazione non è supportata.

Lettura

GET /{ig-user-id}/tags

Restituisce lista di oggetti Contenuti multimediali IG in cui un utente IG è stato taggato da un altro utente Instagram.

Limitazioni

Gli oggetti Contenuti multimediali IG non verranno restituiti.

Requisiti

TipoDescrizione

Token d'accesso

Utente

Funzioni

Non applicabile.

Autorizzazioni

instagram_basic
instagram_manage_comments
pages_read_engagement

pages_show_list


Se il token proviene da un utente il cui ruolo nella Pagina è stato concesso tramite il Business Manager, è richiesta anche una delle seguenti autorizzazioni: ads_management, business_management o pages_read_engagement.

Attività

L'utente dell'app deve essere in grado di eseguire le attività appropriate sulla Pagina in base alle autorizzazioni richieste dall'app.

Sintassi della richiesta

GET https://graph.facebook.com/{ig-user-id}/tags
  ?fields={fields}
  &access_token={access-token}

Parametri della stringa della query

Includono i seguenti parametri della stringa della query per potenziare la richiesta.

CodiceValore

access_token
Obbligatorio
Stringa

Il token d'accesso dell'utente Instagram dell'utente dell'app.

fields
Lista separata da virgole

Una lista separata da virgole di campi e segmenti che desideri vengano restituiti nella risposta. Se omessa, vengono restituiti i campi predefiniti.

Campi

Utilizza il parametro della stringa della query fields per specificare i campi che desideri vengano inclusi in qualsiasi oggetto Contenuti multimediali IG restituito.

v10.0 e chiamate precedenti fino al 7 settembre 2021: il campo like_count sui contenuti multimediali IG restituirà 0 se il creatore dei contenuti multimediali ha nascosto il numero di "Mi piace" su questi ultimi.

Chiamate versione 11.0 e successive tutte le versioni il 7 settembre 2021: se si interroga indirettamente un contenuto multimediale di Instagram tramite un altro endpoint o espansione di campo, il campo like_count sarà omesso dalle risposte API se il creatore del contenuto multimediale ha nascosto il numero di "Mi piace" su di esso. L'esecuzione di una query direttamente sui contenuti multimediali IG, che può essere eseguita solo dal creatore dei contenuti multimediali IG, restituirà il numero di "Mi piace" effettivo, anche se il numero di "Mi piace" è stato nascosto.

Segmenti

Utilizza il parametro della stringa della query fields per specificare i segmenti che si desidera includere in qualsiasi oggetto Contenuti multimediali IG restituito.

Risposta

Un oggetto in formato JSON contenente oggetti Contenuto multimediale di IG.

{
  "{field}":"{value}",
  ...
}

Paginazione

Questo segmento supporta la paginazione basata su cursore, pertanto la risposta includerà i cursori before e after qualora contenga più pagine di dati. A differenza della paginazione basata su cursore standard, tuttavia, la risposta non includerà i campi previous o next, quindi dovrai usare i cursori before e after per creare manualmente le stringhe della query previous e next per poter sfogliare l'insieme di dati restituito.

Esempio di richiesta

GET graph.facebook.com/17841405822304914/tags
    ?fields=id,username
    &access_token=EAADd...

Esempio di risposta

{
  "data": [
    {
      "id": "18038...",
      "username": "keldo..."
    },
    {
      "id": "17930...",
      "username": "ashla..."
    },
    {
      "id": "17931...",
      "username": "jaypo..."
    }
  ]
}

Aggiornamento

Questa operazione non è supportata.

Eliminazione

Questa operazione non è supportata.