Panoramica
L'API Instagram Graph è una raccolta di endpoint che consente alle app di accedere ai dati negli account Instagram per professionisti (sia business sia creator). Se non hai familiarità con l'API Graph di Facebook, leggi la nostra documentazione sull'API Graph prima di procedere.
URL di base
È possibile accedere a tutti gli endpoint tramite l'host graph.facebook.com.
Utenti dell'app
Gli account Instagram Professional sono accessibili indirettamente tramite gli account Facebook, quindi gli utenti dell'app devono disporre di un account Facebook e utilizzarlo per accedere all'app. L'account Facebook deve inoltre essere abilitato a eseguire attività equivalenti a quelle di un amministratore su una Pagina Facebook che è stata collegata all'account Instagram a cui tenta di accedere.
Questi requisiti si applicano a tutti gli utenti dell'app, anche a quelli che hanno un ruolo al suo interno o in un Business Manager che ha reclamato l'app.
Autenticazione
L'autenticazione dell'utente dell'app viene gestita tramite i token d'accesso. Gli account Instagram per professionisti sono accessibili indirettamente tramite gli account Facebook, quindi tutte le richieste API devono includere il token d'accesso dell'utente di Facebook degli utenti dell'app. Puoi ottenere i token dagli utenti dell'app implementando Facebook Login. Facebook Login non supporta le credenziali di Instagram, quindi gli utenti dell'app devono accedere utilizzando un account Facebook.
Autorizzazione
Per ogni endpoint sono necessarie specifiche autorizzazioni e funzioni. Prima che l'app possa utilizzare un endpoint per accedere ai dati Instagram di un utente, devi richiedere all'utente tutte le autorizzazioni necessarie e ottenere le relative approvazioni. A questo punto, puoi effettuare una query sugli endpoint per accedere ai dati dell'utente.
Un'autorizzazione consente solo di accedere ai dati creati dall'utente che l'ha concessa. Sono disponibili alcuni endpoint che consentono alle app di accedere a dati non creati dall'utente dell'app, ma i dati accessibili sono limitati e pubblici.
Puoi richiedere le autorizzazioni agli utenti dell'app implementando Facebook Login. Gli utenti che hanno un ruolo nell'app possono concedere qualsiasi autorizzazione richiesta. Gli utenti che non hanno un ruolo nell'app possono concedere solo autorizzazioni e funzioni che sono state approvate tramite la procedura di analisi dell'app.
L'API utilizza le seguenti autorizzazioni e funzioni:
Consulta il riferimento per gli endpoint per determinare quali autorizzazioni e funzioni deve richiedere l'app agli utenti.
Messaggistica di Instagram
Se prevedi di implementare Messaggi di Instagram dalla Piattaforma Messenger, dovrai includere l'autorizzazione instagram_manage_messages. Ulteriori informazioni sulla messaggistica di Instagram. 
Collaboratori
La funzione Collaborazione di Instagram consente agli utenti dell'app di Instagram di essere coautori del contenuto (ovvero di pubblicare contenuto multimediale) insieme ad altri account (collaboratori).
A parte poche eccezioni, i dati relativi ai contenuti multimediali con coautori sono accessibili tramite API solo all'utente che ha pubblicato tali contenuti multimediali; i collaboratori non sono in grado di accedere a questi dati tramite l'API. Le sole eccezioni sono in caso di ricerca per contenuto multimediale più popolare o pubblicato di recente che è stato taggato con un hashtag specifico. Consulta Ricerca degli hashtag.
Pagine
Gli account Instagram per professionisti devono essere collegati a una Pagina Facebook prima che sia possibile accedere ai loro dati tramite l'API. Dopo aver eseguito la connessione, qualsiasi utente Facebook che può eseguire attività sulla Pagina potrà concedere all'app un token d'accesso da utilizzare nelle richieste API.
Il nostro articolo dell'assistenza Aggiunta o modifica della Pagina Facebook collegata al tuo account Instagram per professionisti spiega come connettere una Pagina Facebook a un account Instagram per professionisti.
Attività
Per poter concedere le autorizzazioni, un utente dell'app deve poter eseguire attività sulla Pagina Facebook collegata all'account Instagram a cui tenta di accedere. Le autorizzazioni possono essere concesse dagli utenti dell'app in base alle attività che sono autorizzati a eseguire:
| Autorizzazione | MANAGE | CREATE_CONTENT | MODERATE | ADVERTISE | ANALYZE |
|---|---|---|---|---|---|
instagram_basic | ✔ | ✔ | ✔ | ✔ | ✔ |
instagram_content_publish | ✔ | ✔ | |||
instagram_manage_comments | ✔ | ✔ | ✔ | ||
instagram_manage_insights | ✔ | ✔ | ✔ | ✔ | ✔ |
Puoi determinare quali attività possono essere eseguite da un utente dell'app su una Pagina interrogando l'endpoint GET /me/accounts con il token d'accesso dell'utente dell'utente dell'app. L'endpoint restituisce una lista di Pagine su cui l'utente può eseguire attività e indica quali può eseguire su ciascuna Pagina.
Consulta la documentazione di riferimento per vedere le autorizzazioni necessarie per ogni endpoint. L'API non supporta gli utenti di sistema di Business Manager o gli utenti dell'app che hanno un ruolo di collaboratore per i video in diretta.
Riferimento alle attività
Se devi informare gli utenti sulle attività (e su quali sono necessarie per utilizzare correttamente l'app), di seguito è indicato come vengono indicate le attività nelle varie interfacce utente.
Pagine classiche
Nelle Pagine classiche ci si riferisce alle attività con il termine ruoli. Gli utenti dell'app con un ruolo di amministratore su una Pagina possono concedere all'app qualsiasi autorizzazione. Gli utenti dell'app con altri ruoli possono concedere le autorizzazioni nel modo seguente:
| Ruolo | Autorizzazioni concedibili |
|---|---|
Editore | instagram_basic |
Moderatore | instagram_basic |
Inserzionista | instagram_basic |
Analista | instagram_basic |
Nuova esperienza delle Pagine
Con Nuova esperienza sulle Pagine ci si riferisce ad attività come Accesso a Facebook o Accesso alle attività. Gli utenti dell'app con un Accesso a Facebook su una Pagina possono concedere all'app qualsiasi autorizzazione. Gli utenti dell'app con Accesso alle attività possono concedere le autorizzazioni nel modo seguente:
| Accesso alle attività | Autorizzazioni concedibili |
|---|---|
Inserzioni | instagram_basic |
Contenuto | instagram_basic |
Insight | instagram_basic |
Messaggi e attività della community | instagram_basic |
Per determinare se una Pagina sta usando la nuova esperienza, richiedi il campo has_transitioned_to_new_page_experience. Se il valore restituito è true, la Pagina usa la nuova esperienza.
Analisi dell'app
La tua app deve completare l'analisi dell'app prima di poter essere utilizzata dagli utenti dell'app che non hanno un ruolo al suo interno o un ruolo in un Business Manager che ha reclamato l'app. Se la tua app verrà utilizzata solo dagli utenti che hanno un ruolo al suo interno o in Business Manager, non è necessario completare l'analisi dell'app.
La richiesta di analisi dell'app non deve includere alcuna credenziale di utente test Facebook se hai implementato Facebook Login e l'app è disponibile pubblicamente. Tuttavia, se le persone addette al controllo devono accedere a un account non Facebook per attivare l'implementazione di Facebook Login, devi includere nella richiesta le credenziali di tale account.
App private
Se le persone addette al controllo non riescono a testare l'app perché risiede dietro una intranet privata, non ha un'interfaccia utente o Facebook Login non è implementato, puoi richiedere l'approvazione solo per queste autorizzazioni:
Verifica dell'azienda
Devi completare la Verifica dell'azienda se la tua app verrà utilizzata da utenti dell'app che non hanno un ruolo al suo interno o in un Business Manager che ha reclamato l'app.
Rate limiting
Tutti gli endpoint sono soggetti a rate limiting per casi d'uso Instagram Business ad eccezione degli endpoint Aziende suggerite e Ricerca degli hashtag, che sono soggetti al rate limiting della piattaforma.
Webhook
Puoi usare i webhook per ricevere notifiche quando qualcuno commenta gli elementi multimediali della tua app o quando le Storie scadono. Consulta la nostra documentazione sui webhook per scoprire come usare i webhook, configurare un webhook per l'argomento Instagram e attivare l'iscrizione ai campi comments e story_insights.
Messaggistica di Instagram
Diversi endpoint dell'API Instagram Graph vengono utilizzati insieme agli endpoint della Piattaforma Messenger per consentire agli utenti dell'app di interagire con i direct inviati ai loro account Instagram per professionisti. Consultare la documentazione Messaggi di Instagram della Piattaforma Messenger per scoprire come accedere ai messaggi negli account business di Instagram.