Cronologia revisioni

Questa pagina elenca le modifiche alle API e gli aggiornamenti della documentazione sia per l'API di reporting di YouTube sia per l'API YouTube Analytics. Entrambe le API consentono agli sviluppatori di accedere ai dati di YouTube Analytics, anche se in modi diversi. Iscriviti a questo log delle modifiche. Iscriviti

13 settembre 2026

L'API di reporting di YouTube ora supporta la versione 1.1 del report sui riferimenti settimanali per i proprietari dei contenuti (content_owner_active_references_a2).

La versione 1.1 introduce le seguenti modifiche:

  • Aggiunge il campo status_detail, che fornisce ulteriori dettagli o motivi relativi allo stato del file di riferimento.
  • Aggiorna il campo asset_owners in modo che utilizzi i nomi visualizzati dei proprietari dei contenuti o gli ID esterni anziché i codici partner.

La versione precedente del report, Versione 1.0 (content_owner_active_references_a1), continua a essere disponibile.

9 settembre 2026

La documentazione dell'API YouTube Analytics e dell'API di reporting di YouTube è stata aggiornata con le seguenti aggiunte e chiarimenti:

  • SLA su aggiornamento e latenza dei dati:è stata aggiunta una sezione dedicata al modello di dati che spiega il ritardo di elaborazione dei dati di 48-72 ore, il troncamento della data di fine all'ultimo giorno completamente elaborato e consiglia il metodo videos.list dell'API YouTube Data per le statistiche sui video in tempo reale.

  • Metriche monetarie nei report sui canali:è stata aggiornata la documentazione di autorizzazione dei report sui canali per chiarire che le metriche relative alle entrate stimate e al rendimento degli annunci sono supportate per i report sui canali autorizzati con l'ambito https://www.googleapis.com/auth/yt-analytics-monetary.readonly quando il canale è membro del Programma partner di YouTube (YPP) e che i canali non monetizzati restituiscono HTTP 403 Forbidden.

  • Vincoli delle query e compatibilità dei parametri:è stata aggiunta una nota consultiva alla sezione Informazioni sulle tabelle dei report per chiarire che le combinazioni di dimensioni, metriche e filtri non valide o reciprocamente esclusive restituiscono HTTP 400 badRequest ("The query is not supported.").

  • Valori delle dimensioni vuoti nei report collettivi:sono state aggiornate le caratteristiche dei report dell'API YouTube Reporting per spiegare che le colonne delle dimensioni come video_id o channel_id contengono stringhe vuote per preservare i conteggi delle metriche aggregate per le risorse eliminate e per rappresentare gli eventi a livello di canale.

27 agosto 2026

YouTube allineerà il conteggio delle visualizzazioni pubbliche per tutti i formati video: video nel formato lungo, live e Short. YouTube conteggerà le visualizzazioni pubbliche nel momento in cui inizia la riproduzione di un video.

L'idoneità alla monetizzazione e la maggior parte delle metriche sul rendimento principali non sono interessate, in quanto rimangono ancorate alle metriche sul coinvolgimento. Gli utili dei creator continueranno a essere basati sulle Visualizzazioni di Short "engaged" e sulle Ore di visualizzazione "engaged", visibili in YouTube Analytics > Modalità avanzata.

Non sono state apportate modifiche ai requisiti di idoneità per il Programma partner di YouTube. I requisiti di accesso al Programma partner di YouTube saranno ora indicati come "visualizzazioni di Short idonee" e "ore di visualizzazione idonee" (in precedenza "visualizzazioni pubbliche di Short valide" e "ore di visualizzazione pubblica valide").

Per saperne di più, consulta l'articolo Comprendere il rendimento dei contenuti di YouTube.

Metrica Stato Trigger Utilizzata per
Visualizza Data/ora aggiornamento Il video viene riprodotto dal primo fotogramma (include riproduzione automatica, passaggio del puntatore e clic/tocco per la riproduzione). Conteggi delle visualizzazioni pubbliche standard.
Visualizzazione "engaged" Invariato La riproduzione continua oltre il primo fotogramma oppure l'utente fa clic/tocca per riprodurre. Monetizzazione tramite il Programma partner di YouTube, maggior parte delle analisi di base (percentuale di clic, durata media della visualizzazione) e report sul coinvolgimento.
Impressione della miniatura Invariato La miniatura viene visualizzata senza interazione o riproduzione automatica. Misura l'esposizione e il packaging a livello di feed.

Aggiornamenti della documentazione dell'API:è stata aggiornata la definizione della metrica engagedViews nella documentazione delle metriche dell'API YouTube Analytics e delle metriche dell'API YouTube Reporting.

25 giugno 2026

La documentazione dell'API YouTube Analytics (query mirate) è stata aggiornata per rimuovere il report Attività utente per città per i proprietari dei contenuti. Questo report non è supportato per i proprietari dei contenuti; le query dei proprietari dei contenuti sull'attività degli utenti per città restituiranno risultati vuoti.

9 marzo 2026

Le dimensioni ageGroup (API YouTube Analytics) e age_group (API di reporting di YouTube) ora includono gli utenti che YouTube stima abbiano meno di 18 anni.

15 gennaio 2026

L'API YouTube Reporting ora supporta i report sulla copertura per i canali e i proprietari dei contenuti. I report sulla copertura forniscono statistiche sulle impressioni delle miniature dei video e sulle percentuali di clic.

  • I report channel_reach_basic_a1 e channel_reach_combined_a1 sono disponibili per i canali.
  • I report content_owner_reach_basic_a1 e content_owner_reach_combined_a1 sono disponibili per i proprietari dei contenuti.

Questi report supportano le seguenti nuove metriche:

  • video_thumbnail_impressions
  • video_thumbnail_impressions_ctr

22 settembre 2025

Il ritiro precedentemente annunciato dei report è stato posticipato dal 30 settembre 2025 al 31 ottobre 2025. Le versioni precedenti dei report aggiornati per le modifiche al conteggio delle visualizzazioni di Shorts continueranno a essere disponibili fino ad allora, ad eccezione del report Rivendicazioni v1.0 (content_owner_active_claims_a1) e del report Rivendicazioni v1.1 (content_owner_active_claims_a2), che verranno comunque ritirati il 30 settembre.

24 giugno 2025

