Piattaforma Instagram

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.

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).
  • Per essere accessibili tramite l'API, i contenuti multimediali di Instagram TV devono essere condivisi su Instagram al momento della pubblicazione (Pubblica un'anteprima o Condividi l'anteprima nel feed abilitato).
  • I contenuti multimediali di IG di tipo video in diretta possono essere letti solo mentre vengono trasmessi.

Requisiti

TipoDescrizione

Token d'accesso

Utente.

Autorizzazioni

instagram_basic
pages_read_engagement
pages_show_list


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


ads_management
business_management

Sintassi della richiesta

GET https://graph.facebook.com/{api-version}/{ig-media-id}
  ?fields={fields}
  &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 dell'utente dell'utente dell'app.

fields

{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

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.

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.

ig_id
Pubblico

ID del contenuto multimediale di Instagram. Usato con l'API Instagram precedente, ora obsoleto. Usa invece id.

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 tramite un altro endpoint o espansione dei campi:


  • Chiamate versione 10.0 e precedenti: il valore è 0 se il titolare del contenuto multimediale ha nascosto il numero di "Mi piace".
  • Chiamate a partire dalla versione 11.0: il campo like_count è omesso se il titolare del contenuto multimediale ha nascosto il numero di "Mi piace".

media_product_type
Pubblico

Piattaforma su cui viene pubblicato il contenuto multimediale. Può essere AD, FEED, STORY oppure REELS.

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.

video_title
Pubblico

Dichiarato obsoleto. Omesso dalla risposta.

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 IG Media.

comments

Rappresenta una raccolta di commenti di IG su un oggetto IG Media.

insights

Rappresenta le metriche delle interazioni social su un oggetto IG Media.

Esempio di cURL

Richiesta

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

Risposta

{
  "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.

Requisiti

TipoDescrizione

Token d'accesso

Utente.

Autorizzazioni

instagram_basic
instagram_manage_comments
pages_show_list


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


ads_management
business_management

Sintassi della richiesta

POST https://graph.facebook.com/{api-version}/{ig-media-id}
  ?comment_enabled={comment-enabled}
  &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 dell'utente dell'utente dell'app.

comment_enabled

{comment-enabled}

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

Esempio di cURL

Richiesta

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

Risposta

{
  "success": true
}

Eliminazione

Questa operazione non è supportata.