Contenuti multimediali di Instagram

Rappresenta un album, una foto o un video (caricato, in diretta, un reel o una storia) di Instagram.

Presentazione del seguente campo:

• legacy_instagram_media_id

I seguenti campi dell'endpoint Marketing API Instagram Ads non sono supportati:

• filter_name
• location
• location_name
• latitude
• longitude

Creazione

Questa operazione non è supportata.

Lettura

GET /<IG_MEDIA_ID>

Consente di ottenere campi e segmenti su contenuti multimediali di Instagram.

Requisiti

Limitazioni

• Campi come comments_count e like_count restituiscono le interazioni solo dai contenuti multimediali di Instagram targetizzati e non includono dati da altre piattaforme. Ad esempio, comments_count restituisce il numero di commenti a una foto, ma non quelli alle inserzioni che contengono la foto. Usa total_comments_count e total_like_count per ottenere numeri aggregati che includano le interazioni dai contenuti multimediali promossi/messi in evidenza/pubblicitari. Il conteggio dei post di Facebook con cross-posting potrebbe essere incluso se tali post sono accessibili dall'utente della sessione.
• Le didascalie non includono il simbolo @ a meno che l'utente dell'app non sia autorizzato a eseguire nell'app anche attività equivalenti a quelle di un amministratore.
• Alcuni campi, come permalink, non sono utilizzabili nelle foto all'interno degli album (elementi secondari).
• I contenuti multimediali di Instagram di tipo video in diretta possono essere letti solo mentre vengono trasmessi.
• Questa API restituisce solo i dati per i contenuti multimediali di proprietà di account Instagram per professionisti. Non può essere usata per ottenere dati per i contenuti multimediali di proprietà di account Instagram personali.
• I campi reposts_count, saved_count, shares_count, total_like_count, total_comments_count e total_views_count non sono disponibili per i contenuti multimediali secondari del carosello e vengono restituiti solo per gli oggetti multimediali di primo livello. Il titolare del contenuto multimediale può disabilitare la visualizzazione di "Mi piace", commenti, visualizzazioni, repost e condivisioni; in questi casi, i campi corrispondenti non vengono restituiti.

Sintassi della richiesta

GET https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID> \
  ?fields=<LIST_OF_FIELDS> \
  &access_token=<ACCESS_TOKEN>

Parametri del percorso

Parametri della stringa della query

Campi

I campi pubblici possono essere letti tramite l'espansione dei campi.

Segmenti

I segmenti pubblici possono essere restituiti tramite l'espansione dei campi.

Esempio di cURL

Esempio di richiesta

curl -X GET \
  'https://graph.instagram.com/v26.0/17895695668004550?fields=id,media_type,media_url,owner,timestamp&access_token=IGQVJ...'

Risposta di esempio

{
  "id": "17918920912340654",
  "media_type": "IMAGE",
  "media_url": "https://sconten...",
  "owner": {
    "id": "17841405309211844"
  },
  "timestamp": "2019-09-26T22:36:43+0000"
}

Aggiornamento

POST /<IG_MEDIA_ID>

Consente di abilitare o disabilitare i commenti su un contenuto multimediale di Instagram.

Limitazioni

Contenuto multimediale di Instagram di tipo video in diretta non supportato.

Sintassi della richiesta

POST https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID>
  ?comment_enabled=<BOOL>
  &access_token=<ACCESS_TOKEN>

Parametri del percorso

Parametri della stringa della query

Esempio di cURL

Esempio di richiesta

curl -i -X POST \
 "https://graph.instagram.com/v26.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

Risposta di esempio

{
  "success": true
}

Eliminazione

DELETE /<IG_MEDIA_ID>

Elimina un contenuto multimediale di Instagram.

Requisiti

Limitazioni

Questa API supporta l'API Instagram solo con Facebook Login. Sono supportati post non pubblicitari, storie, reel e interi album carosello. Per eliminare i contenuti multimediali all'interno degli album carosello, deve essere eliminato l'intero album carosello, specificando l'ID del contenuto multimediale del contenitore carosello. Non è supportata l'eliminazione singola dei contenuti multimediali all'interno di un carosello.

Sintassi della richiesta

POST https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?access_token=<ACCESS_TOKEN>

Parametri del percorso

Parametri della stringa della query

Esempio di cURL

Esempio di richiesta

curl -i -X DELETE \
 "https://graph.facebook.com/v26.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

Esempio di risposta: Azione eseguita correttamente

{
  "success": true,
  "deleted_id": "17918920912340654"
}

Esempio di risposta (errore, tipo di contenuto multimediale non supportato)

{
  "error": {
   "message": "Fatal",
   "type": "OAuthException",
   "code": -1,
   "error_subcode": 2207073,
   "is_transient": false,
   "error_user_title": "Media Type Not Supported",
   "error_user_msg": "The media type is not supported for this endpoint",
   "fbtrace_id": "Api-OlNdfcpOwIu6hNaT5Kw"
  },
}