Contenitore di Instagram (IG)

Rappresenta un contenitore di contenuto multimediale per la pubblicazione di un oggetto multimediale di Instagram.

Requirements

Instagram API with Instagram LoginInstagram API with Facebook Login

Access Tokens

  • Instagram User user access token

Host URL

graph.instagram.com

graph.facebook.com

Login Type

Business Login for Instagram

Facebook Login for Business

Permissions
  • instagram_business_basic
  • instagram_business_content_publish
  • instagram_basic
  • instagram_content_publish
  • pages_read_engagement

If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of:

  • ads_management
  • ads_read

Creazione

Questa operazione non è supportata.

Lettura

GET <HOST_URL>/<IG_CONTAINER_ID>

Consente di ottenere campi e segmenti su un contenitore di IG.

Sintassi della richiesta

GET <HOST_URL>/<API_VERSION>/<IG_CONTAINER_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

Parametri della stringa della query

ParametroValore

access_token
Obbligatorio
Stringa

Token d'accesso di tipo utente dell'utente dell'app.

fields
Lista separata da virgole

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

Campi

Nome del campoDescrizione

copyright_check_status

Utilizzato per determinare se un video caricato viola i diritti d'autore. Le coppie chiave-valore restituite includono:

  • matches_found impostato su uno dei seguenti valori:
    • true: il video viola i diritti d'autore
    • false: il video non viola i diritti d'autore
  • status impostato su uno dei seguenti valori:
    • completed: la procedura di rilevamento è terminata
    • error: si è verificato un errore durante la procedura di rilevamento
    • in_progress: la procedura di rilevamento è in corso
    • not_started: la procedura di rilevamento non è stata avviata

id

ID contenitore di Instagram, rappresentato in esempi di codice come <IG_CONTAINER_ID>

status

Stato di pubblicazione. Se status_code è ERROR, questo valore sarà un sottocodice di errore.

status_code

Lo stato di pubblicazione del contenitore. Valori possibili:


  • EXPIRED: il contenitore non è stato pubblicato entro 24 ore ed è scaduto.
  • ERROR: il contenitore non è riuscito a completare la procedura di pubblicazione.
  • FINISHED: il contenitore e il relativo oggetto multimediale sono pronti per essere pubblicati.
  • IN_PROGRESS: il contenitore è ancora in fase di pubblicazione.
  • PUBLISHED: l'oggetto multimediale del contenitore è stato pubblicato.

Segmenti

Questo nodo non ha segmenti.

Risposta

Un oggetto in formato JSON contenente campi predefiniti e richiesti.

{
  "<FIELD>":"<VALUE>",
  ...
}

Esempio di richiesta

curl -X GET \
  'https://graph.instagram.com/17889615691921648?fields=status_code&access_token=IGQVJ...'

Esempio di risposta

{
  "status_code": "FINISHED",
  "id": "17889615691921648"
}

Aggiornamento

Questa operazione non è supportata.

Eliminazione

Questa operazione non è supportata.