Cronologia revisioni

In questa pagina sono elencate le modifiche alle API e gli aggiornamenti della documentazione sia per l'API YouTube Reporting sia per l'API YouTube Analytics. Entrambe le API consentono agli sviluppatori di accedere ai dati di YouTube Analytics, anche se in modi diversi.

6 novembre 2026

La documentazione relativa alle dimensioni della località di riproduzione è stata aggiornata sia per l'API YouTube Reporting sia per l'API YouTube Analytics:

  • Nell'API YouTube Reporting, la tabella delle dimensioni playback_location_type ora documenta i valori 11 (visualizzazioni registrate nel feed live verticale) e 12 (visualizzazioni registrate nella scheda Samples di YouTube Music).
  • Nell'API YouTube Analytics, la definizione della dimensione insightPlaybackLocationType ora elenca IMMERSIVE_LIVE_FEED (visualizzazioni avvenute nel feed live verticale) e SHORTS_FEED (visualizzazioni avvenute nel Feed di YouTube Shorts).

4 novembre 2026

A partire dal 15 gennaio 2027, la versione 1.0 del report settimanale sui riferimenti per i proprietari dei contenuti (content_owner_active_references_a1) è deprecata ed è stata sostituita dalla versione 1.1 (content_owner_active_references_a2). Assicurati di eseguire la migrazione all'ultima versione prima del 15 gennaio 2027.

30 ottobre 2026

L'API di reporting di YouTube ora supporta i seguenti report gestiti dal sistema per i proprietari dei contenuti:

Categoria Nome report ID tipo di report
Riepiloghi finanziari Riepilogo degli aggiustamenti mensili dei canali content_owner_channel_adjustments_summary_a1
Riepiloghi finanziari Entrate mensili delle transazioni relative alle funzionalità a pagamento content_owner_transactions_paid_features_revenue_a1
Riepiloghi finanziari Entrate mensili delle transazioni TVOD per titolo e per paese tvod_content_owner_country_title_tvod_revenue_a1
Riepiloghi finanziari Entrate mensili delle transazioni TVOD per paese tvod_content_owner_country_transactions_tvod_revenue_a1
Short Creazioni mensili di risorse per gli Short delle etichette discografiche music_content_owner_shorts_asset_creations_a1
Short Visualizzazioni mensili delle risorse degli Short delle etichette discografiche music_content_owner_shorts_asset_views_a1
Short Creazioni mensili di risorse per gli Short degli editori musicali publisher_content_owner_shorts_asset_creations_a1
Short Visualizzazioni mensili delle risorse per gli Short degli editori musicali publisher_content_owner_shorts_asset_views_a1
Imposte Report di riepilogo mensile dei rimborsi fiscali per gli affiliati della rete multicanale content_owner_affiliate_tax_refund_summary_a1
Asset Report SRMF settimanale publisher_content_owner_weekly_srmf
Asset Report giornaliero sullo stato delle richieste relative ai Canali ufficiali degli artisti content_owner_oac_request_status_a1
Asset Report giornaliero sulla qualità delle richieste di Canale ufficiale dell'artista content_owner_oac_quality_status_a1

13 settembre 2026

L'API di reporting di YouTube ora supporta la versione 1.1 del report settimanale sui riferimenti 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 per utilizzare i nomi visualizzati o gli ID esterni dei proprietari dei contenuti 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 per l'aggiornamento e la 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 dei video in tempo reale.

  • Metriche monetarie nei report sui canali: è stata aggiornata la documentazione sull'autorizzazione dei report sui canali per chiarire che le metriche sul rendimento degli annunci e sulle entrate stimate 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 di query e compatibilità dei parametri: è stata aggiunta una nota informativa a Informazioni sulle tabelle report per chiarire che le combinazioni di dimensioni, metriche e filtri non valide o che si escludono a vicenda restituiscono l'errore HTTP 400 badRequest ("The query is not supported.").

  • Valori delle dimensioni vuoti nei report collettivi: abbiamo aggiornato le caratteristiche dei report dell'API di reporting di YouTube 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 numero di visualizzazioni pubbliche per tutti i formati video: video nel formato lungo, live e Shorts. 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.

I requisiti di idoneità per il Programma partner di YouTube non subiranno modifiche. 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 valide di Short pubblici" 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 App aggiornata Il video viene riprodotto dal primo frame (include la riproduzione automatica, il passaggio del puntatore del mouse e il clic/tocco per la riproduzione). Numero di visualizzazioni pubbliche standard.
Visualizzazione "engaged" Invariato La riproduzione continua oltre il primo frame o l'utente fa clic/tocca per riprodurre. Monetizzazione tramite il Programma partner di YouTube, la maggior parte delle analisi principali (percentuale di clic, durata di visualizzazione media) 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 di reporting di YouTube.

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 per l'attività utente 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 di reporting di YouTube 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 dei report annunciato in precedenza è 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 sulle rivendicazioni v1.0 (content_owner_active_claims_a1) e del report sulle 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 Report collettivi verrà aggiornata nell'ambito della nuova modifica al conteggio delle visualizzazioni di Shorts. Sono state apportate le seguenti modifiche:

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

Queste modifiche entreranno in vigore il 30 giugno 2025 per l'API Report collettivi. 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 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 dei proprietari dei contenuti - Report 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 dei 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 del proprietario 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 per i 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 delle entrate pubblicitarie giornaliere 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 dei proprietari dei contenuti - Report Rivendicazioni
Nome report Versione precedente Ultima versione
Reclami attivi content_owner_active_claims_a2 content_owner_active_claims_a3
Report dei 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 del proprietario 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 terrà 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.

Consulta questa cronologia delle revisioni per scoprire quali modifiche verranno apportate all'API dei report collettivi e quando.

22 aprile 2025

Come annunciato il 7 aprile 2024, la dimensione isCurated è stata ritirata per i report sui canali e i report 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 contiene 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 di Short. In passato, per gli Short, una visualizzazione veniva conteggiata dopo che uno Short era stato riprodotto per una determinata quantità 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 conteggiano il numero di volte in cui uno Short viene riprodotto o rivisto.
  • Verrà resa disponibile una nuova metrica, engagedViews, che rifletterà la metodologia di conteggio delle visualizzazioni precedente.
  • Se possiedi un canale o sei autorizzato ad accedere ai dati di un canale, potrai eseguire query relative sia alle visualizzazioni aggiornate che alle visualizzazioni "engaged".

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

Inoltre, il ritiro precedentemente annunciato del report Daily Claims (Version 1.0) è stato posticipato.

Consulta questa cronologia delle revisioni per sapere quando vengono apportate modifiche alle API.

3 marzo 2025

Questo aggiornamento contiene 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ù supportata a partire dal 30 aprile 2025. La definizione del report è stata aggiornata di conseguenza. Utilizza invece l'ultimo report Rivendicazioni giornaliere.

15 novembre 2024

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

La documentazione dell'API YouTube Analytics (Targeted Queries) è stata aggiornata per indicare che, per i report sulle sorgenti di traffico, il metodo reports.query dell'API ora restituisce un errore se il prodotto di # di video oggetto della query X # di giorni nell'intervallo di date 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 sia per i canali sia per i proprietari dei contenuti.

Per ridurre il numero di righe restituite da una richiesta, suddividi la query in più query che specificano meno 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 di 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 di 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. Tuttavia, tieni presente 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 continuerà a restituire i dati se non aggiorni il nome della metrica. Naturalmente, puoi modificare l'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 del canale.
    • Le metriche redViews e estimatedRedMinutesWatched non sono più supportate per i nuovi report sulle playlist del canale. Queste metriche non sono 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 per i proprietari dei contenuti è stata aggiornata per spiegare in modo più approfondito i tipi di metriche supportati per i report sulle playlist:

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

  • Le seguenti nuove metriche all'interno della playlist sono supportate per i report sulle playlist per i 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 ogni metrica:

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

    • Quando una richiesta include la dimensione isCurated, la metrica views è una metrica interna alla 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 i video nelle playlist del proprietario dei contenuti sono stati visualizzati, 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 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.

19 gennaio 2024

L'API YouTube Analytics (query mirate) presenta diversi aggiornamenti relativi ai report sulle playlist dei canali. Gli aggiornamenti includono una dimensione ritirata 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ù supportata 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 continuerà a restituire i dati se non aggiorni il nome della metrica. Naturalmente, puoi modificare l'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 del canale.
    • Le metriche redViews e estimatedRedMinutesWatched non sono più supportate per i nuovi report sulle playlist del canale. Queste metriche non sono 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 supportati per i report sulle playlist:

    • Le metriche video aggregate forniscono metriche relative all'attività utente e alle impressioni aggregate per tutti i video nelle playlist del canale che sono anche di proprietà di quel canale. Le metriche video aggregate sono supportate solo per le richieste API che non utilizzano la dimensione isCurated.
    • Le metriche relative alle playlist riflettono l'attività utente e il coinvolgimento nel contesto della pagina della playlist. Queste metriche includono i dati relativi alle visualizzazioni dei video non di tua proprietà presenti nella playlist, ma solo quando queste visualizzazioni si sono verificate nel contesto della playlist.
    • La sezione Metriche delle playlist supportate identifica le metriche dei video aggregati e le metriche interne alle playlist supportate per i report sulle playlist.

  • Le seguenti nuove metriche all'interno della playlist sono supportate per i report sulle playlist per i canali. 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 ogni metrica:

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

    • Quando una richiesta include la dimensione isCurated, la metrica views è una metrica interna alla 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 queste 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 relativa ai 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 valori della dimensione insightTrafficSourceType. In precedenza, la dimensione distingueva tra i video riprodotti come parte 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 saranno 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 fornisce l'attività utente per città. Questo report è disponibile per canali e proprietari dei contenuti. Questo report contiene la nuova dimensione city, che identifica la città in cui si è svolta l'attività utente stimata da YouTube.

  • La nuova dimensione creatorContentType identifica il tipo di contenuti di YouTube associato alle metriche relative all'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 di reporting di YouTube (report collettivi) supportano entrambe un nuovo valore dei dettagli della sorgente di traffico:

  • Nell'API YouTube Analytics (Targeted Queries), 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 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

L'insieme di valori validi per la dimensione gender cambierà a partire dall'11 agosto 2022. Potrebbe trattarsi di una modifica incompatibile con le versioni precedenti dell'implementazione dell'API. In conformità con la sezione Modifiche incompatibili con le versioni precedenti dei Termini di servizio dei servizi 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 agevole al nuovo insieme di valori.

Le modifiche specifiche 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 di 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 di reporting di YouTube (report collettivi).

2 febbraio 2022