Come annunciato il 26 marzo 2025, l'API Bulk Reports verrà aggiornata nell'ambito della nuova modifica del conteggio delle visualizzazioni di Shorts. Sono state apportate le seguenti modifiche:

  • Sono state create nuove versioni dei report per ogni report che include le visualizzazioni, ovvero la maggior parte dei report. La versione di ogni report interessato è aumentata di uno, ad esempio dalla versione a2 alla versione a3.
  • Per gli Short, le visualizzazioni ora tengono conto del numero di volte in cui uno Short viene riprodotto o rivisto. Per i video, non sono previste modifiche.
  • I report aggiornati includeranno una nuova colonna, engaged_views, che rifletterà la precedente metodologia di conteggio delle visualizzazioni.

Queste modifiche entreranno in vigore il 30 giugno 2025 per l'API Bulk Reports. Assicurati di modificare l'elaborazione dei report di conseguenza.

Le versioni precedenti dei report saranno disponibili fino al 30 settembre 2025. Dopo il 30 settembre 2025, le versioni precedenti verranno ritirate. Assicurati di eseguire la migrazione alle versioni più recenti.

Infine, assicurati di seguire le best practice durante l'elaborazione dei report per evitare che le modifiche future ai report interrompano le pipeline di elaborazione.

Le tabelle seguenti mostrano le nuove versioni dei report per ogni tipo di report:

Report sui dati collettivi per YouTube Analytics

Report sui canali - Report sui video
Nome report Versione precedente Ultima versione
Attività utente channel_basic_a2 channel_basic_a3
Attività utente per provincia channel_province_a2 channel_province_a3
Luoghi di visualizzazione channel_playback_location_a2 channel_playback_location_a3
Sorgenti di traffico channel_traffic_source_a2 channel_traffic_source_a3
Tipo di dispositivo e sistema operativo channel_device_os_a2 channel_device_os_a3
Sottotitoli channel_subtitles_a2 channel_subtitles_a3
Combinati channel_combined_a2 channel_combined_a3
Report sui canali - Report sulle playlist
Nome report Versione precedente Ultima versione
Attività utente playlist_basic_a1 playlist_basic_a2
Attività utente per provincia playlist_province_a1 playlist_province_a2
Luoghi di visualizzazione playlist_playback_location_a1 playlist_playback_location_a2
Sorgenti di traffico playlist_traffic_source_a1 playlist_traffic_source_a2
Tipo di dispositivo e sistema operativo playlist_device_os_a1 playlist_device_os_a2
Combinati playlist_combined_a1 playlist_combined_a2
Report sui proprietari dei contenuti - Report sui video
Nome report Versione precedente Ultima versione
Attività utente content_owner_basic_a3 content_owner_basic_a4
Attività utente per provincia content_owner_province_a2 content_owner_province_a3
Luoghi di visualizzazione content_owner_playback_location_a2 content_owner_playback_location_a3
Sorgenti di traffico content_owner_traffic_source_a2 content_owner_traffic_source_a3
Tipo di dispositivo e sistema operativo content_owner_device_os_a2 content_owner_device_os_a3
Sottotitoli content_owner_subtitles_a2 content_owner_subtitles_a3
Combinati content_owner_combined_a2 content_owner_combined_a3
Report sui proprietari dei contenuti - Report sulle playlist
Nome report Versione precedente Ultima versione
Attività utente content_owner_playlist_basic_a1 content_owner_playlist_basic_a2
Attività utente per provincia content_owner_playlist_province_a1 content_owner_playlist_province_a2
Luoghi di visualizzazione content_owner_playlist_playback_location_a1 content_owner_playlist_playback_location_a2
Sorgenti di traffico content_owner_playlist_traffic_source_a1 content_owner_playlist_traffic_source_a2
Tipo di dispositivo e sistema operativo content_owner_playlist_device_os_a1 content_owner_playlist_device_os_a2
Combinati content_owner_playlist_combined_a1 content_owner_playlist_combined_a2
Report sui proprietari dei contenuti - Report sugli asset
Nome report Versione precedente Ultima versione
Attività utente content_owner_asset_basic_a2 content_owner_asset_basic_a3
Attività utente per provincia content_owner_asset_province_a2 content_owner_asset_province_a3
Luoghi di riproduzione video content_owner_asset_playback_location_a2 content_owner_asset_playback_location_a3
Sorgenti di traffico content_owner_asset_traffic_source_a2 content_owner_asset_traffic_source_a3
Tipo di dispositivo e sistema operativo content_owner_asset_device_os_a2 content_owner_asset_device_os_a3
Combinati content_owner_asset_combined_a2 content_owner_asset_combined_a3

Report gestiti dal sistema - Finanziari (non musicali)

Report sui proprietari dei contenuti - Report Shorts (non musicali)
Nome report Versione precedente Ultima versione
Riepilogo delle entrate pubblicitarie globali content_owner_shorts_global_ad_revenue_summary_a1 content_owner_shorts_global_ad_revenue_summary_a2
Riepilogo giornaliero delle entrate pubblicitarie content_owner_shorts_day_ad_revenue_summary_a1 content_owner_shorts_day_ad_revenue_summary_a2
Riepilogo delle entrate pubblicitarie per paese content_owner_shorts_country_ad_revenue_summary_a1 content_owner_shorts_country_ad_revenue_summary_a2
Riepilogo delle entrate pubblicitarie content_owner_shorts_ad_revenue_summary_a1 content_owner_shorts_ad_revenue_summary_a2

Report gestiti dal sistema - Non finanziari

Report sui proprietari dei contenuti - Report Rivendicazioni
Nome report Versione precedente Ultima versione
Reclami attivi content_owner_active_claims_a2 content_owner_active_claims_a3
Report sui proprietari dei contenuti - Report sui metadati dei video
Nome report Versione precedente Ultima versione
Metadati video content_owner_video_metadata_a3 content_owner_video_metadata_a4
Report sui proprietari dei contenuti - Report sugli asset
Nome report Versione precedente Ultima versione
Asset content_owner_asset_a2 content_owner_asset_a3
Conflitti delle risorse content_owner_asset_conflict_a2 content_owner_asset_conflict_a3

24 aprile 2025

