API Instagram Graph

Commento menzionato dell'utente Instagram

Restituisce dati su un commento Instagram in cui un utente Instagram è stato @menzionato da un altro utente Instagram.

Creazione

Questa operazione non è supportata.

Lettura

GET /{ig-user-id}?fields=mentioned_comment.comment_id

Restituisce dati su un commento Instagram in cui un utente Instagram è stato @menzionato da un altro utente Instagram.

Limitazioni

Questo endpoint restituirà un errore se i commenti sono stati disabilitati nel contenuto multimediale Instagram su cui l'utente Instagram è stato @menzionato.

Requisiti

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 Business Manager, sarà necessaria anche una delle seguenti autorizzazioni:


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_comment.comment_id({comment-id}){{fields}}
  &access_token={access-token}

Parametri della stringa della query

ParametroValore

{access_token}
Obbligatorio
Stringa

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

{comment-id}
Obbligatoria
Stringa

L'ID del commento Instagram in cui l'utente Instagram è stato @menzionato. L'ID è incluso nel payload di notifica webhook.

{fields}
Lista separata da virgole

Una lista separata da virgole di campi di commento Instagram che desideri vengano restituiti. Se omessa, vengono restituiti i campi predefiniti.

Campi

CampoDescrizione

id
Predefinito
Stringa

ID del commento Instagram.

like_count
Stringa

Numero di "Mi piace" ricevuti dal commento Instagram.

media
Stringa

ID del contenuto multimediale Instagram su cui è stato fatto il commento Instagram. Usa Espansione dei campi per ottenere campi aggiuntivi sull'entità contenuto multimediale Instagram restituita.

text
Predefinito
Stringa

Testo del commento Instagram.

timestamp
Predefinito
Stringa

Data di creazione del commento Instagram formattata in ISO 8601.

Risposta

Esempio di richiesta

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_comment.comment_id(17873440459141021){timestamp,like_count,text,id}&access_token=IGQVJ...'

Esempio di risposta

{
  "mentioned_comment": {
    "timestamp": "2017-05-03T16:09:08+0000",
    "like_count": 185,
    "text": "Shout out to @metricsaurus",
    "id": "17873440459141021"
  },
  "id": "17841405309211844"
}

Espansione dei campi

Puoi espandere il campo media con una lista di campi di contenuti multimediali Instagram per ottenere dati aggiuntivi sull'entità contenuto multimediale Instagram su cui è stato fatto il commento. Ad esempio:

media{id,media_url}

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.

Richiesta di espansione dei campi di esempio

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_comment.comment_id(17873440459141021){timestamp,like_count,text,media{id,media_url}}&access_token=IGQVJ...'

Risposta di espansione dei campi di esempio

{
  "mentioned_comment": {
    "timestamp": "2017-05-03T16:09:08+0000",
    "like_count": 185,
    "text": "Shout out to @metricsaurus",
    "id": "17873440459141021",
    "media": {
      "id": "17895695668004550",
      "media_url": "https://scont..."
    }
  },
  "id": "17841405309211844"
}

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.