L'API YouTube Reporting (report collettivi) supporta un nuovo valore della dimensione della sorgente di traffico che indica che le visualizzazioni provengono da Live Redirect:

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

Per questo tipo di sorgente 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 YouTube Reporting (report collettivi) supportano entrambe un nuovo valore della dimensione della sorgente di traffico che indica che lo spettatore è stato indirizzato tramite lo scorrimento verticale 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 dei dettagli della 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 (Targeted Queries):

  • La dimensione massima di un gruppo di report di YouTube Analytics è aumentata da 200 a 500 entità.
  • Il parametro filters del metodo reports.query 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 è possibile specificare per questi filtri è aumentato da 200 a 500 ID.

13 febbraio 2020

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

In entrambe le API, l'insieme di possibili valori dei dettagli della sorgente di traffico per le notifiche sta cambiando. Nelle query mirate, le notifiche vengono segnalate come insightTrafficSourceType=NOTIFICATION. Nei report collettivi, le notifiche vengono indicate come traffic_source_type=17.

I nuovi valori suddividono le notifiche relative ai video caricati e ai live streaming, precedentemente segnalate 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 provenienti da notifiche non push, ad esempio notifiche via email o nella posta in arrivo, inviate agli iscritti quando è stato caricato un video.

Questi valori vengono restituiti per l'intervallo di tempo che inizia il 13 gennaio 2020.

Inoltre, tieni presente che questi valori non rappresentano le notifiche stesse, ma piuttosto 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, significa che tre visualizzazioni sono state generate dai clic degli spettatori sulle notifiche push inviate al momento del caricamento del video.

15 ottobre 2019

Questo aggiornamento contiene 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 con la dimensione day e aggregando o ricavando 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 di quel periodo.
    • La metrica viewerPercentage per un periodo di sette giorni può essere calcolata moltiplicando il numero di visualizzazioni registrate ogni giorno per la metrica viewerPercentage di quel giorno, in modo da ottenere il numero di spettatori che avevano eseguito l'accesso durante la visione del video in quel giorno. Successivamente, il numero di spettatori che hanno eseguito l'accesso può essere aggiunto per l'intero periodo e diviso per il numero totale di visualizzazioni per quel periodo per ottenere il valore viewerPercentage 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 calcolato come spettatore unico in giorni diversi. Tuttavia, potresti 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 alle date di inizio e di fine specificate.

27 giugno 2019

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

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

1 novembre 2018

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

  • La versione 1 dell'API è stata ritirata. Se non l'hai già fatto, aggiorna i tuoi client API in modo che utilizzino la versione 2 dell'API il prima possibile per ridurre al minimo le interruzioni del servizio. Consulta la guida alla migrazione per ulteriori dettagli.

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

17 settembre 2018

Questo aggiornamento contiene 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 limitati quando le metriche non raggiungono una determinata soglia. Questa situazione può verificarsi in diversi casi. In pratica, un report potrebbe non contenere tutti i tuoi dati (o non contenerne affatto) se:

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

      o

    2. Hai selezionato un filtro o una dimensione, ad esempio sorgente di traffico o 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 relativi ai report sui canali e ai report dei proprietari dei contenuti sono stati aggiornati per riflettere il fatto che le metriche redViews e estimatedRedMinutesWatched non sono più supportate per i report su località di riproduzione, sorgente di traffico e tipo di dispositivo/sistema operativo.

18 giugno 2018

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

  • I requisiti di ambito per i seguenti metodi sono stati modificati:
    • 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:
      • l'https://www.googleapis.com/auth/youtubeambito
        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 contiene le seguenti modifiche all'API YouTube Analytics (query mirate):

  • La sezione Panoramica dell'API contiene una nuova sezione, Metriche aggregate ed elementi eliminati, che spiega in che modo le risposte dell'API gestiscono i dati associati alle 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 III.E.4.b-III.E.4.d), i client API devono eliminare o aggiornare i metadati delle risorse archiviati da quell'API dopo 30 giorni.

22 maggio 2018

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

  • Al momento, l'entrata in vigore delle seguenti modifiche è prevista per luglio 2018 e le nuove norme si applicano a livello globale a tutti i report e i job di generazione dei report.

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

      Prima di questo annuncio, tutti i report dell'API erano disponibili per 180 giorni dalla data di generazione. Per chiarire, quando questa modifica alle norme entrerà in vigore, i report sui dati storici risalenti a più di 30 giorni prima non saranno più accessibili tramite l'API. Inoltre, non saranno più accessibili tutti gli altri report risalenti a più di 60 giorni prima. Pertanto, la documentazione ora 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à i report a partire da quel giorno e per il periodo di 30 giorni precedente alla pianificazione del job. Prima della modifica, quando pianifichi un job di generazione di report, YouTube genera report che coprono il periodo di 180 giorni precedente alla pianificazione del 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 III.E.4.b-III.E.4.d), i client API devono eliminare o aggiornare i metadati delle risorse archiviati da quell'API dopo 30 giorni.

  • La sezione Caratteristiche dei report è stata aggiornata per indicare che, anche se i dati dei report non vengono filtrati, i report che contengono dati relativi a un periodo di tempo successivo al 1° giugno 2018 non conterranno riferimenti alle risorse di 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 reporting, 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 set di dati che sostituisce un set fornito in precedenza.

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, è probabile che tu debba 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.
    • I nomi di diversi parametri del metodo reports.query sono stati aggiornati. In particolare, i nomi dei parametri che contengono trattini, come end-date nell'API v1, utilizzano la notazione a cammello (endDate) anziché i trattini nell'API v2. Questa modifica rende i nomi dei parametri coerenti in tutta l'API, poiché i metodi dell'API per la creazione e la gestione dei gruppi utilizzavano già la notazione a cammello 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 versione 1 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. Tuttavia, 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, che era 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) è stata ritirata e sarà supportata fino al 31 ottobre 2018. Dopo questa data, tutte le richieste all'API v1 smetteranno di funzionare. Pertanto, assicurati di eseguire l'upgrade all'API v2 entro il 31 ottobre 2018 per evitare interruzioni nell'accesso ai dati di YouTube Analytics tramite l'API.

21 febbraio 2018

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

  • I report sulle categorie demografiche degli 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à utente.

18 gennaio 2018

Questo aggiornamento contiene le seguenti modifiche:

  • API YouTube Reporting (report collettivi)

    • La dimensione operating_system, che identifica il sistema software del dispositivo su cui sono avvenute 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 di reporting di YouTube:

  • Il server API ora supporta la compressione gzip per le richieste che scaricano i 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 l'applicazione richieda tempo di CPU aggiuntivo per decomprimere le risposte dell'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. In particolare, sono stati modificati i seguenti valori:

    • I valori della dimensione age_group utilizzano lettere maiuscole, contengono trattini bassi tra la parola AGE e i numeri nella fascia d'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 questo 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 per utilizzare 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 cui sono disponibili tutte le metriche su cui viene eseguita la 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, quest'ultima sarà la data finale per cui i dati sono inclusi nella risposta. Questo 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 che sia possibile visualizzare un video. Il formato dell'annuncio è identico a quello dell'annuncio auctionBumperInstream, ma questo tipo si riferisce agli annunci venduti su prenotazione anziché tramite asta.

  • API YouTube Reporting (report collettivi)

    • La dimensione ad_type ora supporta il valore 20, che si riferisce agli annunci bumper venduti su base prenotata. 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 tramite asta anziché su prenotazione.

    • 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 di report dopo il 15 dicembre 2016. I report generati in precedenza sono rimasti disponibili per 180 giorni dalla data di creazione. Di conseguenza, alcuni report erano accessibili fino al 15 giugno 2017. Tuttavia, poiché i report non sono più disponibili, non sono più necessari neanche i job associati ai report.

24 maggio 2017

Tutti i job di generazione dei 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

Questi tipi di report sono stati dichiarati ritirati il 22 giugno 2016 e non sono più stati generati dopo il 22 settembre 2016. I report generati in precedenza sono rimasti disponibili per 180 giorni dalla data di creazione. Pertanto, alcuni report erano accessibili fino al 22 marzo 2017. Tuttavia, poiché i report non sono più disponibili, non sono più necessari neanche i job associati ai report.

22 maggio 2017