Come annunciato il 26 marzo 2025, l'API Targeted Queries verrà aggiornata nell'ambito della nuova modifica al conteggio delle visualizzazioni di Shorts:

  • Per gli Short, views ora tiene conto del numero di volte in cui uno Short viene riprodotto o rivisto.
  • Una nuova metrica, engagedViews, rifletterà la metodologia di conteggio delle visualizzazioni precedente. engagedViews sarà disponibile in tutti i report insieme a views.

Queste modifiche entreranno in vigore il 30 aprile 2025 per l'API Targeted Queries. Assicurati di modificare le query di conseguenza.

Controlla questa cronologia delle revisioni per scoprire quali modifiche e quando verranno apportate all'API Bulk Reports.

22 aprile 2025

Come annunciato il 7 aprile 2024, la dimensione isCurated è stata ritirata per i report sui canali e sulle playlist dei proprietari dei contenuti. A partire dal 31 dicembre 2024, la dimensione non è più supportata. La dimensione è stata rimossa dai report e dalla documentazione.

26 marzo 2025

Questo aggiornamento include la seguente modifica relativa alle API YouTube Analytics e YouTube Reporting:

A partire dal 31 marzo 2025, YouTube modificherà il modo in cui vengono conteggiate le visualizzazioni degli Short. In passato, per gli Short, una visualizzazione veniva conteggiata dopo che uno Short era stato riprodotto per un certo numero di secondi. Ora, le visualizzazioni terranno conto del numero di volte in cui uno Short viene riprodotto o rivisto, senza alcun requisito di tempo di visualizzazione minimo. Scopri di più

Le API YouTube Analytics (query mirate) e Reporting (report collettivi) verranno aggiornate con le seguenti modifiche:

  • Per gli Short, views conta il numero di volte in cui uno Short viene riprodotto o rivisto.
  • Verrà resa disponibile una nuova metrica, engagedViews, che rifletterà la precedente metodologia di conteggio delle visualizzazioni.
  • Se possiedi un canale o sei autorizzato ad accedere ai dati di un canale, potrai eseguire query sia sulle visualizzazioni aggiornate che sulle visualizzazioni "engaged".

Le query mirate verranno aggiornate entro il 30 aprile, mentre i report collettivi verranno aggiornati entro il 30 giugno. Fino ad allora, le visualizzazioni si baseranno sulla vecchia metodologia. Le visualizzazioni degli Short e del canale non corrisponderanno a quelle di Analytics in Studio.

Inoltre, il ritiro precedentemente annunciato del report Richieste giornaliere (versione 1.0) è stato posticipato.

Controlla la cronologia delle revisioni per sapere quando vengono apportate modifiche alle API.

3 marzo 2025

Questo aggiornamento include la seguente modifica relativa all'API YouTube Reporting:

Nota:questo è un annuncio di ritiro.

Il report Rivendicazioni giornaliere (versione 1.0) è stato ritirato per i partner. Non sarà più supportato a partire dal 30 aprile 2025. La definizione del report è stata aggiornata di conseguenza. Utilizza invece l'ultimo report Richieste giornaliere.

15 novembre 2024

Nota:la seguente modifica è in vigore dal 18 novembre 2024.

La documentazione dell'API YouTube Analytics (query mirate) è stata aggiornata per indicare che per i report sull'origine del traffico, il metodo reports.query dell'API ora restituisce un errore se il prodotto di # of queried videos X # of days in date range supera 50.000. Ad esempio, una query che recupera i dati per 500 ID video può richiedere dati per un massimo di 100 giorni.

Questa modifica influisce sui report per canali e proprietari dei contenuti.

Per ridurre il numero di righe restituite da una richiesta, dividi la query in più query che specificano un numero inferiore di video o impostano intervalli di date più brevi. In genere, i report collettivi sono consigliati per set di dati di grandi dimensioni.

6 maggio 2024

L'API YouTube Analytics (query mirate) supporta tre nuovi report per i canali:

Inoltre, il report Fidelizzazione del pubblico è stato migliorato per supportare tre nuove metriche:

7 aprile 2024

L'API YouTube Analytics (query mirate) presenta diversi aggiornamenti relativi ai report sulle playlist dei proprietari dei contenuti. Gli aggiornamenti sono gli stessi di quelli relativi ai report sulle playlist dei canali, annunciati il 19 gennaio 2024.

