API Instagram Graph

Collaboratori

Rappresenta una lista di utenti aggiunti come collaboratori su un oggetto di tipo Contenuto multimediale di IG.

Creazione

Questa operazione non è supportata.

Lettura

È possibile ottenere una lista di utenti Instagram come collaboratori e il loro stato di invito su un oggetto di tipo Contenuto multimediale di IG.

GET /{ig-media-id}

Limitazioni

  • È possibile aggiungere fino a 3 account Instagram come collaboratori
  • Solo gli utenti IG che hanno abilitato i tag dei collaboratori saranno restituiti nella risposta
  • I tag dei collaboratori supportano immagine del feed, reel e carosello; le storie non sono supportate

Requisiti

TipoDescrizione

Token d'accesso

Utente: l'utente deve aver creato l'oggetto Contenuto multimediale di IG

Autorizzazioni

instagram_basic
pages_read_engagement
pages_show_list


Se all'utente dell'app è stato concesso un ruolo sulla Pagina tramite Business Manager, è necessaria anche una delle seguenti autorizzazioni:


ads_management
business_management

Sintassi della richiesta

GET https://graph.facebook.com/{appi-version}/{ig-media-id}/collaborators

Esempio di risposta

{
  "data": [
    {
      "id": "90010775360791",
      "username": "realtest1",
      "invite_status": "Accpeted"
    },
    {
      "id": "17841449208283139",
      "username": "realtest2",
      "invite_status": "Pending"
    },
    {
      "id": "90011117049518",
      "username": "realtest3",
      "invite_status": "Declined"
    }
  ]
}

Parametri del percorso

SegnapostoValore

{api-version}

Versione dell'API.

{ig-user-id}

Obbligatorio. ID utente di IG.

Parametri della stringa della query

ChiaveSegnapostoValore

access_token

{access-token}

Obbligatorio. Token d'accesso dell'utente dell'utente dell'app.

Campi di risposta

Nome del campoDescrizione

id

L'ID per singola app per l'account Instagram del potenziale collaboratore

invite_status

Lo stato dell'invito inviato a un potenziale collaboratore. Può essere uno dei seguenti:

  • Accepted
  • Declined
  • Pending

username

Nome utente del profilo Instagram per il potenziale collaboratore

Aggiornamento

Questa operazione non è supportata.

Eliminazione

Questa operazione non è supportata.