Contenuti multimediali menzionati

Restituisce dati su un contenuto multimediale di IG in cui un utente di IG è stato @menzionato in una didascalia da un altro utente Instagram.

Creazione

Questa operazione non è supportata.

Lettura

GET /{ig-user-id}?fields=mentioned_media.media_id

Restituisce dati su un contenuto multimediale di IG in cui un utente di IG è stato @menzionato in una didascalia da un altro utente Instagram.

Limitazioni

Le menzioni sulle storie non sono supportate.
I commenti sulle foto in cui sei stato taggato non sono supportati.
I webhook non verranno inviati se i contenuti multimediali su cui appare il commento o la @menzione sono stati creati da un account impostato come privato.

Requisiti

Tipo Descrizione

Tipo	Descrizione
Token d'accesso	Utente
Autorizzazioni	`instagram_basic` `instagram_manage_comments` `pages_read_engagement` `pages_show_list` Se all'utente dell'app è stato concesso un ruolo sulla Pagina tramite il Business Manager, sarà necessario anche uno dei seguenti: `ads_management` `business_management`
Attività	`MANAGE`, `CREATE_CONTENT` o `MODERATE`

Token d'accesso

Utente

Autorizzazioni

instagram_basic
instagram_manage_comments
pages_read_engagement
pages_show_list

Se all'utente dell'app è stato concesso un ruolo sulla Pagina tramite il Business Manager, sarà necessario anche uno dei seguenti:

ads_management
business_management

Attività

MANAGE, CREATE_CONTENT o MODERATE

Sintassi della richiesta

GET https://graph.facebook.com/v19.0/{ig-user-id}
  ?fields=mentioned_media.media_id({media-id}){{fields}}
  &access_token={access-token}

Parametri della stringa della query

Parametro	Valore
`{access_token}` Obbligatorio Stringa	Il token d'accesso utente dell'utente dell'app.
`{fields}` Lista separata da virgole	Una lista separata da virgole di campi di contenuti multimediali di IG che desideri vengano restituiti. Se omessa, vengono restituiti i campi predefiniti.
`{media-id}` Obbligatoria Stringa	L'ID del contenuto multimediale di IG in cui l'utente di IG è stato @menzionato in una didascalia. L'ID è incluso nel payload di notifica webhook.

Campi

Campo	Descrizione
`caption` Stringa	Il testo della didascalia. Le didascalie che @menzionano un utente di IG non includeranno il simbolo `@` a meno che l'oggetto contenuto multimediale di IG su cui è stata realizzata la didascalia non sia stato creato dall'utente dell'app.
`comments` Oggetto	Una lista di commenti di IG sul contenuto multimediale di IG. Se si utilizza l'espansione dei campi per ottenere il testo del commento, il testo che @menziona un utente di IG non includerà il simbolo `@` a meno che l'oggetto contenuto multimediale di IG su cui è stata realizzata la didascalia non sia stato creato dell'utente dell'app.
`comments_count` Stringa	Numero di commenti di IG sul contenuto multimediale di IG.
`id` Predefinito Stringa	ID del contenuto multimediale di IG.
`like_count` Stringa	Numero di "Mi piace" sul contenuto multimediale. Esclude i "Mi piace" sul contenuto multimediale degli elementi secondari dell'album e i "Mi piace" sui post promossi creati dal contenuto multimediale. Include le risposte ai commenti. Chiamate versione 10.0 e precedenti: il valore sarà `0` se chi ha creato il contenuto multimediale ha nascosto il numero di "Mi piace". Chiamate versione 11.0 e successive: il campo sarà omesso se il creatore del contenuto multimediale ha nascosto il numero di "Mi piace". Il valore sarà `0` se il creatore del contenuto multimediale ha nascosto il numero di "Mi piace".
`media_type` Stringa	Il tipo di contenuto multimediale di IG: `CAROUSEL_ALBUM`, `IMAGE`, `STORY` o `VIDEO`.
`media_url` Stringa	URL del contenuto multimediale di IG pubblicato.
`owner` Stringa	ID dell'utente di IG che ha creato il contenuto multimediale di IG. Restituito solo se l'oggetto contenuto multimediale di IG è stato creato dall'utente dell'app, altrimenti verrà restituito al suo posto il campo `username`.
`timestamp` Stringa	Data di creazione del contenuto multimediale di IG formattato in ISO 8601.
`username` Stringa	Nome utente dell'utente di IG che ha creato il contenuto multimediale di IG.

Esempio di richiesta

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_media.media_id(17873440459141021){caption,media_type}&access_token=IGQVJ...'

Esempio di risposta

{
  "mentioned_media": {
    "caption": "metricsaurus headquarters!",
    "media_type": "IMAGE",
    "id": "17873440459141021"
  },
  "id": "17841405309211844"
}

Nell'esempio sopra, l'API ha eliminato il simbolo @ di apertura dalla didascalia originale (@metricsaurus headquarters!) perché la didascalia non è stata creata dall'utente dell'app.

Paginazione

Se si utilizza l'espansione dei campi per accedere a un segmento che supporta la paginazione basata su cursore, 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.

Aggiornamento

Questa operazione non è supportata.

Eliminazione

Questa operazione non è supportata.