La seguente voce della cronologia delle revisioni fornisce quasi le stesse informazioni della voce del 19 gennaio 2024. Tieni presente, tuttavia, che i report sulle playlist dei proprietari dei contenuti supporteranno la dimensione isCurated fino al 31 dicembre 2024, mentre la dimensione sarà supportata per i report sulle playlist dei canali fino al 30 giugno 2024.

  • Nota:questo è un annuncio di ritiro.

    La dimensione isCurated è stata ritirata per i report sulle playlist dei proprietari dei contenuti. Non sarà più supportato a partire dal 31 dicembre 2024. La definizione di questa dimensione è stata aggiornata di conseguenza.

    Per preservare la compatibilità con le versioni precedenti quando rimuovi la dimensione isCurated, devi anche aggiornare il codice per recuperare la metrica playlistViews anziché la metrica views solo per i report sulle playlist. Poiché la metrica views è ancora supportata per i report sulle playlist, anche se con un significato diverso, l'API restituirà comunque i dati se non aggiorni il nome della metrica. Naturalmente, puoi modificare la tua applicazione per recuperare e visualizzare sia views che playlistViews.

    Oltre alla dimensione isCurated, la seguente funzionalità dell'API non è più supportata nei nuovi report:

    • I filtri per località, come continent e subcontinent, non sono supportati per i nuovi report sulle playlist dei canali.
    • Le metriche redViews e estimatedRedMinutesWatched non sono più supportate per i nuovi report sulle playlist dei canali. Queste metriche non sono mai state disponibili in YouTube Studio, pertanto questa modifica allinea la funzionalità dell'API a quella disponibile nell'applicazione Studio.
    • Le dimensioni subscribedStatus e youtubeProduct non sono più supportate come filtri per i report sulle playlist del canale. Questi filtri non sono disponibili in YouTube Studio, pertanto questa modifica allinea la funzionalità dell'API a quella disponibile nell'applicazione Studio.

  • La sezione Report sulle playlist della documentazione sui report dei proprietari dei contenuti è stata aggiornata per spiegare in modo più approfondito i tipi di metriche supportate per i report sulle playlist:

    • Le metriche aggregate dei video forniscono metriche relative alle impressioni e all'attività degli utenti aggregate per tutti i video nelle playlist del proprietario dei contenuti che sono di sua proprietà. Le metriche video aggregate sono supportate solo per le richieste API che non utilizzano la dimensione isCurated.
    • Le metriche nella playlist riflettono l'attività e il coinvolgimento degli utenti nel contesto della pagina della playlist. Queste metriche includono anche le visualizzazioni di video non di proprietà nella playlist, ma solo quando queste visualizzazioni si sono verificate nel contesto della playlist.
    • La sezione Metriche delle playlist supportate identifica le metriche video aggregate e le metriche in-playlist supportate per i report sulle playlist.

  • Per i report sulle playlist per i proprietari dei contenuti sono supportate le seguenti nuove metriche nella playlist. Tieni presente che queste metriche sono supportate solo se la richiesta API per recuperare i report non utilizza la dimensione isCurated. Consulta la documentazione sulle metriche per le definizioni di ciascuna metrica:

  • Il comportamento della metrica views ora dipende dal fatto che la richiesta API che ha recuperato il report sulla playlist abbia utilizzato la dimensione isCurated:

    • Quando una richiesta include la dimensione isCurated, la metrica views è una metrica in-playlist che indica il numero di volte in cui i video sono stati visualizzati nel contesto delle playlist del proprietario dei contenuti.
    • Quando una richiesta non include la dimensione isCurated, la metrica views è una metrica video aggregata che specifica il numero totale di volte in cui sono stati visualizzati i video nelle playlist del proprietario dei contenuti, indipendentemente dal fatto che queste visualizzazioni siano avvenute nel contesto della playlist. Il totale aggregato include solo le visualizzazioni dei video di proprietà del proprietario dei contenuti associato al canale proprietario della playlist.

      In questi report, che non utilizzano la dimensione isCurated, la metrica playlistViews indica il numero di volte in cui i video sono stati visualizzati nel contesto della playlist. Questa metrica conteggia le visualizzazioni di tutti i video della playlist, indipendentemente dal canale di proprietà.

  • Per ogni report sulle playlist, la documentazione relativa ai report dei proprietari dei contenuti ora include tabelle che mostrano le metriche supportate per il report a seconda che la richiesta API includa o meno la dimensione isCurated. Per un esempio, consulta la sezione che definisce i report sulle playlist basati sul tempo.

19 gennaio 2024

L'API YouTube Analytics (query mirate) presenta diversi aggiornamenti relativi ai report sulle playlist dei canali. Gli aggiornamenti includono una dimensione obsoleta e diverse metriche nuove e aggiornate:

  • Nota:questo è un annuncio di ritiro.

    La dimensione isCurated è stata ritirata per i report sui canali. Non sarà più supportato a partire dal 30 giugno 2024. La definizione di questa dimensione è stata aggiornata di conseguenza.

    Per preservare la compatibilità con le versioni precedenti quando rimuovi la dimensione isCurated, devi anche aggiornare il codice per recuperare la metrica playlistViews anziché la metrica views solo per i report sulle playlist. Poiché la metrica views è ancora supportata per i report sulle playlist, anche se con un significato diverso, l'API restituirà comunque i dati se non aggiorni il nome della metrica. Naturalmente, puoi modificare la tua applicazione per recuperare e visualizzare sia views che playlistViews.

    Oltre alla dimensione isCurated, la seguente funzionalità dell'API non è più supportata nei nuovi report:

    • I filtri per località, come continent e subcontinent, non sono supportati per i nuovi report sulle playlist dei canali.
    • Le metriche redViews e estimatedRedMinutesWatched non sono più supportate per i nuovi report sulle playlist dei canali. Queste metriche non sono mai state disponibili in YouTube Studio, pertanto questa modifica allinea la funzionalità dell'API a quella disponibile nell'applicazione Studio.
    • Le dimensioni subscribedStatus e youtubeProduct non sono più supportate come filtri per i report sulle playlist del canale. Questi filtri non sono disponibili in YouTube Studio, pertanto questa modifica allinea la funzionalità dell'API a quella disponibile nell'applicazione Studio.

  • La sezione Report sulle playlist della documentazione sui report del canale è stata aggiornata per spiegare in modo più approfondito i tipi di metriche supportate per i report sulle playlist:

    • Le metriche aggregate dei video forniscono metriche sull'attività utente e sulle impressioni aggregate per tutti i video nelle playlist del canale di proprietà del canale stesso. Le metriche video aggregate sono supportate solo per le richieste API che non utilizzano la dimensione isCurated.
    • Le metriche nella playlist riflettono l'attività e il coinvolgimento degli utenti nel contesto della pagina della playlist. Queste metriche includono anche le visualizzazioni di video non di proprietà nella playlist, ma solo quando queste visualizzazioni si sono verificate nel contesto della playlist.
    • La sezione Metriche delle playlist supportate identifica le metriche video aggregate e le metriche in-playlist supportate per i report sulle playlist.

  • Per i report sulle playlist dei canali sono supportate le seguenti nuove metriche all'interno della playlist. Queste metriche non sono ancora supportate per i report dei proprietari dei contenuti. Tieni presente che queste metriche sono supportate solo se la richiesta API per recuperare i report non utilizza la dimensione isCurated. Consulta la documentazione sulle metriche per le definizioni di ciascuna metrica:

  • Il comportamento della metrica views ora dipende dal fatto che la richiesta API che ha recuperato il report sulla playlist abbia utilizzato la dimensione isCurated:

    • Quando una richiesta include la dimensione isCurated, la metrica views è una metrica in-playlist che indica il numero di volte in cui i video sono stati visualizzati nel contesto delle playlist del canale.
    • Quando una richiesta non include la dimensione isCurated, la metrica views è una metrica video aggregata che specifica il numero totale di volte in cui i video nelle playlist del canale sono stati visualizzati, indipendentemente dal fatto che le visualizzazioni siano avvenute nel contesto della playlist. Il totale aggregato include solo le visualizzazioni dei video di proprietà del canale che possiede la playlist.

      In questi report, che non utilizzano la dimensione isCurated, la metrica playlistViews indica il numero di volte in cui i video sono stati visualizzati nel contesto della playlist. Questa metrica conteggia le visualizzazioni di tutti i video della playlist, indipendentemente dal canale di proprietà.

  • Per ogni report sulle playlist, la documentazione dei report sui canali ora include tabelle che mostrano le metriche supportate per quel report a seconda che la richiesta API includa o meno la dimensione isCurated. Per un esempio, consulta la sezione che definisce i report sulle playlist basati sul tempo.

