Piattaforma Instagram
Torna indietro a Italiano
Questo documento è stato aggiornato.
La traduzione in Italiano non è ancora completa.
Aggiornamento inglese: 25 ott

Contenuto multimediale di IG

Rappresenta un album, una foto o un video (caricato, in diretta o creato con l'app Instagram TV, un reel o una storia) di Instagram.

A partire dal 3 giugno 2024 puoi usare il campo boost_eligibility_info come modo pratico ed efficace per determinare se i contenuti multimediali sono idonei a essere messi in evidenza come inserzione e il campo boost_ads_list per tracciare le informazioni sulle precedenti inserzioni in evidenza su Instagram relative all'inserzione. Per maggiori informazioni, consulta il post sul blog. Disponibile solo per l'API Instagram Graph.

Creazione

Questa operazione non è supportata.

Lettura

GET /<IG_MEDIA_ID>

Consente di ottenere campi e segmenti su un contenuto multimediale di IG.

Limitazioni

  • I campi che restituiscono valori aggregati non includono dati basati su inserzioni. Ad esempio, comments_count conta i commenti a una foto, ma non quelli alle inserzioni che contengono la foto.
  • 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 IG 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.

Sintassi della richiesta

GET https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

Parametri del percorso

SegnapostoValore

<API_VERSION>

Versione dell'API.

<IG_MEDIA_ID>

Obbligatorio. ID per il contenuto multimediale da pubblicare.

Parametri della stringa della query

ChiaveSegnapostoValore

access_token

<ACCESS_TOKEN>

Obbligatorio. Token d'accesso utente dell'utente dell'app

fields

<LIST_OF_FIELDS>

Una lista separata da virgole di campi che desideri vengano restituiti.

Campi

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

CampoDescrizione

boost_ads_list

Offre una panoramica di tutte le informazioni sulle inserzioni di Instagram associate ai contenuti multimediali organici. Include l'ID dell'inserzione relativo e lo stato di pubblicazione dell'inserzione. Disponibile solo per l'API Instagram Graph.

boost_eligibility_info

Il campo fornisce informazioni sull'idoneità di un contenuto multimediale di Instagram a essere messo in evidenza come inserzione e ulteriori dettagli in caso di non idoneità. Disponibile solo per l'API Instagram Graph.

caption
Pubblico

Didascalia. Esclude gli elementi secondari dell'album. Il simbolo @ è escluso, a meno che l'utente dell'app non sia autorizzato a eseguire attività equivalenti a quelle di un amministratore sulla Pagina Facebook collegata all'account Instagram utilizzato per creare la didascalia (solo API Instagram Graph).

comments_count
Pubblico

Numero dei commenti sul contenuto multimediale. Esclude i commenti ai contenuti multimediali degli elementi secondari dell'album e alle didascalie. Include le risposte ai commenti.

copyright_check_information.status

Restituisce gli oggetti status e matches_found

Oggetti statusDescrizione

status

  • 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

matches_found

Impostalo su uno dei seguenti:

  • false se il video non viola il diritto d'autore;
  • true se il video viola il diritto d'autore.

Se un video viola il diritto d'autore, copyright_matches viene restituito con un array di oggetti sul materiale protetto da diritto d'autore, quando la violazione si verifica nel video e le azioni intraprese per mitigare la violazione.

Oggetti copyright_matchesDescrizione

author

L'autore del video protetto da diritto d'autore

content_title

Il nome del video protetto da diritto d'autore

matched_segments

Un array di oggetti con le seguenti coppie chiave-valore: * duration_in_seconds: il numero di secondi in cui il contenuto viola il diritto d'autore * segment_type: AUDIO o VIDEO * start_time_in_seconds: impostato sull'ora di inizio del video

owner_copyright_policy

Gli oggetti restituiti includono:

  • name: il nome della normativa sul diritto d'autore dei detentori

  • actions: un array di oggetti action con le misure di mitigazione adottate definite nella normativa sul diritto d'autore dei detentori. Potrebbe includere misure di mitigazione diverse per varie località.

    • action: l'azione di mitigazione adottata con il video che viola il diritto d'autore. A seconda del Paese, le misure di mitigazione intraprese potrebbero essere diverse. Può essere uno dei seguenti valori:
      • BLOCK: il video è bloccato per il pubblico elencato nell'array geos
      • MUTE: il video è silenziato per il pubblico elencato nell'array geos

id
Pubblico

ID del contenuto multimediale.

is_comment_enabled

Indica se i commenti sono abilitati o disabilitati. Esclude gli elementi secondari dell'album.

is_shared_to_feed
Pubblico

Solo per Reels. Se true, il reel può essere visibile sia nella tab Feed sia nella tab Reels. Se false, indica che il reel è visibile solo nella tab Reels.

Nessuno dei due valori stabilisce se il reel è effettivamente visibile nella tab Reels, in quanto il reel potrebbe non soddisfare i requisiti di idoneità o non essere selezionato dal nostro algoritmo. Consulta le specifiche dei reel per i criteri di idoneità.

like_count

Numero di "Mi piace" sul contenuto multimediale, comprese le risposte ai commenti. Esclude i "Mi piace" sui contenuti multimediali degli elementi secondari dell'album e quelli su post promossi creati dai contenuti multimediali.


Se interrogato indirettamente attraverso un altro endpoint o l'espansione dei campi, il campo like_count viene omesso se il proprietario del contenuto multimediale ha nascosto i conteggi dei "Mi piace".

media_product_type
Pubblico

Piattaforma su cui viene pubblicato il contenuto multimediale. Può essere AD, FEED, STORY oppure REELS. Disponibile solo per l'API Instagram Graph.

media_type
Pubblico

Tipo di contenuto multimediale. Può essere CAROUSEL_ALBUM, IMAGE oppure VIDEO.

media_url
Pubblico

URL per il contenuto multimediale.

Il campo media_url viene omesso dalle risposte se il contenuto multimediale di IG contiene materiale protetto da diritto d'autore o è stato contrassegnato per una violazione del diritto d'autore. Gli esempi di materiale protetto da diritto d'autore possono includere l'audio sui reel.

owner
Pubblico

ID dell'utente Instagram che ha creato il contenuto multimediale. Restituito solo se l'utente dell'app che effettua la query ha creato anche il contenuto multimediale, altrimenti viene restituito il campo username.

permalink
Pubblico

URL permanente al contenuto multimediale.

shortcode
Pubblico

Codice breve al contenuto multimediale.

thumbnail_url
Pubblico

URL della miniatura del contenuto multimediale. Disponibile solo per i contenuti multimediali di tipo VIDEO.

timestamp
Pubblico

Data di creazione formattata ISO 8601 in UTC (il valore predefinito è UTC ±00:00).

username
Pubblico

Nome utente di chi ha creato il contenuto multimediale.

Segmenti

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

SegmentoDescrizione

children
Pubblico.

Rappresenta una raccolta di oggetti di tipo IG Media su un contenuto multimediale di Instagram in un album.

collaborators

Rappresenta una lista di utenti aggiunti come collaboratori su un oggetto Contenuto multimediale di IG. Disponibile solo per l'API Instagram Graph.

comments

Rappresenta una raccolta di commenti di IG su un oggetto Contenuto multimediale di IG.

insights

Rappresenta le metriche delle interazioni social su un oggetto Contenuto multimediale di IG. Disponibile solo per l'API Instagram Graph.

Esempio di cURL

Esempio di richiesta

curl -X GET \
  'https://graph.instagram.com/v21.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 IG.

Limitazioni

I contenuti multimediali di IG di tipo video in diretta non sono supportati.

Requirements

Instagram API with Instagram LoginInstagram API with Facebook Login

Access Tokens

  • Instagram 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_manage_comments
  • instagram_basic
  • instagram_manage_comments
  • pages_read_engagement
  • pages_show_list

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
  • business_management

Sintassi della richiesta

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

Parametri del percorso

SegnapostoValore

<API_VERSION>

Versione dell'API.

<IG_MEDIA_ID>

Obbligatorio. ID del contenuto multimediale di IG.

Parametri della stringa della query

ChiaveSegnapostoValore

access_token

<ACCESS_TOKEN>

Obbligatorio.Token d'accesso utente dell'utente dell'app.

comment_enabled

<BOOL>

Obbligatorio. Impostalo su true per abilitare i commenti o su false per disabilitarli.

Esempio di cURL

Esempio di richiesta

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

Risposta di esempio

{
  "success": true
}

Eliminazione

Questa operazione non è supportata.