Piattaforma Instagram

Collaboratori

Rappresenta una lista di utenti aggiunti come collaboratori in un oggetto Contenuto multimediale di Instagram.

Disponibile per l'API Instagram con Facebook Login.

Creazione

Questa operazione non è supportata.

Lettura

Ottieni una lista di utenti Instagram come collaboratori e il loro stato di invito in un oggetto Contenuto multimediale di Instagram.

GET /<IG_MEDIA_ID>

Limitazioni

  • È possibile aggiungere fino a 5 account Instagram come collaboratori
  • Verranno restituiti nella risposta solo gli utenti Instagram che hanno abilitato i tag dei collaboratori
  • 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

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

ads_management
ads_read

Sintassi della richiesta

GET https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>/collaborators&<USER_ACCESS_TOKEN>

Risposta di esempio

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

Parametri del percorso

SegnapostoValore

<API_VERSION>

Versione dell'API.

<IG_MEDIA_ID>

Campo obbligatorio. L'ID del contenuto multimediale di Instagram per l'utente della tua app.

Parametri della stringa query

ChiaveSegnapostoValore

access_token

<USER_ACCESS_TOKEN>

Campo obbligatorio. Token d'accesso utente per l'utente della tua 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
  • Pending

username

Nome utente del profilo Instagram per il potenziale collaboratore

Aggiornamento

Questa operazione non è supportata.

Eliminazione

Questa operazione non è supportata.