4 dicembre 2023

L'API YouTube Analytics (query mirate) è stata aggiornata per unire due insightTrafficSourceType valori della dimensione. In precedenza, la dimensione distingueva tra i video riprodotti nell'ambito di una playlist (PLAYLIST) e le visualizzazioni provenienti da una pagina che elenca tutti i video di una playlist (YT_PLAYLIST_PAGE). In futuro, entrambi i tipi di visualizzazioni verranno associati al valore della dimensione PLAYLIST.

15 dicembre 2022

L'API YouTube Analytics (query mirate) supporta due nuove dimensioni e un nuovo report:

  • Un nuovo report mostra l'attività utente per città. Questo report è disponibile per canali e proprietari dei contenuti. Questo report contiene la nuova dimensione city, che identifica la stima di YouTube della città in cui si è svolta l'attività utente.

  • La nuova dimensione creatorContentType identifica il tipo di contenuti di YouTube associati alle metriche dell'attività utente nella riga di dati. I valori supportati sono LIVE_STREAM, SHORTS, STORY e VIDEO_ON_DEMAND.

    La dimensione creatorContentType è supportata come dimensione facoltativa per tutti i report sui video dei canali e dei proprietari dei contenuti.

  • La guida alle richieste di esempio dell'API YouTube Analytics ora include esempi per entrambe le nuove dimensioni.

  • I riferimenti alle dimensioni 7DayTotals e 30DayTotals sono stati rimossi dalla documentazione. Il ritiro di queste dimensioni è stato annunciato a ottobre 2019.

26 agosto 2022

L'API YouTube Analytics (query mirate) e l'API YouTube Reporting (report collettivi) supportano entrambe un nuovo valore di dettaglio della sorgente di traffico:

  • Nell'API YouTube Analytics (query mirate), se il valore della dimensione insightTrafficSourceType è SUBSCRIBER, il valore insightTrafficSourceDetail può essere impostato su podcasts, il che indica che il traffico è stato indirizzato dalla pagina di destinazione dei podcast.
  • Nell'API YouTube Reporting (report collettivi), se il valore della dimensione traffic_source_type è 3, il valore di traffic_source_detail può essere impostato su podcasts, il che indica che il traffico è stato indirizzato dalla pagina di destinazione dei podcast.

11 febbraio 2022

Il set di valori validi per la dimensione gender cambierà a partire dall'11 agosto 2022. Potrebbe trattarsi di una modifica non compatibile con le versioni precedenti nell'implementazione dell'API. In linea con la sezione Modifiche incompatibili con le versioni precedenti dei Termini di servizio delle API di YouTube, questa modifica viene annunciata sei mesi prima della sua entrata in vigore. Aggiorna l'implementazione dell'API prima dell'11 agosto 2022 per garantire una transizione senza problemi al nuovo insieme di valori.

Le modifiche specifiche apportate sono:

  • Nell'API YouTube Analytics (query mirate), la dimensione gender attualmente supporta due valori: female e male. A partire dall'11 agosto 2022, questa dimensione supporterà tre valori: female, male e user_specified.
  • Nell'API YouTube Reporting (report collettivi), la dimensione gender attualmente supporta tre valori: FEMALE, MALE e GENDER_OTHER. A partire dall'11 agosto 2022, l'insieme dei valori supportati cambierà in FEMALE, MALE e USER_SPECIFIED.

9 febbraio 2022

A partire dal 13 dicembre 2021, due metriche sono state aggiornate per escludere il traffico dei clip in loop. Questa modifica interessa sia l'API YouTube Analytics (query mirate) sia l'API YouTube Reporting (report collettivi).

2 febbraio 2022

Questa API YouTube Reporting (report collettivi) supporta un nuovo valore della dimensione sorgente di traffico che indica che le visualizzazioni hanno avuto origine da reindirizzamenti live:

  • Nell'API YouTube Reporting (report collettivi), la dimensione traffic_source_type supporta il valore 28.

Per questo tipo di origine di traffico, la dimensione traffic_source_detail specifica l'ID canale da cui è stato indirizzato lo spettatore.

23 settembre 2020

L'API YouTube Analytics (query mirate) e l'API di reporting di YouTube (report collettivi) supportano entrambe un nuovo valore della dimensione sorgente di traffico che indica che lo spettatore è stato indirizzato scorrendo verticalmente nell'esperienza di visualizzazione di YouTube Shorts:

  • Nell'API YouTube Analytics (query mirate), la dimensione insightTrafficSourceType supporta il valore SHORTS.
  • Nell'API YouTube Reporting (report collettivi), la dimensione traffic_source_type supporta il valore 24.

La dimensione Dettaglio sorgente di traffico — insightTrafficSourceDetail nell'API YouTube Analytics o traffic_source_detail nell'API YouTube Reporting — non viene compilata per questo nuovo tipo di sorgente di traffico.

20 luglio 2020

Questo aggiornamento riguarda due modifiche che interessano l'API YouTube Analytics (query mirate):

  • Le dimensioni massime di un gruppo di report di YouTube Analytics sono aumentate da 200 a 500 entità.
  • Il parametro reports.query del metodo filters identifica un elenco di filtri da applicare durante il recupero dei dati di YouTube Analytics. Il parametro supporta la possibilità di specificare più valori per i filtri video, playlist, e channel e il numero massimo di ID che possono essere specificati per questi filtri è aumentato da 200 a 500 ID.

13 febbraio 2020

Questo aggiornamento include le seguenti modifiche relative all'API YouTube Analytics (query mirate) e all'API di reporting di YouTube (report collettivi). Per saperne di più su queste modifiche, consulta il Centro assistenza YouTube.

In entrambe le API, il set di possibili valori dei dettagli dell'origine di traffico per le notifiche sta cambiando. Nelle query mirate, le notifiche vengono segnalate come insightTrafficSourceType=NOTIFICATION. Nei report collettivi, le notifiche vengono segnalate come traffic_source_type=17.

