Contenuti multimediali

On September 4, 2024, we announced the deprecation of the Instagram Basic Display API.

Starting December 4, 2024, all requests to the Instagram Basic Display API will return an error message. We recommend that you migrate your app to the Instagram API to avoid any disruption to your services.

Visit our News for Developers blog post to learn more.

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.

Chiave	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. Nota: quando si usano le emoji nelle didascalie, il formato di codifica dovrebbe essere UTF-8 e la lunghezza in caratteri potrebbe variare in funzione dell'emoji usata.
`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.