Questo aggiornamento contiene le seguenti modifiche:

  • API YouTube Reporting (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 in 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
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

28 marzo 2017

I proprietari dei canali che possono accedere ai dati sulle entrate tramite YouTube Analytics in Creator Studio ora possono accedere a questi dati anche tramite l'API YouTube Analytics:

17 marzo 2017

Questo aggiornamento contiene le seguenti modifiche:

  • L'API YouTube Analytics supporta le metriche redViews e estimatedRedMinutesWatched, entrambe relative alle visualizzazioni di YouTube Red. In realtà, l'API supporta queste metriche già da un po' di tempo e l'API YouTube Reporting supporta entrambe le metriche, come annunciato il 15 settembre 2016.

    • La metrica redViews identifica il numero di volte in cui un video è stato visualizzato dagli abbonati a YouTube Red.
    • La metrica estimatedRedMinutesWatched identifica il numero di minuti di visualizzazione di un video da parte degli abbonati a YouTube Red.

    La documentazione relativa ai report sui canali e ai report sui proprietari dei contenuti è stata aggiornata per mostrare quali report supportano le due nuove metriche. Sono supportate in tutti i report che supportavano già le metriche views e estimatedMinutesWatched.

3 marzo 2017

Questo aggiornamento contiene le seguenti modifiche:

  • API YouTube Reporting (report collettivi)

    • La definizione della dimensione date è stata corretta per indicare che il valore della dimensione si riferisce al periodo che inizia alle 00:00 fuso orario del Pacifico e termina alle 23:59 fuso orario del Pacifico del giorno, del mese e dell'anno specificati. A seconda del periodo dell'anno, il fuso orario del Pacifico è UTC-7 o UTC-8.

      Sebbene le date rappresentino in genere un periodo di 24 ore, le date in cui gli orologi vengono spostati in avanti rappresentano un periodo di 23 ore, mentre quelle in cui gli orologi vengono spostati indietro rappresentano un periodo di 25 ore. In precedenza, la documentazione indicava che ogni data rappresentava un periodo univoco di 24 ore e che l'ora del Pacifico era sempre UTC-8.

      Tieni presente che questa correzione non rappresenta una modifica del comportamento effettivo dell'API.

    • La dimensione operating_system, che identifica il sistema software del dispositivo su cui sono avvenute le visualizzazioni, ora supporta i seguenti valori:
      • 22: Tizen
      • 23: Firefox
      • 24: RealMedia

    • Tutti i job di generazione dei report per il tipo di report content_owner_basic_a1 sono stati eliminati. Questo tipo di report è stato ritirato definitivamente il 19 agosto 2016, ma i report content_owner_basic_a1 generati in precedenza sono rimasti disponibili per 180 giorni dalla data di generazione. Pertanto, alcuni report erano accessibili fino al 19 febbraio 2017. Tuttavia, poiché i report non sono più disponibili, non sono più necessari neanche i job associati ai report.

  • API YouTube Analytics (query mirate)

    • La descrizione delle dimensioni relative a time periods è stata corretta per indicare che il valore della dimensione si riferisce al periodo che inizia alle 00:00 fuso orario del Pacifico e termina alle 23:59 fuso orario del Pacifico del giorno, del mese e dell'anno specificati. A seconda del periodo dell'anno, il fuso orario del Pacifico è UTC-7 o UTC-8.

      Sebbene le date rappresentino in genere un periodo di 24 ore, le date in cui gli orologi vengono spostati in avanti rappresentano un periodo di 23 ore, mentre quelle in cui gli orologi vengono spostati indietro rappresentano un periodo di 25 ore. In precedenza, la documentazione indicava che il fuso orario del Pacifico era UTC-8 e non menzionava la possibilità che un giorno non rappresentasse un periodo di 24 ore.

      Tieni presente che questa correzione non rappresenta una modifica del comportamento effettivo dell'API.

    • La documentazione relativa ai report sui canali è stata aggiornata per indicare che i report sui canali non contengono attualmente metriche sul rendimento degli annunci o sugli utili. Di conseguenza, l'ambito https://www.googleapis.com/auth/yt-analytics-monetary.readonly attualmente non concede l'accesso ai dati monetari nei report sul canale.

    • La dimensione operatingSystem supporta tre nuovi valori:
      • FIREFOX
      • REALMEDIA
      • TIZEN

8 febbraio 2017

L'API YouTube Analytics ora supporta il parametro facoltativo include-historical-channel-data. Tieni presente che questo parametro è pertinente solo quando recuperi i report del proprietario dei contenuti.

Il parametro consente a un proprietario dei contenuti di indicare che una risposta dell'API deve includere i dati relativi al tempo di visualizzazione e alle visualizzazioni dei canali nel periodo di tempo precedente al collegamento dei canali al proprietario dei contenuti. Il valore parametro predefinito è false, il che significa che, per impostazione predefinita, la risposta dell'API include solo i dati relativi al tempo di visualizzazione e alle visualizzazioni dal momento in cui i canali sono stati collegati al proprietario dei contenuti.

Queste regole si applicano anche se la richiesta API recupera i dati per più canali:

  • Se il valore del parametro è false, i dati relativi al tempo di visualizzazione e alle visualizzazioni restituiti per un determinato canale si basano sulla data in cui il canale è stato collegato al proprietario dei contenuti.

    È importante ricordare che canali diversi potrebbero essere stati collegati a un proprietario dei contenuti in date diverse. Se la richiesta API recupera i dati per più canali e il valore parametro è false, la risposta dell'API contiene i dati relativi al tempo di visualizzazione e alle visualizzazioni in base alla data di collegamento per ogni rispettivo canale.
  • Se il valore parametro è true, la risposta restituisce i dati relativi al tempo di visualizzazione e alle visualizzazioni per tutti i canali in base alle date di inizio e di fine specificate nella richiesta API.

15 dicembre 2016

I seguenti report dell'API YouTube Reporting non sono più supportati e sono stati rimossi dalla documentazione. È disponibile una versione più recente di ogni report. L'annuncio sul ritiro di questi report è stato pubblicato il 15 settembre 2016.

Anche l'elenco dei tipi di report attuali nella documentazione di riferimento dell'API è stato aggiornato.

11 novembre 2016

Questo aggiornamento contiene le seguenti modifiche:

L'API YouTube Reporting supporta tre nuovi report sulle schermate finali, nonché nuove dimensioni e metriche per questi report. I report forniscono statistiche sulle impressioni e sui clickthrough per le schermate finali visualizzate al termine della riproduzione di un video.

  • Report sulle schermate finali

    • Il report sulle schermate finali per i video del canale contiene le statistiche relative a tutti i video di un canale.
    • Il report sulle schermate finali per i video del proprietario dei contenuti contiene statistiche relative ai video presenti su tutti i canali di un proprietario dei contenuti.
    • Il report sulle schermate finali per le risorse dei proprietari dei contenuti contiene statistiche relative alle risorse associate ai video dopo i quali vengono visualizzate le schermate finali.

  • Dimensioni delle schermate finali

  • Metriche delle schermate finali

    Nota: i dati relativi alle metriche delle schermate finali sono disponibili a partire dal 1° maggio 2016.

    • Il Centro assistenza YouTube contiene informazioni più dettagliate su come aggiungere le schermate finali ai video.

  • I seguenti report non sono più supportati e sono stati rimossi dalla documentazione. È disponibile una versione più recente di ogni report. (L'annuncio sul ritiro di questi report è stato pubblicato il 22 giugno 2016.)

8 novembre 2016

Questo aggiornamento contiene le seguenti modifiche all'API YouTube Analytics:

  • Le metriche nel seguente elenco sono completamente deprecate e non sono più supportate. Come annunciato il 10 agosto 2016, sono già supportate nuove metriche che fanno riferimento agli stessi dati. La tabella seguente mostra il nome della metrica ritirata e il nome della nuova metrica:

    Metrica ritirata Nuova metrica
    adEarnings estimatedAdRevenue
    impressionBasedCpm cpm
    impressions adImpressions
    redPartnerRevenue estimatedRedPartnerRevenue

27 ottobre 2016

YouTube ora genera automaticamente un insieme di report sulle entrate pubblicitarie gestiti dal sistema per i proprietari dei contenuti che hanno accesso ai report corrispondenti nella sezione Report di YouTube Creator Studio. I nuovi report API gestiti dal sistema sono progettati per fornire l'accesso programmatico ai dati disponibili anche nei report di Creator Studio scaricabili manualmente.

La panoramica dei report gestiti dal sistema fornisce una breve panoramica dei nuovi report e spiega la procedura per recuperarli tramite l'API. Questa procedura è leggermente diversa da quella per il recupero dei report collettivi per YouTube Analytics, poiché i partner non devono pianificare i job per generare i report.

La proprietà id della risorsa reportType è stata aggiornata per includere un elenco dei report gestiti dal sistema a cui puoi accedere tramite l'API:

  • Entrate pubblicitarie mensili globali per video
  • Entrate pubblicitarie giornaliere per paese per video
  • Entrate pubblicitarie mensili globali per asset
  • Entrate pubblicitarie giornaliere per paese per asset
  • Rivendicazioni (questo report non contiene dati sulle entrate)

27 settembre 2016

Nota: questo è un annuncio di ritiro.

La metrica uniques dell'API YouTube Analytics è stata ritirata. Questa non è una metrica principale e sarà supportata fino al 31 ottobre 2016.

15 settembre 2016

Questo aggiornamento contiene le seguenti modifiche all'API YouTube Reporting:

19 agosto 2016

Questo aggiornamento contiene la seguente modifica all'API YouTube Reporting:

  • Il report content_owner_basic_a1 è stato completamente ritirato e rimosso dalla documentazione. YouTube non genererà più nuovi report di questo tipo, anche se i report già generati rimarranno disponibili per 180 giorni dalla data di creazione.

    Il report content_owner_basic_a1 è stato sostituito dal report content_owner_basic_a2, come spiegato nella voce della cronologia delle revisioni del 19 maggio 2016.

11 agosto 2016

Questo aggiornamento contiene le seguenti modifiche:

  • I Termini di servizio dei servizi API di YouTube appena pubblicati ("i Termini aggiornati"), discussi in dettaglio nel blog di YouTube Engineering and Developers, forniscono un ricco insieme di aggiornamenti ai Termini di servizio attuali. Oltre ai Termini aggiornati, che entreranno in vigore il 10 febbraio 2017, questo aggiornamento include diversi documenti di supporto che spiegano le norme che gli sviluppatori devono seguire.

    L'insieme completo dei nuovi documenti è descritto nella cronologia delle revisioni dei Termini aggiornati. Inoltre, eventuali modifiche future ai Termini aggiornati o ai documenti di supporto verranno spiegate nella cronologia delle revisioni.

10 agosto 2016

Questo aggiornamento include le seguenti modifiche:

  • API YouTube Analytics (query mirate)

    • Nota: questo è un annuncio di ritiro.

      Le metriche nella tabella seguente verranno ritirate. Allo stesso tempo, vengono introdotte nuove metriche che fanno riferimento agli stessi dati. In pratica, ciò significa che le vecchie metriche verranno rinominate, anche se l'API YouTube Analytics supporterà entrambi i nomi delle metriche fino alle date di ritiro elencate nella tabella.

      Vecchio nome della metrica Nuovo nome della metrica Data di assistenza
      earnings estimatedRevenue 10 agosto 2017
      adEarnings estimatedAdRevenue 4 novembre 2016
      redPartnerRevenue estimatedRedPartnerRevenue 4 novembre 2016
      impressionBasedCpm cpm 4 novembre 2016
      impressions adImpressions 4 novembre 2016

      Tieni presente che la metrica earnings era una metrica principale, pertanto sarà supportata per un anno dalla data di questo annuncio. Le altre metriche, che non erano metriche principali, saranno supportate per tre mesi, fino al 4 novembre 2016.

      Ad esempio, fino al 4 novembre 2016, una richiesta API può specificare la metrica impressionBasedCpm, la metrica cpm o entrambe. Tuttavia, dopo questa data, verrà supportata solo la metrica cpm.

    • La dimensione insightTrafficSourceType supporta due nuovi valori:
      • CAMPAIGN_CARD: questa sorgente di traffico è supportata solo per i report del proprietario dei contenuti. Indica che le visualizzazioni provengono da video rivendicati e caricati dagli utenti che il proprietario dei contenuti ha utilizzato per promuovere i contenuti visualizzati.
      • END_SCREEN: i dati si riferiscono alle visualizzazioni provenienti dalla schermata finale di un altro video.

      Per entrambe le nuove sorgenti di traffico, puoi anche recuperare un report traffic source detail. In entrambi i casi, la dimensione insightTrafficSourceDetail identifica il video da cui lo spettatore è stato indirizzato.

    • La dimensione adType ora supporta il valore auctionBumperInstream, che si riferisce a un annuncio video non ignorabile della durata massima di 6 secondi che viene riprodotto prima che sia possibile visualizzare un video.

  • API YouTube Reporting (report collettivi)

    • La dimensione traffic_source_type ora supporta i seguenti valori:
      • 19: questa sorgente di traffico è supportata solo per i report del proprietario dei contenuti. Indica che le visualizzazioni provengono da video rivendicati e caricati dagli utenti che il proprietario dei contenuti ha utilizzato per promuovere i contenuti visualizzati.
      • 20: i dati si riferiscono alle visualizzazioni provenienti dalla schermata finale di un altro video.

      Per entrambe le nuove sorgenti di traffico, la dimensione traffic_source_detail identifica il video da cui è stato indirizzato lo spettatore.

    • L'elenco delle metriche principali dell'API è stato corretto per includere estimated_partner_revenue come metrica principale e rimuovere earnings da questo elenco. La metrica earnings non è mai stata supportata nell'API YouTube Reporting.

    • La dimensione ad_type ora supporta il valore 19, che si riferisce agli annunci bumper, ovvero annunci video non ignorabili della durata massima di 6 secondi che vengono riprodotti prima che sia possibile visualizzare un video.

18 luglio 2016

Questo aggiornamento include le seguenti modifiche:

  • API YouTube Analytics (query mirate)

    • Gli elenchi di metriche supportate per i seguenti report sui canali sono stati aggiornati per includere le metriche delle schede. Il supporto per le metriche delle schede in questi report è stato aggiunto il 28 giugno 2016 e la voce della cronologia delle revisioni per quella data spiega la modifica in modo più dettagliato. I report sono:
      • Attività utente di base per gli stati degli Stati Uniti
      • Attività utente negli stati degli Stati Uniti per periodi di tempo specifici
      • Attività utente per provincia
      • Attività utente per stato di iscrizione
      • Attività utente per stato di iscrizione per le province
      • Video principali per stato
      • Video principali per gli spettatori iscritti o non iscritti

    • Gli elenchi di filtri sono stati corretti sia per i report Fidelizzazione del pubblico del canale sia per i report Fidelizzazione del pubblico del proprietario dei contenuti per indicare che il filtro video è obbligatorio e il filtro group non è supportato.

      In precedenza, la documentazione di entrambi i report indicava erroneamente che il report poteva essere recuperato utilizzando uno dei due filtri o nessuno dei due.

  • API YouTube Reporting (report collettivi)

    • Nella panoramica dell'API, la sezione che spiega come recuperare l'URL di download di un report è stata corretta per indicare che YouTube genera report scaricabili per i giorni in cui non erano disponibili dati. Questi report contengono una riga di intestazione, ma non dati aggiuntivi. Queste informazioni erano già state aggiornate nella sezione Caratteristiche del report dello stesso documento il 12 aprile 2016.
    • L'elenco delle dimensioni nel report content_owner_asset_cards_a1 è stato corretto per indicare che il report utilizza la dimensione card_id. In precedenza, nella documentazione il nome della dimensione era erroneamente indicato come card_title.

28 giugno 2016

La documentazione dell'API YouTube Analytics è stata aggiornata per riflettere il supporto delle metriche delle schede in numerosi report relativi ai canali e ai proprietari dei contenuti. Le nuove metriche supportate sono:

Le metriche sono supportate nei seguenti tipi di report:

22 giugno 2016

Questo aggiornamento contiene le seguenti modifiche all'API YouTube Reporting. La prima modifica riguarda l'API in generale, mentre le altre interessano solo i report dei proprietari dei contenuti:

  • La sezione Caratteristiche dei report della panoramica dell'API è stata aggiornata per chiarire che i report sono disponibili tramite l'API per 180 giorni dalla data di generazione.

    In precedenza, la documentazione indicava che i report sono disponibili per un periodo massimo di 180 giorni prima della data di invio della richiesta API. Sebbene anche questo sia tecnicamente vero, il testo originale era, nella migliore delle ipotesi, piuttosto confuso.

  • L'API supporta nuove versioni di tre report. Due di questi report contengono anche metriche nuove e rinominate:

    • Il report content_owner_ad_rates_a1 è la nuova versione del report content_owner_ad_performance_a1. Il report appena rinominato è identico alla versione precedente.

    • Due report con nuove versioni sono stati rinominati:

      • La nuova versione del report content_owner_estimated_earnings_a1 si chiama content_owner_estimated_revenue_a1.
      • La nuova versione del report content_owner_asset_estimated_earnings_a1 si chiama content_owner_asset_estimated_revenue_a1.

      Entrambi i report appena rinominati differiscono dai loro predecessori nei seguenti modi:

    Tieni presente che se hai già job per creare una delle versioni precedenti di questi report, devi creare nuovi job per i report rinominati. In concomitanza con il rilascio delle nuove versioni dei report, i report content_owner_ad_performance_a1, content_owner_estimated_earnings_a1 e content_owner_asset_estimated_earnings_a1 sono stati ritirati.

    Se hai job per uno di questi report, YouTube non genererà nuovi report per questi job dopo il 22 settembre 2016. I report generati rimarranno disponibili per 180 giorni dalla data di generazione.

  • La definizione della proprietà id della risorsa reportType è stata aggiornata per riflettere l'insieme corrente di report disponibili.

  • I nomi di due metriche sono stati corretti nella documentazione in modo che corrispondano ai nomi visualizzati nei report. Si tratta puramente di una correzione della documentazione e non riflette una modifica dei contenuti effettivi del report:

    • Il nome della metrica estimated_partner_adsense_revenue è stato aggiornato in estimated_partner_ad_sense_revenue. Tieni presente, tuttavia, che questa metrica viene visualizzata solo in due report che verranno ritirati con questo aggiornamento. Come descritto sopra, questa metrica è stata rinominata estimated_partner_ad_auction_revenue nelle versioni più recenti di questi report.
    • Il nome della metrica estimated_partner_doubleclick_revenue è stato aggiornato in estimated_partner_double_click_revenue. Anche in questo caso, tieni presente che questa metrica viene visualizzata solo in due report che verranno ritirati con questo aggiornamento. Come descritto sopra, questa metrica è stata rinominata estimated_partner_ad_reserved_revenue nelle versioni più recenti di questi report.

  • La documentazione sulle dimensioni per l'API Reporting è stata aggiornata in modo da non elencare più le proprietà elapsed_video_time_percentage e audience_retention_type. Queste dimensioni non sono attualmente supportate da alcun report disponibile tramite l'API.

19 maggio 2016

Questo aggiornamento contiene le seguenti modifiche all'API YouTube Reporting:

  • L'API supporta una nuova versione del report sull'attività degli utenti per i proprietari dei contenuti. L'ID del tipo di report per il nuovo report è content_owner_basic_a2. A differenza della versione precedente del report, content_owner_basic_a1, la nuova versione supporta le metriche likes e dislikes.

    Se hai già un job per creare il report content_owner_basic_a1, devi comunque creare un nuovo job per il report content_owner_basic_a2. YouTube non esegue la migrazione automatica dei proprietari dei contenuti alla nuova versione del report né crea automaticamente un job per generare la nuova versione del report. In alcune implementazioni, la comparsa di un nuovo job imprevisto potrebbe essere una modifica che provoca un errore.

    In concomitanza con l'uscita del nuovo report, il report content_owner_basic_a1 è stato ritirato. Se hai un job per questo report, YouTube non genererà nuovi report per quel job dopo il 19 agosto 2016. I report generati rimarranno disponibili per 180 giorni dalla data di generazione.

  • Le risorse reportType, job e report supportano tutte una nuova proprietà che identifica se la risorsa associata rappresenta un tipo di report deprecato:

    • La proprietà deprecateTime della risorsa reportType specifica la data e l'ora in cui il tipo di report verrà ritirato. Questa proprietà ha un valore solo per i report che sono stati dichiarati deprecati e il valore rappresenta la data in cui YouTube smetterà di generare report di quel tipo.

      Dopo l'annuncio del ritiro di un tipo di report, YouTube genera report di quel tipo per altri tre mesi. Ad esempio, questo aggiornamento del 19 maggio 2016 annuncia il ritiro del report content_owner_basic_a1. Pertanto, il valore deprecateTime per quel tipo di report specifica un'ora del 19 agosto 2016, dopo la quale YouTube interromperà la generazione di report di quel tipo.

    • La proprietà expireTime della risorsa job specifica la data e l'ora di scadenza del job. Questa proprietà ha un valore se il tipo di report associato al job è stato ritirato o se i report generati per il job non sono stati scaricati per un periodo di tempo prolungato. La data indica il momento dopo il quale YouTube non genera più nuovi report per il job.

    • La proprietà jobExpireTime della risorsa report specifica la data e l'ora in cui il job associato al report è scaduto o scadrà. Questa proprietà contiene lo stesso valore della proprietà expireTime nella risorsa job, come descritto nell'elemento precedente di questo elenco.

  • Il metodo jobs.create ora restituisce un codice di risposta HTTP 400 (Bad Request) se provi a creare un job per un report ritirato. Inoltre, la documentazione del metodo ora elenca diversi altri motivi per cui una richiesta API non va a buon fine.

12 aprile 2016

Questo aggiornamento contiene le seguenti modifiche, che interessano solo l'API YouTube Reporting:

  • YouTube ora genera dati relativi al periodo di 180 giorni precedente alla prima pianificazione di un job di generazione dei report. In precedenza, l'API Reporting non forniva dati storici. Questa modifica interessa tutti i job, inclusi quelli creati prima di questo annuncio.

    I report storici vengono pubblicati non appena sono disponibili, anche se è necessario circa un mese per la pubblicazione di tutti i dati storici di un job. Pertanto, un mese dopo la pianificazione di un job di reporting, avrai accesso a circa sette mesi di dati. (Tutti i dati storici relativi ai job creati prima di questo annuncio devono essere pubblicati entro un mese dall'annuncio).

    Tieni presente che i dati storici sono disponibili solo a partire dal 1° luglio 2015. Di conseguenza, i job creati prima del 28 dicembre 2015 avranno meno di 180 giorni di dati storici.

    Queste modifiche sono tutte spiegate nella nuova sezione Dati storici della panoramica dell'API Reporting.

  • La sezione Caratteristiche dei report della panoramica dell'API di reporting di YouTube è stata aggiornata con le seguenti modifiche:

    • La documentazione ora indica che i report sono disponibili per un periodo di 180 giorni dalla loro generazione e, pertanto, sono disponibili per il download da parte dei client API. In precedenza, la documentazione indicava che i report erano disponibili per un periodo massimo di sei mesi prima della data di invio della richiesta API.

    • La documentazione è stata aggiornata per riflettere il fatto che l'API ora genera report scaricabili per i giorni in cui non erano disponibili dati. Questi report conterranno righe di intestazione, ma non dati aggiuntivi.

  • A breve, l'API di reporting di YouTube supporterà una serie di report generati automaticamente e gestiti dal sistema che contengono dati sulle entrate pubblicitarie o sulle entrate da abbonamenti a YouTube Red. I report saranno disponibili per i proprietari dei contenuti che possono già accedere ai report Entrate scaricabili manualmente in Creator Studio di YouTube. Pertanto, la nuova funzionalità dell'API fornirà l'accesso programmatico a questi dati.

    Le seguenti modifiche alle API vengono annunciate ora in preparazione al lancio dei report gestiti dal sistema:

    • La nuova proprietà systemManaged della risorsa job indica se la risorsa descrive un job che genera report gestiti dal sistema. YouTube genera automaticamente report gestiti dal sistema per i proprietari dei contenuti YouTube, che non possono modificare o eliminare i job che creano questi report.

    • Il nuovo parametro includeSystemManaged del metodo jobs.list indica se la risposta dell'API deve includere i job per i report gestiti dal sistema. Il valore predefinito del parametro è false.

    • Il nuovo parametro startTimeAtOrAfter del metodo jobs.reports.list indica che la risposta dell'API deve contenere report solo se i dati più recenti nel report sono uguali o successivi alla data specificata. Analogamente, il parametro startTimeBefore indica che la risposta dell'API deve contenere report solo se i dati più vecchi nel report sono precedenti alla data specificata.

      A differenza del parametro createdAfter del metodo, che riguarda l'ora di creazione del report, i nuovi parametri riguardano i dati nel report.

    • La nuova proprietà systemManaged della risorsa reportType indica se la risorsa descrive un report gestito dal sistema.

    • Il nuovo parametro includeSystemManaged del metodo reportTypes.list indica se la risposta dell'API deve includere i report gestiti dal sistema. Il valore predefinito del parametro è false.

28 marzo 2016

L'API YouTube Reporting e l'API YouTube Analytics ora restituiscono le statistiche sulle visualizzazioni per diversi servizi di condivisione aggiuntivi.

  • Nell'API YouTube Reporting, la dimensione sharing_service supporta questi nuovi valori:
    • 82: finestra di dialogo dell'attività di sistema di iOS
    • 83: Google Inbox
    • 84: Android Messenger
  • Nell'API YouTube Analytics, la dimensione sharingService supporta questi nuovi valori:
    • ANDROID_MESSENGER: Android Messenger
    • INBOX: Google Inbox
    • IOS_SYSTEM_ACTIVITY_DIALOG: finestra di dialogo dell'attività di sistema di iOS

16 marzo 2016

Questo aggiornamento contiene le seguenti modifiche, che interessano sia l'API YouTube Reporting sia l'API YouTube Analytics:

API YouTube Reporting

  • La dimensione playback_location_type supporta due nuovi valori:
    • 7: i dati si riferiscono alle visualizzazioni avvenute sulla home page di YouTube o sulla schermata Home, nel feed Iscrizioni dell'utente o in un'altra funzionalità di navigazione di YouTube.
    • 8: i dati si riferiscono alle visualizzazioni avvenute direttamente nella pagina dei risultati di ricerca di YouTube.
  • La dimensione traffic_source_type ora supporta 18 come valore della dimensione. Questo valore indica che le visualizzazioni del video provengono da una pagina che elenca tutti i video di una playlist. Questa origine è diversa dal tipo di origine 14, che indica che le visualizzazioni si sono verificate durante la riproduzione del video all'interno di una playlist.

API YouTube Analytics

  • La dimensione insightPlaybackLocationType supporta due nuovi valori:
    • BROWSE: i dati si riferiscono alle visualizzazioni avvenute sulla home page di YouTube o sulla schermata Home, nel feed Iscrizioni dell'utente o in un'altra funzionalità di navigazione di YouTube.
    • SEARCH: i dati si riferiscono alle visualizzazioni avvenute direttamente nella pagina dei risultati di ricerca di YouTube.
  • La dimensione insightTrafficSourceType ora supporta YT_PLAYLIST_PAGE come valore della dimensione. Questo valore indica che le visualizzazioni del video provengono da una pagina che elenca tutti i video di una playlist. Questa sorgente è diversa dal tipo di sorgente PLAYLIST, che indica che le visualizzazioni si sono verificate durante la riproduzione del video all'interno di una playlist.

8 febbraio 2016

L'elenco delle metriche supportate per l'API YouTube Analytics è stato aggiornato in modo che le metriche delle schede non siano più elencate come metriche supportate per l'API. (Nessuno dei report di questa API è stato documentato come supportato da una delle metriche della scheda).

Tieni presente che puoi comunque recuperare le metriche delle schede utilizzando l'API di reporting di YouTube, che supporta queste metriche per numerosi report relativi a canali e proprietari dei contenuti.

6 gennaio 2016

L'API di reporting di YouTube e l'API YouTube Analytics ora identificano in modo specifico le visualizzazioni che avvengono tramite un dispositivo Chromecast.

  • Nell'API YouTube Reporting, la dimensione operating_system utilizza il valore 21 per identificare le visualizzazioni che avvengono tramite Chromecast.
  • Nell'API YouTube Analytics, la dimensione operatingSystem utilizza il valore CHROMECAST per identificare le visualizzazioni che avvengono tramite Chromecast.

21 dicembre 2015

Nella documentazione, i nomi delle metriche annotation_clickable_impressions e annotation_closable_impressions sono stati aggiornati in modo che corrispondano ai nomi restituiti nei report. In precedenza, i nomi erano documentati come clickable_annotation_impressions e closable_annotation_impressions.

18 dicembre 2015

Le leggi dell'Unione Europea (UE) impongono che gli utenti finali residenti nell'UE ricevano determinate informative e forniscano il loro consenso. Pertanto, per gli utenti finali nell'Unione Europea, devi rispettare le Norme relative al consenso degli utenti dell'UE. Abbiamo aggiunto una nota relativa a questo requisito nei nostri Termini di servizio delle API di YouTube.

15 dicembre 2015

Questo aggiornamento contiene le seguenti modifiche, che interessano tutte l'API YouTube Analytics:

  • L'API YouTube Analytics ora supporta tre nuove dimensioni dei dettagli di riproduzione, che possono essere utilizzate in una serie di report per canali e proprietari dei contenuti:

    • liveOrOnDemand: questa dimensione indica se i dati nel report descrivono l'attività utente che si è verificata durante una trasmissione live.
    • subscribedStatus: questa dimensione indica se le metriche relative all'attività utente nei dati sono associate agli spettatori iscritti al canale del video o della playlist.
    • youtubeProduct: questa dimensione identifica la proprietà di YouTube su cui si è verificata l'attività utente. I valori possibili includono il sito web principale di YouTube (o l'app YouTube), YouTube Gaming e YouTube Kids.

    La documentazione è stata aggiornata per identificare i nuovi report dettagliati sulla riproduzione disponibili per i canali e i proprietari dei contenuti. Inoltre, molti altri report sono stati aggiornati per indicare che una o più di queste dimensioni possono essere utilizzate facoltativamente come dimensioni e/o filtri in questi report.

  • Il formato delle tabelle che spiegano i report è stato modificato per semplificare l'identificazione delle combinazioni valide di dimensioni, metriche e filtri che possono essere utilizzate per recuperare ogni report. La seguente tabella, che spiega il report "Tipo di dispositivo" per i canali, mostra il nuovo formato:

    Proprietà Valore
    Dimensioni:
    Obbligatorio deviceType
    Utilizza 0 o più day, liveOrOnDemand, subscribedStatus, youtubeProduct
    Metriche:
    Utilizza 1 o più views, estimatedMinutesWatched
    Filtri:
    Utilizza 0 o 1 country, province, continent, subContinent
    Utilizza 0 o 1 video, gruppo
    Utilizza 0 o più operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

    La terminologia che descrive i campi obbligatori e facoltativi è spiegata nella documentazione relativa ai report sul canale e sul proprietario dei contenuti.

  • L'API YouTube Analytics ora elimina automaticamente le entità per le quali l'utente dell'API non può recuperare i dati dai filtri che supportano più valori (video, playlist e channel). In precedenza, il server API restituiva un errore se l'utente dell'API non poteva accedere ai dati per almeno uno degli elementi specificati.

    Ad esempio, supponiamo che un utente invii una richiesta API in cui il filtro video elenca 20 ID video. L'utente è proprietario di 18 video. Tuttavia, un ID video identifica un video di proprietà di un altro canale e un altro ID identifica un video che è stato eliminato e, pertanto, non esiste più. In questo caso, anziché restituire un errore, il server API elimina i due video a cui l'utente non può accedere e la risposta dell'API contiene i dati dei 18 video di proprietà dell'utente dell'API.

  • Se richiedi dati per un group di YouTube Analytics vuoto, l'API ora restituisce un set di dati vuoto anziché un errore.

  • Il metodo groupItems.insert dell'API YouTube Analytics ora restituisce un errore di mancata autorizzazione (codice di risposta HTTP 403) se provi ad aggiungere un'entità a un gruppo, ma non hai accesso a quell'entità. In precedenza, l'API ti avrebbe consentito di aggiungere l'entità al gruppo, ma in seguito avrebbe restituito un errore di mancata autorizzazione quando provavi a recuperare i dati del report per quel gruppo.

  • Il metodo groups.list dell'API YouTube Analytics ora supporta l'impaginazione. Se la risposta dell'API non contiene tutti i gruppi disponibili, il parametro nextPageToken della risposta specifica un token che può essere utilizzato per recuperare la pagina di risultati successiva. Imposta il parametro pageToken del metodo su questo valore per recuperare altri risultati.

10 novembre 2015

Questo aggiornamento contiene le seguenti modifiche:

29 ottobre 2015

Questo aggiornamento contiene le seguenti modifiche:

  • La documentazione relativa alla dimensione date dell'API YouTube Reporting è stata corretta per indicare che le date fanno riferimento al periodo di 24 ore che inizia alle 00:00 (fuso orario del Pacifico, UTC-8). In precedenza, la documentazione indicava che la data iniziava alle 00:00 (GMT).

    Inoltre, la documentazione dell'API YouTube Analytics è stata aggiornata per indicare che tutte le dimensioni relative alle date (day, 7DayTotals, 30DayTotals e month) si riferiscono a date che iniziano alle 00:00 ora del Pacifico (UTC-8).

  • Il metodo jobs.reports.list() dell'API YouTube Reporting ora supporta il parametro di query createdAfter. Se specificato, questo parametro indica che la risposta dell'API deve elencare solo i report creati dopo la data e l'ora specificate, inclusi i nuovi report con dati di backfill. Tieni presente che il valore parametro si riferisce al momento in cui viene creato il report e non alle date associate ai dati restituiti.

    Il valore parametro è un timestamp in formato "Zulu" UTC RFC3339, con precisione al microsecondo. Esempio: "2015-10-02T15:01:23.045678Z".

    Anche le best practice dell'API YouTube Reporting sono state aggiornate per spiegare come utilizzare il parametro createdAfter per evitare di elaborare ripetutamente lo stesso report.

  • Le definizioni della proprietà createTime della risorsa job e delle proprietà startTime, endTime e createTime della risorsa report sono state tutte corrette per indicare che i valori delle proprietà sono accurati al microsecondo, non al nanosecondo. Inoltre, ora tutte le definizioni indicano con precisione che il valore della proprietà è un timestamp.

8 ottobre 2015

Questo aggiornamento contiene le seguenti modifiche:

  • La documentazione relativa alla dimensione sharingService dell'API YouTube Analytics è stata aggiornata per includere un elenco di possibili valori della dimensione. L'elenco include una serie di servizi supportati di recente.

    Anche la definizione della dimensione sharing_service dell'API YouTube Reporting è stata aggiornata per elencare i valori supportati di recente. I valori enum maggiori di 59 sono i nuovi valori nell'elenco.

24 settembre 2015

Questo aggiornamento contiene le seguenti modifiche:

  • La nuova API di reporting di YouTube recupera i report sui dati collettivi che contengono i dati di YouTube Analytics relativi a un canale o a un proprietario dei contenuti. È progettato per le applicazioni che possono importare set di dati di grandi dimensioni e che forniscono strumenti per filtrare, ordinare ed estrarre i dati.

    Ogni report dell'API YouTube Reporting contiene un insieme predefinito di dimensioni e metriche. Anche i report dell'API YouTube Analytics utilizzano metriche e dimensioni. In un report, ogni riga di dati ha una combinazione univoca di valori di dimensione. Puoi aggregare i dati tra le righe in base ai valori delle dimensioni per calcolare le metriche per singoli video, paesi, video in diretta, utenti iscritti e così via.

    Puoi utilizzare l'API per pianificare i job di generazione dei report, ognuno dei quali identifica un report che YouTube deve generare. Una volta configurato un job, YouTube genera un report giornaliero che può essere scaricato in modo asincrono. Ogni report contiene dati relativi a un periodo univoco di 24 ore.

  • Sebbene siano API diverse, l'API YouTube Analytics e l'API di reporting di YouTube consentono entrambe agli sviluppatori di recuperare i dati di YouTube Analytics. Poiché entrambe le API forniscono l'accesso a set di dati simili, la documentazione per le due API viene pubblicata come un unico set di documentazione.

    • La scheda Guide nel set di documentazione contiene informazioni comuni a entrambe le API, incluse le istruzioni per autorizzare le richieste API.
    • La scheda Report collettivi contiene la documentazione di riferimento e altri contenuti specifici per l'API di reporting di YouTube.
    • La scheda Query mirate contiene la documentazione di riferimento e altri contenuti specifici per l'API YouTube Analytics.
    • La scheda Esempi elenca gli esempi di codice disponibili per una delle due API.
    • La scheda Strumenti elenca le risorse aggiuntive disponibili per aiutare gli sviluppatori a implementare una delle due API.

20 agosto 2015

Questo aggiornamento contiene le seguenti modifiche:

  • La documentazione dell'API è stata ristrutturata per renderla più comprensibile. Pertanto, queste modifiche non descrivono nuove funzionalità:

    • La documentazione ora contiene una pagina che elenca tutti i report sul canale disponibili e un'altra che elenca tutti i report del proprietario dei contenuti disponibili. In precedenza, la documentazione conteneva pagine separate per i report sui video del canale, i report sulle playlist del canale e così via.

    • La nuova panoramica del modello di dati mira a fornire un'introduzione più chiara al funzionamento dell'API. In particolare, questo documento cerca di spiegare meglio in che modo YouTube utilizza metriche, dimensioni e filtri per calcolare i valori dei report.

    • Il metodo reports.query dell'API, che utilizzi per recuperare i report, è ora documentato separatamente. Le informazioni su quella pagina erano precedentemente presenti in altre pagine. La nuova pagina è progettata per aiutarti a identificare più facilmente le informazioni che devi inviare per recuperare un report.

22 luglio 2015

Questo aggiornamento contiene diverse modifiche, tutte applicabili solo ai proprietari dei contenuti:

  • La nuova metrica adEarnings include il totale degli utili stimati (entrate nette) provenienti da tutte le origini pubblicitarie vendute da Google. Non è una metrica principale. L'API supporta la metrica adEarnings per qualsiasi report che supportava già la metrica earnings.

    Inoltre, la definizione della metrica earnings è stata corretta per riflettere il fatto che il suo valore include il totale utili stimati di tutte le origini annuncio vendute da Google e delle origini non pubblicitarie. In precedenza, la definizione indicava erroneamente che la metrica includeva solo gli utili provenienti da origini pubblicitarie.

  • La metrica primaryAdGrossRevenue è stata ritirata. Utilizza invece la metrica grossRevenue per recuperare i dati sulle entrate.

  • Oltre alla metrica primaryAdGrossRevenue ritirata, i report sul rendimento degli annunci non supportano più le metriche monetizedPlaybacks e playbackBasedCpm. Tuttavia, diversi report video supportano ancora queste metriche.

1° giugno 2015

Questo aggiornamento contiene le seguenti modifiche:

  • L'API ora supporta due nuove metriche per i report sui video: videosAddedToPlaylists e videosRemovedFromPlaylists. Gli elenchi dei report sui video per i canali e i proprietari dei contenuti sono stati aggiornati per identificare i report che supportano le nuove metriche.

    • videosAddedToPlaylists: il numero di volte in cui i video nell'ambito della query sono stati aggiunti a una playlist di YouTube. I video potrebbero essere stati aggiunti alla playlist del proprietario del video o alle playlist di altri canali.
    • videosRemovedFromPlaylists: il numero di volte in cui i video nell'ambito della query sono stati rimossi da qualsiasi playlist di YouTube. I video potrebbero essere stati rimossi dalla playlist del proprietario del video o dalle playlist di altri canali.

    Entrambe le metriche includono le playlist predefinite, come "Guarda più tardi". Tuttavia, non vengono conteggiate le playlist a cui un video viene aggiunto automaticamente, come la playlist dei caricamenti di un canale o la cronologia delle visualizzazioni di un utente. Tieni presente che queste metriche riflettono il numero assoluto di aggiunte ed eliminazioni. Pertanto, se un utente aggiunge un video a una playlist, lo rimuove e poi lo aggiunge di nuovo, le metriche indicano che il video è stato aggiunto a due playlist e rimosso da una.

    I dati relativi a queste metriche sono disponibili dal 1° ottobre 2014.

31 marzo 2015

Questo aggiornamento contiene le seguenti modifiche:

16 marzo 2015

Questo aggiornamento contiene le seguenti modifiche:

  • Il nuovo parametro currency consente di recuperare le metriche relative agli utili in una valuta diversa dai dollari statunitensi (USD). Se il parametro è impostato, l'API converte i valori delle metriche earnings, grossRevenue, playbackBasedCpm e impressionBasedCpm nella valuta specificata. I valori restituiti sono stime calcolate utilizzando tassi di cambio che cambiano su base giornaliera.

    Il valore parametro è un codice valuta ISO 4217 di tre lettere. Il valore predefinito è USD. La definizione del parametro contiene un elenco di codici valuta supportati.

25 febbraio 2015

Questo aggiornamento contiene le seguenti modifiche:

  • L'API ora supporta la possibilità di creare e gestire i gruppi di YouTube Analytics, nonché di recuperare i dati dei report per questi gruppi.

    • Creare e gestire i gruppi

      Questo aggiornamento introduce le risorse group e groupItem per la creazione e la gestione dei gruppi.

      • La risorsa group rappresenta un gruppo di Analytics, una raccolta personalizzata di un massimo di 200 canali, video, playlist o risorse. L'API supporta i metodi list, insert, update e delete per questa risorsa.
      • La risorsa groupItem rappresenta un elemento in un gruppo di Analytics. L'API supporta i metodi list, insert e delete per questa risorsa.

      Ad esempio, puoi creare un gruppo utilizzando il metodo groups.insert e poi aggiungere elementi al gruppo utilizzando il metodo groupItems.insert.

    • Recupero dei dati dei report per un gruppo

      La documentazione sulle dimensioni è stata aggiornata per includere la dimensione group, che può essere utilizzata come filtro per molti report sui canali e report sui proprietari dei contenuti. Quando utilizzi il filtro group, l'API restituisce i dati per tutti gli elementi del gruppo. Tieni presente che l'API al momento non supporta la possibilità di creare report per i gruppi di asset.

    Per saperne di più sui gruppi di YouTube Analytics, consulta il Centro assistenza YouTube.

13 febbraio 2015

Questo aggiornamento contiene le seguenti modifiche:

  • L'API non supporta più la dimensione show.

28 agosto 2014

Questo aggiornamento contiene le seguenti modifiche:

  • L'API ora supporta la possibilità di specificare più valori per le dimensioni video, playlist, channel e show quando queste dimensioni vengono utilizzate come filtri. Per specificare più valori, imposta il valore del parametro filters su un elenco separato da virgole degli ID video, playlist, canale o programma per cui deve essere filtrata la risposta dell'API. Il valore parametro può specificare fino a 200 ID.

    Se specifichi più valori per lo stesso filtro, puoi anche aggiungere questo filtro all'elenco delle dimensioni che specifichi per la richiesta. Questo vale anche se il filtro non è elencato come dimensione supportata per un determinato report. Se aggiungi il filtro all'elenco delle dimensioni, l'API utilizza anche i valori del filtro per raggruppare i risultati.

    Per informazioni dettagliate su questa funzionalità, consulta la definizione del parametro filters.

16 luglio 2014

Questo aggiornamento contiene le seguenti modifiche:

  • Quando recuperi un report sul canale, ora puoi recuperare i dati per il canale dell'utente autenticato impostando il valore del parametro ids su channel==MINE. Puoi anche impostare il parametro ids su channel==CHANNEL_ID per recuperare i dati per il canale specificato.

  • L'API ora supporta i report sulle playlist, che contengono statistiche relative alle visualizzazioni dei video che si verificano nel contesto di una playlist. I report sulle playlist sono disponibili per i canali e i proprietari dei contenuti.

    Tutti i report sulle playlist supportano le metriche views e estimatedMinutesWatched, mentre alcuni supportano anche la metrica averageViewDuration.

    Inoltre, tutti i report sulle playlist supportano le seguenti nuove metriche. Tieni presente che ciascuna di queste metriche riflette solo le visualizzazioni delle playlist avvenute sul web.

    • playlistStarts: il numero di volte che gli spettatori hanno avviato la riproduzione di una playlist.
    • viewsPerPlaylistStart: il numero medio di visualizzazioni video che si sono verificate ogni volta che è stata avviata una playlist.
    • averageTimeInPlaylist: il tempo medio stimato, in minuti, che uno spettatore ha trascorso a guardare i video di una playlist dopo l'avvio della playlist.

    Qualsiasi richiesta di recupero di un report sulle playlist deve utilizzare il filtro isCurated, che deve essere impostato su 1 (isCurated==1).

  • L'API ora supporta un report Fidelizzazione del pubblico. Questo report misura la capacità di un video di fidelizzare il pubblico. La nuova dimensione elapsedVideoTimeRatio del report misura la quantità di video trascorsa per i valori delle metriche corrispondenti:

    • La metrica audienceWatchRatio identifica la percentuale assoluta di spettatori che guardano il video in un determinato punto. Il rapporto viene calcolato confrontando il numero di volte in cui una parte di un video è stata guardata con il numero totale di visualizzazioni del video.

      Tieni presente che una parte di un video potrebbe essere guardata più di una volta (o non essere guardata affatto) in una determinata visualizzazione del video. Ad esempio, se gli utenti riavvolgono e guardano più volte la stessa parte di un video, il rapporto assoluto per quella parte del video potrebbe essere superiore a 1.

    • La metrica relativeRetentionPerformance mostra la capacità di un video di fidelizzare gli spettatori durante le riproduzioni rispetto a tutti i video di YouTube di durata simile. Un valore pari a 0 indica che il video fidelizza gli spettatori peggio di qualsiasi altro video di durata simile, mentre un valore pari a 1 indica che il video fidelizza gli spettatori meglio di qualsiasi altro video di durata simile. Un valore mediano di 0,5 indica che la metà dei video di durata simile fidelizza meglio gli spettatori, mentre l'altra metà li fidelizza peggio.

    Puoi anche utilizzare il filtro audienceType in modo che il report restituisca solo i dati associati alle visualizzazioni organiche, alle visualizzazioni degli annunci TrueView in-stream o alle visualizzazioni degli annunci TrueView in-display. Le visualizzazioni organiche sono il risultato diretto di un'azione dell'utente, ad esempio la ricerca di un video o un clic su un video consigliato.

  • L'API supporta diverse nuove metriche relative alle annotazioni. Le metriche elencate di seguito possono essere recuperate con qualsiasi report che in precedenza supportava le metriche annotationClickThroughRate e annotationCloseRate.

    Tutte le nuove metriche sono metriche principali e sono soggette alle norme sul ritiro. Tuttavia, tieni presente che i dati sono disponibili per le nuove metriche a partire dal 16 luglio 2013. (I dati relativi alle metriche annotationClickThroughRate e annotationCloseRate sono disponibili a partire dal 10 giugno 2012.)

  • GOOGLE_SEARCH non viene più registrato come valore separato per la dimensione insightTrafficSourceType. Ora i referral dai risultati di ricerca di Google vengono attribuiti al tipo di sorgente di traffico EXT_URL. Di conseguenza, non è più possibile recuperare un report insightTrafficSourceDetail che imposta il filtro insightTrafficSourceType su GOOGLE_SEARCH.

31 gennaio 2014

Questo aggiornamento contiene le seguenti modifiche:

16 gennaio 2014

Questo aggiornamento contiene le seguenti modifiche:

  • Il documento con le richieste di esempio è stato riprogettato per raggruppare gli esempi in categorie, utilizzando un formato a schede simile a quello rilasciato di recente per i report sui canali e sui proprietari dei contenuti. Con il nuovo design, gli esempi sono raggruppati nelle seguenti categorie:

    • Statistiche di base
    • In base al tempo
    • Geografico
    • Luogo di visualizzazione
    • Sorgente di traffico
    • Dispositivo/sistema operativo
    • Gruppo demografico
    • Social
    • Utili/Annunci (solo per i report dei proprietari dei contenuti)

  • Il documento sulle richieste di esempio ora include nuovi esempi per il recupero di dati specifici per provincia nei report sul canale o nei report sul proprietario dei contenuti.

    • Metriche specifiche per provincia per gli stati degli Stati Uniti e Washington D.C.: Questo report recupera una suddivisione per provincia del numero di visualizzazioni e di altre statistiche per i video di un canale. I dati coprono gli stati degli Stati Uniti e Washington D.C. L'esempio utilizza la dimensione province e il parametro filters per limitare la risposta in modo da includere solo i risultati per gli Stati Uniti.

    • Dati demografici degli spettatori in California (fascia d'età e genere): questo report recupera le statistiche relative alla fascia d'età e al genere degli spettatori in California che hanno guardato i video di un canale o, nel caso dei report dei proprietari dei contenuti, i contenuti rivendicati di un proprietario dei contenuti. Questo esempio utilizza il parametro filters per garantire che la risposta includa solo i dati di una determinata provincia.

  • La definizione della dimensione province è stata aggiornata per indicare che, quando province è incluso nel valore parametro dimensions, la richiesta deve anche limitare i dati agli Stati Uniti includendo country==US nel valore parametro filters.

6 gennaio 2014

Questo aggiornamento contiene le seguenti modifiche:

  • I documenti che elencano i report supportati per i canali e i proprietari dei contenuti sono stati riprogettati. Anziché fornire una tabella che elenca tutti i report possibili, ogni documento raggruppa i report in categorie:

    • Statistiche di base
    • In base al tempo
    • Geografico
    • Luogo di visualizzazione
    • Sorgente di traffico
    • Dispositivo/sistema operativo
    • Gruppo demografico
    • Social
    • Video principali

    Ogni documento mostra queste categorie come un elenco di schede. Puoi fare clic su qualsiasi scheda per visualizzare i report supportati in quella categoria.

  • L'API ora supporta tre nuove dimensioni geografiche: province, continent e subContinent.

    • La dimensione province ti consente di recuperare le statistiche per gli stati degli Stati Uniti e per il Distretto di Columbia. L'API supporta due utilizzi per questa dimensione:

      • L'API supporta due report che suddividono le statistiche in base allo stato. Entrambi i report sono disponibili per i canali e i proprietari dei contenuti.

        • Il report Statistiche principali fornisce diverse statistiche, tra cui il numero di visualizzazioni e i minuti di visualizzazione stimati.
        • Il report basato sul tempo fornisce le stesse statistiche, ma aggrega i dati su base giornaliera, di 7 giorni, di 30 giorni o mensile.

      • Puoi utilizzare il parametro di query filters per limitare un report in modo che contenga solo le statistiche relative a uno stato specifico. Diversi report supportano questo tipo di filtro, tra cui i report geografici, i report sulle località di riproduzione, i report sulle sorgenti di traffico, i report sui dispositivi, i report sui sistemi operativi, i report sulle categorie demografiche e i report sui video principali.

    • La dimensione continent specifica un codice regione statistico delle Nazioni Unite (ONU) che identifica un continente. Questa dimensione può essere utilizzata solo come filtro.

    • La dimensione subContinent specifica un codice di regione statistica delle Nazioni Unite (ONU) che identifica una sottoregione di un continente. Anche questa dimensione può essere utilizzata solo come filtro.

      Poiché ogni regione secondaria è associata a un solo continente, non è necessario utilizzare anche il filtro continent quando utilizzi il filtro subContinent. (In effetti, l'API restituirà un errore se una richiesta utilizza entrambe le dimensioni).

  • La documentazione è stata corretta in modo che la dimensione insightTrafficSourceDetail non includa il valore insightTrafficSourceType PROMOTED come valore di filtro valido.

30 settembre 2013

Questo aggiornamento contiene le seguenti modifiche:

  • L'API YouTube Analytics è ora soggetta alle norme sul ritiro descritte nei Termini di servizio. Tuttavia, le dimensioni e le metriche non principali dell'API non sono soggette alle norme sul ritiro. Le pagine relative alle dimensioni e alle metriche sono state aggiornate per elencare le dimensioni e le metriche principali. Inoltre, le definizioni in queste pagine sono state aggiornate per identificare esplicitamente le dimensioni e le metriche principali.

  • L'API ora supporta EXTERNAL_APP come valore per la dimensione insightPlaybackLocationType. In concomitanza con questo aggiornamento, a partire dal 10 settembre 2013, le riproduzioni non vengono più classificate come riproduzioni MOBILE, anche se le riproduzioni su dispositivi mobili avvenute prima di questa data verranno comunque classificate con questo valore.

    Con questo aggiornamento, le riproduzioni su dispositivi mobili vengono ora classificate come riproduzioni WATCH, EMBEDDED o EXTERNAL_APP, a seconda del tipo di applicazione in cui si verificano.

  • L'API ora supporta PLAYLIST come valore per la dimensione insightTrafficSourceType. Il valore indica che le visualizzazioni del video sono state generate da una playlist. In precedenza, queste visualizzazioni sarebbero state classificate utilizzando la categoria YT_OTHER_PAGE della dimensione.

16 luglio 2013

Questo aggiornamento contiene le seguenti modifiche:

  • L'API ora supporta la possibilità di ordinare i report in base a più dimensioni e metriche. Il documento delle richieste di esempio contiene un nuovo esempio, Ordinamento delle richieste in base a più dimensioni/metriche, che illustra questa funzionalità. La richiesta recupera i dati della sorgente di traffico e ha un valore parametro sort pari a day,-views. I risultati sono ordinati cronologicamente, ma all'interno del set di risultati per ogni giorno, la prima riga contiene i dati relativi alla sorgente di traffico che ha generato il maggior numero di visualizzazioni, la seconda riga contiene i dati relativi alla sorgente che ha generato il secondo numero più alto di visualizzazioni e così via.

  • L'API ora supporta due nuove dimensioni, deviceType e operatingSystem, che possono essere utilizzate per recuperare i dati sui dispositivi su cui gli spettatori guardano i tuoi video. L'API supporta i report che utilizzano una o entrambe le dimensioni.

    • Il report deviceType ti consente di recuperare il numero di visualizzazioni e il tempo di visualizzazione stimato per diversi tipi di dispositivi, tra cui computer, dispositivi mobili e tablet. Puoi anche utilizzare il filtro operatingSystem per limitare il report sul tipo di dispositivo in modo che contenga solo le statistiche relative ai dispositivi con un sistema operativo specifico, ad esempio Android o iOS.

    • Il report operatingSystem ti consente di recuperare il numero di visualizzazioni e il tempo di visualizzazione stimato per diversi sistemi operativi, come Android, iOS, Linux e altri. Puoi anche utilizzare il filtro deviceType per limitare il report sui sistemi operativi in modo che contenga solo le statistiche per un tipo specifico di dispositivo, ad esempio dispositivi mobili o tablet.

    I nuovi report sui tipi di dispositivi e sui sistemi operativi sono disponibili per i canali e per i proprietari dei contenuti.

  • Il documento Richieste di esempio è stato aggiornato per includere tre report sui dispositivi per i canali e tre report sui dispositivi per i proprietari dei contenuti.

  • La dimensione insightPlaybackLocationType potrebbe restituire il valore YT_OTHER, che identifica le visualizzazioni non classificate utilizzando uno degli altri valori della dimensione.

23 maggio 2013

Questo aggiornamento contiene le seguenti modifiche:

10 maggio 2013

Questo aggiornamento contiene le seguenti modifiche:

6 maggio 2013

Questo aggiornamento contiene le seguenti modifiche:

  • L'API ora supporta la possibilità di recuperare le metriche relative al tempo di visualizzazione (estimatedMinutesWatched, averageViewDuration e averageViewPercentage) insieme ad altre metriche, tra cui quelle relative alle visualizzazioni, al coinvolgimento, agli utili e al rendimento degli annunci.

    Gli elenchi dei report sui canali e dei report sui proprietari dei contenuti disponibili sono stati aggiornati per riflettere questa variazione. (Gli elenchi sono in realtà più brevi ora, poiché le metriche relative al tempo di visualizzazione possono essere recuperate nell'ambito di altri report elencati).

    Anche il documento Richieste API di esempio è stato aggiornato.

  • I report che utilizzano le dimensioni insightPlaybackLocationDetail e insightTrafficSourceDetail sono stati migliorati nei seguenti modi:

    • Ora supportano un filtro country facoltativo.

    • I proprietari dei contenuti ora possono recuperare questi report utilizzando una delle seguenti nuove combinazioni di filter. Tieni presente che tutte queste combinazioni supportano anche il filtro facoltativo country.

      • Dettagli sulla posizione di riproduzione

        • channel,insightPlaybackLocationType==EMBEDDED
        • show,insightPlaybackLocationType==EMBEDDED
        • claimedStatus,insightPlaybackLocationType==EMBEDDED
        • uploaderType,insightPlaybackLocationType==EMBEDDED
        • uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED

      • Dettagli sulla sorgente di traffico

        • channel,insightTrafficSourceType
        • show,insightTrafficSourceType
        • claimedStatus,insightTrafficSourceType
        • uploaderType,insightTrafficSourceType
        • uploaderType,claimedStatus,insightTrafficSourceType

3 maggio 2013

Questo aggiornamento contiene le seguenti modifiche:

  • Il nuovo documento Richieste API di esempio fornisce esempi che mostrano come recuperare molti tipi diversi di report utilizzando YouTube Analytics API. Ogni esempio include una breve descrizione del report recuperato dalla richiesta e mostra le dimensioni, le metriche, i filtri e i parametri di ordinamento della richiesta.

  • La dimensione insightTrafficSourceType ora supporta SUBSCRIBER come valore valido. Questo valore identifica le visualizzazioni dei video provenienti dai feed della home page di YouTube o dalle funzionalità di iscrizione di YouTube. Se filtri in base a questa sorgente di traffico, il campo insightTrafficSourceDetail specificherà il feed della home page o un'altra pagina da cui sono state indirizzate le visualizzazioni.

28 marzo 2013

Questo aggiornamento contiene le seguenti modifiche:

21 marzo 2013

Questo aggiornamento contiene le seguenti modifiche:

  • L'API ora supporta le metriche relative agli utili e al rendimento degli annunci, nonché i nuovi report sul rendimento degli annunci. Le metriche e i report sono accessibili solo ai partner di contenuti di YouTube che partecipano al Programma partner di YouTube.

    • I report appena supportati supportano le metriche sul rendimento degli annunci basate sulla riproduzione e quelle basate sulle impressioni. Per saperne di più sui report sul rendimento degli annunci, consulta la documentazione relativa ai report per i proprietari dei contenuti.

    • Le nuove metriche supportate sono elencate di seguito. L'elenco dei report del proprietario dei contenuti è stato aggiornato per identificare i report, inclusi i due nuovi report, che supportano queste metriche.

      • earnings: totale utili stimati da tutte le origini pubblicitarie vendute da Google.
      • grossRevenue: entrate lorde stimate dei partner di Google o DoubleClick.
      • primaryAdGrossRevenue: entrate lorde stimate, sommate e classificate in base al tipo di annuncio principale per le riproduzioni video incluse nel report, provenienti da Google o dai partner DoubleClick.
      • monetizedPlaybacks: il numero di riproduzioni che hanno mostrato almeno un'impressione dell'annuncio.
      • playbackBasedCpm: entrate lorde stimate per mille riproduzioni.
      • impressions: il numero di impressioni dell'annuncio verificate pubblicate.
      • impressionBasedCpm: entrate lorde stimate per mille impressioni dell'annuncio.

      Nota: per informazioni dettagliate, consulta le definizioni delle metriche.

    • Qualsiasi richiesta che recupera gli utili o le metriche sul rendimento degli annunci deve inviare un token di autorizzazione che concede l'accesso utilizzando il nuovo ambito https://www.googleapis.com/auth/yt-analytics-monetary.readonly.

  • La documentazione dell'API è stata riorganizzata in modo che i diversi tipi di report siano spiegati in pagine separate. Pertanto, ora sono disponibili pagine separate che spiegano i diversi tipi di report sui canali e report sui proprietari dei contenuti.

4 febbraio 2013

Questo aggiornamento contiene le seguenti modifiche:

  • La guida di riferimento dell'API ora include una sezione esempi, che contiene esempi di codice che mostrano come chiamare l'API utilizzando le librerie client Java, JavaScript, Python e Ruby. L'esempio di codice JavaScript è lo stesso descritto in dettaglio nella documentazione dell'applicazione di esempio.

14 novembre 2012

Questo aggiornamento contiene le seguenti modifiche:

  • La guida di riferimento dell'API ora include APIs Explorer, che ti consente di chiamare l'API, visualizzare la richiesta API e recuperare i dati reali nella risposta.

  • L'API supporta una serie di nuovi report sia per i canali sia per i proprietari dei contenuti, descritti di seguito. Ogni report è disponibile come report sul canale o report sul proprietario dei contenuti. Anche le pagine relative alle dimensioni e alle metriche sono state aggiornate di conseguenza.

    • Il report sulle posizioni di riproduzione specifica il numero di visualizzazioni di video che si sono verificate su diversi tipi di pagine o applicazioni.

    • Il report dettagliato sulla posizione di riproduzione identifica i player incorporati che hanno generato il maggior numero di visualizzazioni per un video specifico. Fornisce una visualizzazione più dettagliata rispetto al report sulle località di riproduzione identificando gli URL associati ai principali player incorporati.

    • Il report sulle sorgenti di traffico identifica il numero di visualizzazioni di video provenienti da diversi tipi di referrer.

    • Il report dettagliato sulle sorgenti di traffico identifica i referrer che hanno generato il maggior numero di visualizzazioni per un video e un tipo di sorgente di traffico specifici. Ad esempio, questo report potrebbe mostrare i video correlati che hanno inviato più traffico a un video specifico. Questo report è supportato per diverse sorgenti di traffico.

    • I report sul tempo di visualizzazione forniscono la quantità di tempo che gli spettatori hanno trascorso a guardare i tuoi contenuti. I report possono aggregare i dati per un periodo di tempo specifico (giorno, sette giorni precedenti, 30 giorni precedenti e così via) o per paese. Se un report aggrega i dati per giorno o per paese, può anche specificare la durata media di ogni visualizzazione di video, nonché la percentuale media di ogni video guardata dagli utenti.

2 ottobre 2012

Questo aggiornamento contiene le seguenti modifiche:

  • YouTube Analytics API è ora disponibile per tutti gli sviluppatori. Puoi attivare l'API per il tuo progetto, senza dover prima richiedere l'accesso, dal riquadro Servizi in APIs console.

  • La nuova sezione Inizia descrive i prerequisiti e i passaggi di base per creare un'applicazione che utilizza l'YouTube Analytics API.

12 settembre 2012

Questo aggiornamento contiene le seguenti modifiche:

  • La nuova sezione Informazioni sull'utilizzo della quota fornisce linee guida per ottimizzare l'utilizzo della quota dell'API. Il server API calcola un costo di query per ogni richiesta, che viene detratto dalla quota di utilizzo dell'API. Poiché i diversi tipi di report possono avere costi di query molto diversi, devi pianificare l'utilizzo della quota in modo efficiente e la tua applicazione deve richiedere solo le metriche e i dati di cui ha effettivamente bisogno.

  • La sezione Dimensioni temporali è stata aggiornata per spiegare che queste dimensioni indicano che un report di Analytics deve aggregare i dati in base a un periodo di tempo. L'API ora supporta le seguenti dimensioni temporali aggiuntive:

    • 7DayTotals: i dati nel report verranno aggregati in modo che ogni riga contenga i dati relativi a un periodo di sette giorni.
    • 30DayTotals: i dati nel report verranno aggregati in modo che ogni riga contenga i dati relativi a un periodo di 30 giorni.
    • month: i dati nel report verranno aggregati per mese di calendario.

    Analogamente, la sezione Report disponibili è stata aggiornata per riflettere il supporto dell'API per i report che utilizzano queste dimensioni.

  • La sezione Dimensioni delle entità di reporting è stata aggiornata per indicare che le richieste API per recuperare i report del proprietario dei contenuti devono filtrare i dati utilizzando una di queste dimensioni (video, channel o show) o una combinazione supportata delle dimensioni claimedStatus e uploaderType.

  • L'API ora supporta due nuove opzioni di ordinamento per i report sui video principali. Questi report, disponibili come report sul canale o report sul proprietario dei contenuti, contengono metriche (visualizzazioni, commenti, Mi piace e così via) per paese e le suddividono per video. Ora puoi ordinare questi report in base al numero di utenti che si sono iscritti o hanno annullato l'iscrizione a un canale dalla pagina di visualizzazione del video.

  • Le definizioni delle metriche subscribersGained e subscribersLost sono state aggiornate per spiegare che un canale può acquisire o perdere iscritti in diversi punti, tra cui la pagina di visualizzazione del video, la pagina del canale e la guida visualizzata nella home page di YouTube. Quando queste metriche vengono visualizzate in un report specifico per un video, includono solo le statistiche della pagina di visualizzazione del video specificato.