I nuovi valori dividono le notifiche relative ai video caricati e ai live streaming, precedentemente segnalati come uploaded, in due categorie:

  • uploaded_push - Visualizzazioni generate dalle notifiche push inviate agli iscritti al momento del caricamento di un video
  • uploaded_other - Visualizzazioni generate da notifiche non push, ad esempio notifiche via email o nella posta in arrivo, inviate agli iscritti al momento del caricamento di un video.

Questi valori vengono restituiti per l'intervallo di tempo a partire dal 13 gennaio 2020.

Inoltre, ti ricordiamo che questi valori non rappresentano le notifiche in sé, ma le sorgenti di traffico che hanno generato determinate visualizzazioni di YouTube. Ad esempio, se una riga del report indica views=3, traffic_source_type=17 (NOTIFICATION) e traffic_source_detail=uploaded_push, la riga indica che tre visualizzazioni sono il risultato di clic degli spettatori sulle notifiche push inviate al momento del caricamento del video.

15 ottobre 2019

Questo aggiornamento include le seguenti modifiche relative all'API YouTube Analytics (query mirate):

  • Nota:questo è un annuncio di ritiro.

    YouTube sta rimuovendo il supporto per le dimensioni 7DayTotals e 30DayTotals. Puoi comunque recuperare i dati utilizzando queste dimensioni fino al 15 aprile 2020. A partire da questa data, i tentativi di recuperare i report utilizzando la dimensione 7DayTotals o 30DayTotals restituiranno un errore.

    Tieni presente che gli utenti possono riprodurre alcuni dei dati per queste dimensioni eseguendo query utilizzando la dimensione day e aggregando o derivando i dati in periodi di 7 o 30 giorni. Ad esempio:

    • Il numero di visualizzazioni per un periodo di sette giorni può essere calcolato aggregando il numero di visualizzazioni di ogni giorno del periodo.
    • La percentuale di spettatori per un periodo di sette giorni può essere calcolata moltiplicando il numero di visualizzazioni avvenute ogni giorno per la percentuale di spettatori di quel giorno, in modo da ottenere il numero di spettatori che hanno eseguito l'accesso durante la visualizzazione del video in quel giorno. Successivamente, il numero di spettatori che hanno eseguito l'accesso può essere sommato per l'intero periodo e diviso per il numero totale di visualizzazioni per quel periodo per ottenere la percentuale di spettatori per l'intero periodo.
    • Il numero di spettatori unici per un periodo di sette giorni non può essere calcolato, poiché lo stesso spettatore potrebbe essere conteggiato come spettatore unico in giorni diversi. Tuttavia, potresti essere in grado di utilizzare la dimensione month anziché la dimensione 30DayTotals per estrapolare i dati sul numero di spettatori unici in un periodo di 30 giorni. Tieni presente che la dimensione month si riferisce ai mesi di calendario, mentre la dimensione 30DayTotals calcola periodi di 30 giorni in base alla data di inizio e di fine specificata.

27 giugno 2019

Questo aggiornamento include le seguenti modifiche relative all'API YouTube Analytics (query mirate):

  • Poiché la versione 1 dell'API è ora completamente ritirata, la documentazione è stata aggiornata per rimuovere i riferimenti a questa versione, inclusi l'avviso di ritiro e la guida alla migrazione che spiega come eseguire l'aggiornamento alla versione 2.

1 novembre 2018

Questo aggiornamento include le seguenti modifiche relative all'API YouTube Analytics (query mirate):

  • La versione 1 dell'API è ora deprecata. Se non l'hai ancora fatto, aggiorna i client API in modo che utilizzino la versione 2 dell'API il prima possibile per ridurre al minimo le interruzioni del servizio. Per ulteriori dettagli, consulta la guida alla migrazione.

    Tieni presente che la pianificazione di questo ritiro è stata annunciata originariamente il giorno 26 aprile 2018.

17 settembre 2018

Questo aggiornamento include le seguenti modifiche relative all'API YouTube Analytics (query mirate):

  • La nuova sezione Anonimizzazione dei dati nel documento di panoramica del modello di dati spiega che alcuni dati di YouTube Analytics sono soggetti a limiti quando le metriche non raggiungono una determinata soglia. Questo può accadere in una serie di casi. In pratica, un report potrebbe non contenere tutti i tuoi dati (o nessuno) se:

    1. un video o un canale ha registrato un traffico limitato durante un periodo di tempo specificato,

      o

    2. hai selezionato un filtro o una dimensione, ad esempio l'origine del traffico o il paese, i cui valori non raggiungono una determinata soglia.

    La nuova sezione include anche una discussione sui tipi di dati che potrebbero essere limitati nei report di YouTube Analytics.

  • I documenti Report sui canali e Report sui proprietari dei contenuti sono stati aggiornati per riflettere il fatto che le metriche redViews e estimatedRedMinutesWatched non sono più supportate per i report su luogo di visualizzazione, sorgente di traffico e tipo di dispositivo/sistema operativo.

18 giugno 2018

Questo aggiornamento include le seguenti modifiche all'API YouTube Analytics (query mirate):

  • I requisiti di ambito per i seguenti metodi sono cambiati:
    • Le richieste al metodo reports.query devono avere accesso all'ambito https://www.googleapis.com/auth/youtube.readonly.
    • Le richieste al metodo groupItems.list devono avere accesso a:
      • ambito https://www.googleapis.com/auth/youtube
        o
      • l'ambito https://www.googleapis.com/auth/youtube.readonly
        e
        l'ambito https://www.googleapis.com/auth/yt-analytics.readonly

      La prima opzione utilizza un ambito, che è un ambito di lettura/scrittura, mentre la seconda opzione utilizza due ambiti di sola lettura.

23 maggio 2018

Questo aggiornamento include le seguenti modifiche all'API YouTube Analytics (query mirate):

  • La panoramica dell'API contiene una nuova sezione, Metriche aggregate ed elementi eliminati, che spiega come le risposte dell'API gestiscono i dati associati a risorse eliminate, come video, playlist o canali.
  • La sezione Best practice della panoramica dell'API è stata aggiornata per ricordarti che puoi utilizzare l'API YouTube Data per recuperare metadati aggiuntivi per le risorse identificate nelle risposte dell'API YouTube Analytics. Come indicato nelle Norme per gli sviluppatori dei servizi API di YouTube (sezioni da III.E.4.b a III.E.4.d), i client API devono eliminare o aggiornare i metadati delle risorse archiviati da questa API dopo 30 giorni.

