Aziende suggerite utente di IG

Consente di ottenere dati su altri utenti di IG business o creator di Instagram.

Creazione

Questa operazione non è supportata.

Lettura

GET /{ig-user-id}?fields=business_discovery.username({username})

Restituisce dati su un altro utente di IG business o creator di Instagram. Esegui questa richiesta sull'utente di IG business o creator di Instagram che esegue la query e identifica l'azienda definita come destinataria con il parametro username.

Limitazioni

I dati sugli utenti di IG Instagram business con limiti di età non verranno restituiti.

Parametri della stringa della query

{username} (obbligatorio): il nome utente dell'utente di IG business o creator di Instagram su cui desideri ottenere dati.

Autorizzazioni

Un token d'accesso dell'utente Facebook con le autorizzazioni seguenti:

instagram_basic
instagram_manage_insights
pages_read_engagement o 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
pages_read_engagement
business_management

Espansione dei campi

Puoi utilizzare l'espansione dei campi per ottenere campi pubblici sull'utente di IG definito come destinatario. Consulta il riferimento sugli utenti di IG per una lista di campi pubblici.

Richiesta di esempio con espansione dei campi

Ottieni i dati sull'utente di IG business di Instagram "Blue Bottle Coffee" e utilizza l'espansione dei campi per richiederne i follower e il numero di contenuti multimediali.

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){followers_count,media_count}

Esempio di risposta

{
  "business_discovery": {
    "followers_count": 267788,
    "media_count": 1205,
    "id": "17841401441775531"
  },
  "id": "17841405309211844"
}

Accesso ai segmenti con espansione dei campi

Puoi utilizzare l'espansione dei campi per accedere al segmento /media sull'utente di IG definito come destinatario e specificare i campi e le metriche che devono essere restituiti per ciascun oggetto IG Media. Consulta il riferimento sui nodi dei contenuti multimediali per una lista di campi pubblici.

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 esempio con segmento

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){followers_count,media_count,media}

Risposta di esempio con segmento

{
  "business_discovery": {
    "followers_count": 267788,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "id": "17858843269216389"
        },
        {
          "id": "17894036119131554"
        },
        {
          "id": "17894449363137701"
        },
        {
          "id": "17844278716241265"
        },
        {
          "id": "17911489846004508"
        }
      ],
    },
    "id": "17841401441775531"
  },
  "id": "17841405309211844"
}

Paginazione

Il segmento /media supporta la paginazione basata su cursore, pertanto, quando vi si accede tramite l'espansione dei campi, 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 il set di dati restituito.

Esempio di richiesta

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){media{comments_count,like_count}}

Esempio di risposta

{
  "business_discovery": {
    "media": {
      "data": [
        {
          "comments_count": 50,
          "like_count": 5837,
          "id": "17858843269216389"
        },
        {
          "comments_count": 11,
          "like_count": 2997,
          "id": "17894036119131554"
        },
        {
          "comments_count": 28,
          "like_count": 3643,
          "id": "17894449363137701"
        },
        {
          "comments_count": 43,
          "like_count": 4943,
          "id": "17844278716241265"
        },
     ],
   },
   "id": "17841401441775531"
  },
  "id": "17841405976406927"
}

Aggiornamento

Questa operazione non è supportata.

Eliminazione

Questa operazione non è supportata.