Piattaforma Instagram

Registro modifiche

Questo registro modifiche si riferisce alle modifiche apportate all'API Instagram Graph.

Registri modifiche correlati

12 settembre 2023

Deprecation of Media and User Insights

Applies to v18.0+. Will apply to all versions on December 11, 2023.

Duplicative and legacy Instagram insight metrics are being deprecated. Please see documentation for the endpoints and Instagram Insights for more information on which metrics to use in their place.

The following endpoints and metrics are affected:

  • GET /{ig-user-id}/insights
    • AUDIENCE_GENDER_AGE
    • AUDIENCE_LOCALE
    • AUDIENCE_COUNTRY
    • AUDIENCE_CITY
  • GET /{ig-media-id}/insights
    • CAROUSEL_ALBUM_IMPRESSIONS
    • CAROUSEL_ALBUM_REACH
    • CAROUSEL_ALBUM_ENGAGEMENT
    • CAROUSEL_ALBUM_SAVED
    • CAROUSEL_ALBUM_VIDEO_VIEWS
    • TAPS_FORWARD
    • TAPS_BACK
    • EXITS
    • ENGAGEMENT

Note: total_interactions, which is listed as an alternative for some of the deprecated metrics, is currently only available using version 18.0 and does not work with older versions. When querying older versions before Dec 11, 2023, please use the engagement metric.total_interactions, which is listed as an alternative for some of the deprecated metrics, is currently only available using version 18.0 and does not work with older versions. When querying older versions before Dec 11, 2023, please use the engagement metric.

9 novembre 2022

Webhooks per Instagram

Si applica a tutte le versioni.

ad_id e ad_title saranno restituiti nell'oggetto media dell'oggetto value del campo comments quando una persona commenta un post di Instagram in evidenza o un post pubblicitario di Instagram.

31 ottobre

Reels - Tag dei prodotti

Si applica a tutte le versioni.

L'API Tagging per i prodotti Instagram è ora disponibile per Reels. Puoi taggare un massimo di 30 prodotti quando pubblichi un reel.

28 giugno 2022

Reel

Si applica a tutte le versioni.

Ora i reel sono supportati. Per pubblicare un video come reel, imposta il parametro media_type su REELS quando crei un contenitore post multimediale singolo. Per conoscere i parametri utilizzabili con i reel e i requisiti per i video di reel, consulta il riferimento POST /ig-user/media endpoint.

27 giugno 2022

Documentazione API Instagram precedenti

Si applica a tutte le versioni.

La documentazione per gli sviluppatori sulle API Instagram precedenti è stata rimossa e ora reindirizza alla documentazione per gli sviluppatori della piattaforma Instagram.

20 giugno 2022

Tag dei prodotti

Si applica a tutte le versioni.

Adesso puoi creare e gestire i tag del prodotto di Shopping su Instagram sui contenuti multimediali pubblicati di un account business di Instagram. Per scoprire come fare, consulta la guida sui Tag dei prodotti.

27 maggio 2022

Varianti di prodotto

Si applica a tutte le versioni.

Per i partner nella beta dei tag dei prodotti, tutte le varianti di prodotto che corrispondono ai criteri di ricerca di una query verranno ora restituite quando si esegue la ricerca di prodotti in un catalogo.

15 marzo 2022

Post carosello

Si applica a tutte le versioni.

Ora puoi usare l'API Instagram per pubblicare post contenenti più immagini e video (post carosello). Per la procedura completa di pubblicazione, consulta la guida alla pubblicazione dei contenuti.

Se la tua app è già stata approvata per le autorizzazioni necessarie per la pubblicazione di contenuti, non deve essere sottoposta nuovamente all'analisi dell'app per poter utilizzare questa funzionalità.

9 novembre 2021

Video in diretta

Si applica a tutte le versioni.

Ora puoi usare l'API Instagram per fare in modo che contenuti multimediali di IG di tipo video in diretta vengano trasmessi dagli utenti della tua app, ottenere i commenti aggiunti a tali video e usare l'API Instagram Messaging per inviare risposte private (messaggi diretti) agli autori dei commenti. Per supportare questa funzionalità, sono state apportate le seguenti modifiche:

  • un nuovo segmento /ig-user/live_media GET può restituire un contenuto multimediale di IG di tipo video in diretta trasmesso da un utente dell'app al momento della richiesta;
  • il campo media su un commento di IG ora restituisce un oggetto contenente sia l'ID (id) sia la posizione di pubblicazione (media_product_type) del contenuto su cui è stato creato il commento;
  • un nuovo campo Webhooks per Instagram live_comments può inviare notifiche contenenti commenti in diretta pubblicati sui video in diretta degli utenti dell'app mentre vengono trasmessi.

Consulta la documentazione sulle risposte private dell'API Instagram Messaging per scoprire come inviare risposte private agli utenti che hanno commentato i contenuti multimediali di IG di tipo video in diretta degli utenti dell'app.