22 maggio 2018

Questo aggiornamento contiene le seguenti modifiche relative all'API YouTube Reporting (report collettivi):

  • Le seguenti modifiche sono attualmente pianificate per entrare in vigore a luglio 2018 e le nuove norme si applicano a livello globale a tutti i report e i job di generazione di report.

    • Dopo la modifica, la maggior parte dei report dell'API, inclusi i report di backfill, saranno disponibili per 60 giorni a partire dalla relativa data di creazione. Tuttavia, i report contenenti dati storici saranno disponibili per 30 giorni a partire dalla relativa data di creazione.

      Prima di questo annuncio, tutti i report API erano disponibili per 180 giorni a partire dalla relativa data di creazione. Per chiarire, quando questa modifica alle norme entrerà in vigore, i report sui dati storici più vecchi di 30 giorni non saranno più accessibili tramite l'API. Non saranno più accessibili anche tutti gli altri report più vecchi di 60 giorni. Pertanto, ora la documentazione indica che i report creati prima della modifica delle norme saranno disponibili per un massimo di 180 giorni.

    • Dopo la modifica, quando pianifichi un job di generazione dei report, YouTube genererà report a partire da quel giorno e che copriranno il periodo di 30 giorni precedente all'ora in cui è stato pianificato il job. Prima della modifica, quando pianifichi un job di generazione dei report, YouTube genera report che coprono il periodo di 180 giorni precedente all'ora in cui è stato pianificato il job.

  • La sezione Best practice è stata aggiornata per ricordarti che puoi utilizzare l'API YouTube Data per recuperare metadati aggiuntivi per le risorse identificate nei report. Come indicato nelle Norme per gli sviluppatori dei servizi API di YouTube (sezioni da III.E.4.b a III.E.4.d), i client API devono eliminare o aggiornare i metadati delle risorse archiviati da questa API dopo 30 giorni.

  • La sezione Caratteristiche del report è stata aggiornata per indicare che, anche se i dati del report non sono filtrati, i report che contengono dati per un periodo di tempo a partire dal 1° giugno 2018 non conterranno riferimenti a risorse YouTube eliminate almeno 30 giorni prima della data di generazione del report.

  • La sezione Dati storici della panoramica dell'API è stata aggiornata per indicare che, quando pianifichi un nuovo job di generazione di report, i report storici vengono in genere pubblicati entro un paio di giorni. In precedenza, la documentazione indicava che potevano essere necessari fino a 30 giorni prima che questi report fossero disponibili.

  • La sezione Dati di backfill della panoramica dell'API è stata aggiornata per definire più chiaramente i dati di backfill come un insieme di dati che sostituisce un insieme precedentemente fornito.

26 aprile 2018

La versione 2 dell'API YouTube Analytics (query mirate) (v2) è ora disponibile pubblicamente. Il seguente elenco identifica le modifiche ai prodotti e alla documentazione relative alla nuova versione dell'API:

  • L'API v2 è quasi identica all'API v1. Tuttavia, probabilmente dovrai aggiornare il codice per riflettere le modifiche elencate di seguito. Tutte queste modifiche sono spiegate in dettaglio nella nuova guida alla migrazione.

    • La versione dell'API è cambiata da v1 a v2.
    • L'URL di base per le richieste API è cambiato da https://www.googleapis.com/youtube/analytics/v1 a https://youtubeanalytics.googleapis.com/v2.
    • Diversi parametri del metodo reports.query hanno nomi aggiornati. Nello specifico, i nomi dei parametri che contengono trattini, come end-date nell'API v1, utilizzano la notazione camel case (endDate) anziché i trattini nell'API v2. Questa modifica rende coerenti i nomi dei parametri in tutta l'API, poiché i metodi dell'API per la creazione e la gestione dei gruppi utilizzavano già la notazione camel case per i nomi dei parametri.
    • L'API v2 non supporta le richieste batch inviate all'endpoint batch HTTP globale di Google (www.googleapis.com/batch). Se invii richieste batch nell'API v2, devi utilizzare l'endpoint https://youtubeanalytics.googleapis.com/v2.

    Inoltre, alcune funzionalità della v1 non sono supportate nell'API v2:

    • Il metodo reports.query non supporta più i parametri di richiesta alt, quotaUser e userIp.
    • L'API v2 non fornisce un endpoint batch che supporti batch composti da richieste a API diverse. Un batch può essere composto da richieste a metodi diversi della stessa API. Questo ritiro non è specifico dell'API YouTube Analytics, in quanto Google sta ritirando l'endpoint batch globale in tutte le sue API.
    • L'API v2 non supporta il protocollo JSON-RPC, supportato nell'API v1. Anche in questo caso, il ritiro non è specifico dell'API YouTube Analytics.

  • Nota:questo è un annuncio di ritiro.

    La versione 1 dell'API (v1) è ora deprecata e sarà supportata fino al 31 ottobre 2018. Tutte le richieste all'API v1 smetteranno di funzionare dopo questa data. Pertanto, assicurati di eseguire l'upgrade all'API v2 entro il 31 ottobre 2018 per evitare interruzioni nella tua capacità di accedere ai dati di YouTube Analytics tramite l'API.

21 febbraio 2018

Questo aggiornamento include le seguenti modifiche all'API YouTube Analytics (query mirate):

  • I report demografici sugli spettatori, che aggregano le statistiche di visualizzazione in base alla fascia d'età e al genere degli spettatori, non supportano più la dimensione youtubeProduct, che identifica il servizio YouTube su cui si è verificata l'attività dell'utente.

18 gennaio 2018

Questo aggiornamento contiene le seguenti modifiche:

  • API di reporting di YouTube (report collettivi)

    • La dimensione operating_system, che identifica il sistema software del dispositivo su cui si sono verificate le visualizzazioni, ora supporta il seguente valore:
      • 25: KaiOS

  • API YouTube Analytics (query mirate)

20 dicembre 2017

