Piattaforma Instagram

Contenitore di IG

Rappresenta un contenitore di contenuto multimediale per la pubblicazione di un post di Instagram. Per la procedura completa di pubblicazione, consulta la guida alla pubblicazione dei contenuti.

Creazione

Questa operazione non è supportata.

Lettura

GET /{instagram-container-id}

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

Requisiti

TipoDescrizione

Token d'accesso

Utente

Autorizzazioni

instagram_basic
instagram_content_publish
pages_read_engagement


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


ads_management
business_management

Sintassi della richiesta

GET https://graph.facebook.com/{instagram-container-id}
  ?fields={fields}
  &access_token={access-token}

Parametri della stringa della query

ParametroValore

access_token
Stringa
obbligatoria

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 {instagram-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.facebook.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.