Contenuto multimediale su un utente di IG

Rappresenta una raccolta di oggetti di tipo Contenuto multimediale di IG su un utente di IG.

Creazione

POST /{ig-user-id}/media

• Consente di creare un contenitore di IG di immagini, caroselli, storie o reel da usare nella procedura di pubblicazione dei post. Per la procedura completa di pubblicazione, consulta la guida sulla pubblicazione dei contenuti.

Limitazioni

Limitazioni generali

• I contenitori scadono dopo 24 ore.
• Se la Pagina collegata all'account Instagram per professionisti specifico richiede l'Autorizzazione alla pubblicazione sulle Pagine (PPA), questa dovrà essere completata; in caso contrario, la richiesta non andrà a buon fine.
• Se la Pagina collegata all'account Instagram per professionisti specifico richiede l'autenticazione a due fattori, anche l'utente di Facebook deve aver eseguito tale autenticazione; in caso contrario, la richiesta non andrà a buon fine.
• La pubblicazione su Instagram TV non è supportata.

Limitazioni sui reel

• I reel non compaiono nelle unità carosello degli album.
• Le impostazioni sulla privacy dell'account vengono rispettate al momento della pubblicazione. Ad esempio, se è stato abilitato Consenti remix, nei reel pubblicati il remix sarà abilitato al momento della pubblicazione, ma può essere disabilitato sui reel pubblicati manualmente tramite l'app Instagram.
• I tag musicali sono disponibili solo per audio originale.

Limitazioni delle storie

• Le storie scadono dopo 24 ore.
• Supportano URL video o URL Reels, ma non entrambi.
• La pubblicazione di adesivi (ovvero, link, sondaggio, luogo) non è supportata.

Requisiti

Specifiche delle immagini

• Formato: JPEG
• Dimensione del file: massimo 8 MB
• Proporzioni: devono essere comprese tra 4:5 e 1,91:1
• Larghezza minima: 320 (verrà aumentata al valore minimo se necessario)
• Larghezza massima: 1440 (verrà ridotta al valore massimo se necessario)
• Altezza: varia a seconda di larghezza e proporzioni
• Spazio colore: sRGB. Le immagini che utilizzano altri spazi colore saranno convertite in sRGB.

Specifiche reel

Di seguito sono indicate le specifiche per i reel:

• Contenitore: MOV o MP4 (MPEG-4 Part 14), nessun elenco di modifica, moov atom all'inizio del file
• Codec audio: AAC, frequenza di campionamento massima di 48 kHz, 1 o 2 canali (mono o stereo)
• Codec video: HEVC o H264, scansione progressiva, GOP chiuso, sottocampionamento cromatico 4:2:0
• Frequenza dei fotogrammi: 23-60 FPS
• Dimensioni immagine:

  • Colonne massime (pixel orizzontali): 1920
  • Le proporzioni richieste devono essere comprese tra 0,01:1 e 10:1, ma consigliamo proporzioni pari a 9:16 per evitare ritagli o spazi vuoti.
• Bitrate video: VBR, massimo 25 Mbps
• Bitrate audio: 128 kbps
• Durata: 15 minuti massimo e 3 secondi minimo
• Dimensione del file: massimo 1 GB

Di seguito sono indicate le specifiche per l'immagine di copertina di Reels:

• Formato: JPEG
• Dimensione del file: massimo 8 MB
• Spazio colore: sRGB. Le immagini che utilizzano altri spazi colore saranno convertite in sRGB.
• Proporzioni: consigliamo 9:16 per evitare ritagli o spazi vuoti. Se le proporzioni dell'immagine originale non sono 9:16, ritagliamo l'immagine e ne utilizziamo in 9:16 centrali come immagine di copertina del reel. Se condividi un reel nel tuo feed, ritagliamo l'immagine e usiamo il quadrato centrale 1:1 come immagine di copertina per il tuo post del feed.

Specifiche delle immagini delle storie

• Formato: JPEG
• Dimensione del file: massimo 8 MB.
• Proporzioni: consigliamo 9:16 per evitare ritagli o spazi vuoti.
• Spazio colore: sRGB. Le immagini che utilizzano altri spazi colore saranno convertite in sRGB

Specifiche dei video delle storie