Questo aggiornamento contiene due modifiche relative all'API YouTube Reporting:

  • Il server API ora supporta la compressione gzip per le richieste di download dei report. Tieni presente che la compressione gzip non è supportata per altri tipi di richieste API. L'attivazione della compressione gzip riduce la larghezza di banda necessaria per ogni risposta dell'API. Inoltre, sebbene la tua applicazione richieda tempo di CPU aggiuntivo per decomprimere le risposte API, il vantaggio di consumare meno risorse di rete di solito supera questo costo.

    Per ricevere una risposta con codifica gzip, imposta l'intestazione della richiesta HTTP Accept-Encoding su gzip, come mostrato nell'esempio seguente:

    Accept-Encoding: gzip

    Questa funzionalità è spiegata nella panoramica dell'API e nella definizione della proprietà downloadUrl della risorsa report.

  • La documentazione delle dimensioni age group e gender è stata corretta per mostrare i valori effettivi restituiti dall'API per queste dimensioni. Tieni presente che si tratta di una correzione della documentazione e non riflette una modifica della funzionalità o del comportamento dell'API. Nello specifico, sono stati modificati i seguenti valori:

    • I valori per la dimensione age_group utilizzano lettere maiuscole, contengono trattini bassi tra la parola AGE e i numeri del gruppo di età e utilizzano trattini bassi anziché trattini. Pertanto, valori come age13-17 e age18-24 sono stati corretti rispettivamente in AGE_13_17 e AGE_18_24.
    • I valori della dimensione gender utilizzano lettere maiuscole. Pertanto, i valori female, male e gender_other sono stati corretti in FEMALE, MALE e GENDER_OTHER.

10 agosto 2017

Il 10 agosto 2016, questa documentazione ha annunciato il ritiro della metrica earnings dell'API YouTube Analytics. Allo stesso tempo, l'API ha aggiunto il supporto per una nuova metrica, denominata estimatedRevenue, che fornisce gli stessi dati.

Poiché la metrica earnings era una metrica principale, è stata supportata per un anno dalla data dell'annuncio. Ora che il periodo di un anno è terminato, la metrica earnings non è più supportata. Di conseguenza, le richieste API che specificano la metrica earnings ora restituiscono un codice di risposta HTTP 400. Se non hai ancora aggiornato la tua app in modo che utilizzi la metrica estimatedRevenue anziché la metrica earnings, fallo il prima possibile.

La documentazione dell'API è stata aggiornata per rimuovere i riferimenti rimanenti alla metrica earnings.

6 luglio 2017

Questo aggiornamento contiene le seguenti modifiche:

  • API YouTube Analytics (query mirate)

    • La documentazione dell'API è stata aggiornata per riflettere il fatto che le risposte dell'API contengono dati fino all'ultimo giorno dell'intervallo di date richiesto per il quale sono disponibili tutte le metriche sottoposte a query.

      Ad esempio, se una richiesta specifica una data di fine del 5 luglio 2017 e i valori per tutte le metriche richieste sono disponibili solo fino al 3 luglio 2017, questa sarà l'ultima data per cui i dati sono inclusi nella risposta. Ciò vale anche se i dati per alcune delle metriche richieste sono disponibili per il 4 luglio 2017.

    • La dimensione adType ora supporta il valore reservedBumperInstream, che si riferisce a un annuncio video non ignorabile della durata massima di 6 secondi che viene riprodotto prima della visualizzazione di un video. Il formato dell'annuncio è identico all'annuncio auctionBumperInstream, ma questo tipo si riferisce agli annunci venduti su prenotazione anziché tramite asta.

  • API di reporting di YouTube (report collettivi)

    • La dimensione ad_type ora supporta il valore 20, che si riferisce agli annunci bumper venduti in base alla prenotazione. Gli annunci bumper sono annunci video non ignorabili della durata massima di 6 secondi che vengono riprodotti prima di poter visualizzare un video. Tieni presente che il valore 19 per questa dimensione si riferisce anche agli annunci bumper venduti all'asta anziché su base riservata.

    • I job di reporting per i seguenti report dell'API YouTube Reporting sono stati eliminati:

      • channel_basic_a1
      • channel_province_a1
      • channel_playback_location_a1
      • channel_traffic_source_a1
      • channel_device_os_a1
      • channel_subtitles_a1
      • channel_combined_a1
      • content_owner_basic_a2
      • content_owner_province_a1
      • content_owner_playback_location_a1
      • content_owner_traffic_source_a1
      • content_owner_device_os_a1
      • content_owner_subtitles_a1
      • content_owner_combined_a1
      • content_owner_asset_basic_a1
      • content_owner_asset_province_a1
      • content_owner_asset_playback_location_a1
      • content_owner_asset_traffic_source_a1
      • content_owner_asset_device_os_a1
      • content_owner_asset_combined_a1

      Il ritiro di questi tipi di report è stato annunciato il 15 settembre 2016 e i report non sono più stati generati per questi tipi dopo il 15 dicembre 2016. I report generati in precedenza erano comunque disponibili per 180 giorni a partire dalla relativa data di creazione. Pertanto, alcuni report sono stati accessibili fino al 15 giugno 2017. Tuttavia, poiché i report non sono più disponibili, non sono più necessari nemmeno i job associati.

24 maggio 2017

Tutti i job di generazione di report per i seguenti report dell'API YouTube Reporting sono stati eliminati:

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

Il ritiro di questi tipi di report è stato annunciato il 22 giugno 2016 e i report non sono più stati generati per questi tipi dopo il 22 settembre 2016. I report generati in precedenza erano comunque disponibili per 180 giorni a partire dalla relativa data di creazione. Pertanto, alcuni report sono stati accessibili fino al 22 marzo 2017. Tuttavia, poiché i report non sono più disponibili, non sono più necessari nemmeno i job associati.

22 maggio 2017

Questo aggiornamento contiene le seguenti modifiche:

  • API di reporting di YouTube (report collettivi)

    • La dimensione sharing_service, che identifica il servizio utilizzato per condividere i video, ora supporta i seguenti valori:
      • 85: YouTube Music
      • 86: YouTube Gaming
      • 87: YouTube Kids
      • 88: YouTube TV

      Inoltre, il nome utilizzato per identificare il valore 52 è stato aggiornato nella documentazione a Kakao (Kakao Talk) per differenziarlo più chiaramente dal valore 73 (Kakao Story). Questa modifica non riflette alcun cambiamento nel comportamento dell'API o nella classificazione dei video condivisi con questi servizi.

  • API YouTube Analytics (query mirate)

    • La dimensione sharingService ora supporta i seguenti valori:
      • YOUTUBE_GAMING
      • YOUTUBE_KIDS