20 ottobre 2021

Commenti di IG

Si applica a tutte le versioni.

Sono stati aggiunti due nuovi campi a commenti di IG:

  • from: restituisce un oggetto contenente l'IGSID (id) e il nome utente (username) dell'autore del commento.
  • parent_id: restituisce l'ID del commento di IG principale, se questo commento è stato creato su un altro commento di IG (cioè si tratta di una risposta a un altro commento).

Webhooks per Instagram

Si applica a tutte le versioni.

Il campo di Webhooks per Instagram comments ora include le seguenti proprietà nell'oggetto del campo value:

  • from.id: IGSID dell'utente di Instagram che ha creato il commento.
  • from.username: nome utente dell'utente di Instagram che ha creato il commento.
  • media.id: ID del contenuto multimediale di IG su cui è stato creato il commento.
  • media.media_product_type: superficie (posizione di pubblicazione) del contenuto multimediale di IG su cui è stato creato il commento.
  • parent_id: ID del commento di IG principale, se il commento è stato creato su un altro commento di IG (cioè si tratta di una risposta a un altro commento).

5 ottobre 2021

Le seguenti modifiche si applicano ai video di Instagram TV creati il 5 ottobre 2021 o successivamente. I video di Instagram TV creati prima di questa data sono esenti da queste modifiche.

  • Il campomedia_product_type restituirà FEED anziché IGTV.
  • Il campovideo_title non verrà restituito.
  • I campi comments e mentions di Webhooks di Instagram ora sono supportati.

Il 3 gennaio 2022, le modifiche precedenti verranno applicate a tutte le versioni dell'API e a tutti i video di Instagram TV, indipendentemente dalla data di creazione del video. Significa che, a partire dal 3 gennaio 2022, le app che utilizzano versioni dell'API precedenti potranno eseguire query sui video di Instagram TV (il supporto per la lettura è stato introdotto nella versione 10.0 e limitato alla versione 10.0 e successive).

A partire dalla versione 14.0, il campo video_title non sarà più supportato e l'API genererà un errore se il campo viene richiesto.

8 giugno 2021

Numero di "Mi piace"

Si applica alla versione 11.0 e successive. Si applicherà a tutte le versioni a partire dal 7 settembre 2021.

Se si interroga indirettamente un contenuto multimediale di IG tramite un altro endpoint o espansione dei campi, il campo like_count sarà omesso dalle risposte API se il creatore del contenuto multimediale ha nascosto il numero di "Mi piace". L'esecuzione di una query direttamente sul contenuto multimediale di IG, che può essere eseguita solo dal suo creatore, restituirà il numero di "Mi piace" effettivo, anche se tale informazione è stata nascosta.


Paginazione basata sul tempo

Si applica alla versione 11.0 e successive.

Aggiunti i parametri since e until all'endpoint GET /{ig-user-id}/media per supportare la paginazione basata sul tempo.

26 maggio 2021

Se si effettua una query indirettamente su contenuti multimediali IG attraverso un altro endpoint, adesso il campo like_count restituisce 0 se l'utente dell'app non è il proprietario dei contenuti multimediali e il creatore dei contenuti multimediali ha nascosto il numero di "Mi piace" su questi ultimi. L'esecuzione di una query direttamente sui contenuti multimediali IG, che può essere eseguita solo dal creatore dei contenuti multimediali IG, restituirà il numero di "Mi piace" effettivo, anche se il creatore ha nascosto il numero di "Mi piace" sui contenuti multimediali.

4 maggio 2021

Abbiamo apportato un aggiornamento minore al modo in cui calcoliamo la metrica online_followers sugli utenti Instagram.

14 aprile 2021

Le interazioni con il contenuto multimediale delle Instagram Stories eseguite dagli utenti in Giappone non sono più incluse in alcuni calcoli delle metriche delle replies:

  • Per le storie create dagli utenti in Giappone, ora la metrica replies restituirà il valore 0.
  • Per le storie create da utenti al di fuori del Giappone, la metrica replies restituirà il numero di risposte, ma le risposte inviate dagli utenti in Giappone non saranno incluse in questo calcolo.

12 aprile 2021

Corretto un bug minore relativo alle metriche della copertura sul contenuto multimediale di IG delle storie.

9 aprile 2021

16 marzo 2021

I contenuti multimediali IGTV ora sono supportati nella versione 10.0 e successive. Ciò si applica a tutti gli endpoint ad eccezione di quelli utilizzati per la pubblicazione di contenuti e webhook. Per supportare questa modifica, sono stati aggiunti nuovi campi media_product_type e video_title al nodo IG Media. Per essere accessibili tramite l'API, i contenuti multimediali IGTV devono essere condivisi su Instagram al momento della pubblicazione (Pubblica un'anteprima o Condividi l'anteprima nel feed abilitato).

26 gennaio 2021