• Contenitore: MOV o MP4 (MPEG-4 Part 14), nessun elenco di modifica, moov atom all'inizio del file.
• Codec audio: AAC, frequenza di campionamento massima di 48 kHz, 1 o 2 canali (mono o stereo)
• Codec video: HEVC o H264, scansione progressiva, GOP chiuso, sottocampionamento cromatico 4:2:0
• Frequenza dei fotogrammi: 23-60 FPS
• Dimensioni immagine:

  • Colonne massime (pixel orizzontali): 1920
  • Le proporzioni richieste devono essere comprese tra 0,1:1 e 10:1, ma consigliamo proporzioni pari a 9:16 per evitare ritagli o spazi vuoti
• Bitrate video: VBR, massimo 25 Mbps
• Bitrate audio: 128 kbps
• Durata: 60 secondi massimo e 3 secondi minimo
• Dimensione del file: massimo 100 MB

Sintassi della richiesta

Contenitori immagini

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?image_url={image-url}
  &is_carousel_item={is-carousel-item}
  &caption={caption}
  &location_id={location-id}
  &user_tags={user-tags}
  &product_tags={product-tags}
  &access_token={access-token}

Contenitori reel

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
?media_type=REELS
&video_url={reel-url}
&caption={caption}
&share_to_feed={share-to-feed}
&collaborators={collaborator-usernames}
&cover_url={cover-url}
&audio_name={audio-name}
&user_tags={user-tags}
&location_id={location-id}
&thumb_offset={thumb-offset}
&share_to_feed={share-to-feed}
&access_token={access-token}

Contenitori carosello

Solo contenitori carosello. Per creare contenitori di unità carosello, crea al loro posto contenitori di immagini o video (i reel non sono supportati). Consulta Post carosello per la procedura di pubblicazione completa.

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
?media_type=CAROUSEL
&caption={caption}
&share_to_feed={share-to-feed}
&collaborators={collaborator-usernames}
&location_id={location-id}
&product_tags={product-tags}
&children={children}
&access_token={access-token}

Contenitori delle storie con immagini

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?image_url={image-url}
  &media_type=STORIES
  &access_token={access-token}

Contenitori delle storie con video

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?video_url={video-url}
  &media_type=STORIES
  &access_token={access-token}

Parametri del percorso

Parametri della stringa della query

Risposta

Un oggetto in formato JSON contenente un ID del contenitore di IG che puoi usare per pubblicare il contenitore.

I caricamenti video sono asincroni, quindi la ricezione di un ID contenitore non garantisce che il caricamento sia andato a buon fine. Per verificare che il video sia stato caricato, richiedi il campo status_code sul contenitore di IG. Se il suo valore è FINISHED, il video è stato caricato correttamente.

{
  "id":"{ig-container-id}"
}

Esempio di richiesta

POST graph.facebook.com/17841400008460056/media ?image_url=https//www.example.com/images/bronzed-fonzes.jpg &caption=#BronzedFonzes! &collaborators= [‘username1’,’username2’] &user_tags=[ { username:'kevinhart4real', x: 0.5, y: 0.8 }, { username:'therock', x: 0.3, y: 0.2 } ] 

Esempio di risposta

{
  "id": "17889455560051444"
}

Lettura

GET /{ig-user-id}/media

Consente di ottenere tutti gli oggetti IG Media su un utente di IG.

Limitazioni

• Restituisce un massimo di 10 000 tra i più recenti contenuti multimediali creati.
• Contenuto multimediale di IG delle storie non supportato, usa invece l'endpoint GET /{ig-user-id}/stories.

Requisiti

Paginazione basata sul tempo

Questo endpoint supporta la paginazione basata sul tempo. Per definire un intervallo di tempo, includi i parametri della stringa di query since e until con indicazione temporale Unix o valori di dati strtotime.

Esempio di richiesta

GET graph.facebook.com/17841405822304914/media 

Esempio di risposta

{
  "data": [
    {
      "id": "17895695668004550"
    },
    {
      "id": "17899305451014820"
    },
    {
      "id": "17896450804038745"
    },
    {
      "id": "17881042411086627"
    },
    {
      "id": "17869102915168123"
    }
  ]
}

Aggiornamento

Questa operazione non è supportata.

Eliminazione

Questa operazione non è supportata.