Contenuto multimediale

Rappresenta un'immagine, un video o un album.

Creazione

Questa operazione non è supportata.

Lettura

GET /{media-id}

Acquisisce campi e segmenti di un'immagine, un video o un album.

Requisiti

Tipo	Requisito
Token d'accesso	Utente Instagram
Autorizzazioni	`instagram_graph_user_media`

Sintassi della richiesta

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

Parametri della stringa della query

Includono i seguenti parametri della stringa della query per potenziare la richiesta.

Codice	Valore
`access_token` Obbligatorio Stringa	Il token d'accesso dell'utente Instagram 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

Puoi utilizzare il parametro della stringa della query fields per richiedere i seguenti campi di un contenuto multimediale.

Nome del campo	Descrizione
`caption`	Il testo della didascalia del contenuto multimediale. Non restituibile per un contenuto multimediale presente negli album.
`id`	L'ID del contenuto multimediale.
`is_shared_to_feed`	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à.
`media_type`	Il tipo di contenuto multimediale. Può essere `IMAGE`, `VIDEO` o `CAROUSEL_ALBUM`.
`media_url`	L'URL del contenuto multimediale.
`permalink`	L'URL permanente del contenuto multimediale. Viene omesso se il contenuto multimediale contiene materiale protetto da copyright o è stato segnalato per violazione del copyright.
`thumbnail_url`	L'URL dell'immagine di anteprima del contenuto multimediale. Disponibile solo per i contenuti multimediali di tipo `VIDEO`.
`timestamp`	La data di pubblicazione del contenuto multimediale in formato ISO 8601.
`username`	Il nome utente del titolare del contenuto multimediale.

Segmenti

Puoi richiedere i seguenti segmenti come parametri del percorso o utilizzando il parametro della stringa della query fields.

Segmento	Descrizione
`children`	Acquisisce una lista di contenuti multimediali presenti nell'album. Disponibile solo per i contenuti multimediali di tipo `CAROUSEL_ALBUM`.

Risposta

Un oggetto JSON contenente campi e segmenti predefiniti e obbligatori.

{
  "{field}":"{value}",
  ...
}

Esempio di cURL

Richiesta

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

Risposta

{
  "id": "17895695668004550",
  "media_type": "IMAGE",
  "media_url": "https://fb-s-b-a.akamaihd.net/...",
  "username": "jayposiris"
  "timestamp": "2017-08-31T18:10:00+0000"
}

Aggiornamento

Questa operazione non è supportata.

Eliminazione

Questa operazione non è supportata.