La versione beta di Content Publishing è terminata e ora tutti gli sviluppatori possono pubblicare contenuti multimediali sugli account Instagram per professionisti. Consulta la guida alla pubblicazione dei contenuti per i dettagli di utilizzo.

2 dicembre 2020

In conformità alla Direttiva e-Privacy dell'Unione europea, le interazioni con i contenuti multimediali di IG delle storie correlate ai messaggi eseguite dagli utenti nello Spazio economico europeo (SEE) dopo il 1° dicembre 2020 non saranno più incluse in alcuni calcoli delle metriche:

  • Per le storie create da utenti nel SEE, la metrica replies ora restituirà un valore pari a 0.
  • Per le storie create da utenti al di fuori del SEE, la metrica replies restituirà il numero di risposte, ma le risposte create dagli utenti nel SEE non saranno incluse in questo calcolo.

Questa modifica si applica a tutte le versioni.

10 novembre 2020

  • Insight sugli utenti Instagram: i valori follower_count ora sono meglio allineati ai rispettivi valori corrispondenti visualizzati nell'app Instagram. Inoltre, follower_count ora restituisce un massimo di 30 giorni di dati invece di 2 anni. Questa modifica si applica alla versione 9.0 e successive e, a partire dal 9 maggio 2021, a tutte le versioni.

5 maggio 2020

3 dicembre 2019

  • Insight: per allineare il comportamento dell'API con il comportamento dell'app Instagram, sono ora disponibili insight sugli utenti Instagram con 100 o più follower.

13 agosto 2019

  • Business Discovery: l'API Business Discovery ora può essere utilizzata per ottenere dati su altri account creator di Instagram.

22 maggio 2019

9 maggio 2019

  • Webhook: il campo story_insights ora richiede l'autorizzazione instagram_manage_insights invece di instagram_manage_comments.

31 ottobre 2018

  • API Hashtag Search: ora puoi cercare contenuti multimediali taggati con hashtag specifici utilizzando la nostra nuova API Hashtag Search. #spooky!

23 ottobre 2018

  • Segmento /{ig-media-id}/comments: le richieste GET effettuate utilizzando la versione API 3.1 o precedente visualizzeranno i risultati in ordine cronologico. Le richieste effettuate utilizzando la versione 3.2 e successive visualizzeranno i risultati in ordine cronologico inverso.

7 giugno 2018

  • Nodo /{ig-media-id}: ora puoi utilizzare l'espansione dei campi per ottenere il campo permalink sugli elementi multimediali.

1° maggio 2018

  • Verifica dell'azienda: per usare l'API Instagram Graph, tutte le app devono essere sottoposte alla verifica dell'azienda, che rientra nella procedura di analisi dell'app e adesso è obbligatoria per tutti gli endpoint dell'API Instagram Graph. Le app sottoposte ad analisi prima del 1° maggio 2018 devono essere analizzate nuovamente entro il 1° agosto 2018; in caso contrario, non sarà più possibile accedere all'API.

24 aprile 2018

  • Nodo /{ig-comment-id}:
    • Aggiunto un nuovo campo username.
    • Per le richieste GET, il campo user non sarà incluso nelle risposte a meno che l'utente che effettua la richiesta non sia il proprietario del commento; verrà invece restituito username per tutti i commentatori. Ciò riguarda anche le query sui commenti creati tramite altre API, come l'API Mentions.
  • Nodo /{ig-media-id}:
    • Aggiunto un nuovo campo username.
    • Per le richieste GET, il campo owner non sarà incluso nelle risposte a meno che l'utente che effettua la richiesta non sia il proprietario dell'elemento multimediale; verrà invece restituito username per tutti i commentatori. Ciò riguarda anche le query sugli elementi multimediali creati tramite altre API, come l'API Mentions.

23 aprile 2018

  • API Insights: gli insight ora includeranno l'attività pubblicitaria generata tramite l'API, le interfacce delle inserzioni di Facebook e la funzione Promuovi di Instagram. Questa modifica riguarda le seguenti metriche:

    • impressions
    • reach

13 marzo 2018

  • API Content Publishing: ora i partner beta possono utilizzare il segmento /{ig-user-id}/media per taggare i luoghi e gli utenti Instagram pubblici quando pubblicano le foto.

8 marzo 2018

  • Campi pubblici: ora il campo timestamp sul nodo /{ig-media-id} è un campo pubblico e può essere restituito tramite espansione dei campi.

22 febbraio 2018

  • Campi pubblici: i nodi /{ig-user-id}, /{ig-comment-id} e /{ig-media-id} restituiranno ora tutti i campi pubblici quando vi si accede attraverso un segmento tramite espansione dei campi. Consulta il documento di riferimento di ciascun nodo per vedere quali campi sono pubblici.

8 febbraio 2018

  • API Content Publishing: ora i partner beta possono includere hashtag quando pubblicano foto tramite il segmento /{ig-user-id}/media. #crazywildebeest FTW!