API Reference

L'API di YouTube Analytics ti consente di recuperare i dati di YouTube Analytics per un canale YouTube o per un proprietario dei contenuti. L'API supporta le query in tempo reale e genera un report basato sui parametri della richiesta API.

L'API supporta due tipi di funzioni:

  • Recupero dei report: il metodo reports.query dell'API recupera i report di YouTube Analytics.

  • Gestione del gruppo di YouTube Analytics: un gruppo di YouTube Analytics è una raccolta personalizzata di canali, video, playlist o risorse (fino a 500). L'API supporta diversi metodi per creare, recuperare e aggiornare i gruppi di YouTube Analytics. I proprietari dei canali e dei contenuti possono utilizzare il metodo reports.query per recuperare i dati aggregati per tutti gli elementi di un gruppo, che possono facilitare l'analisi del rendimento.

In questa pagina viene fornita una breve panoramica delle risorse e dei metodi dell'API che abilitano queste funzioni.

Autorizzazione

Tutte le richieste all'API di YouTube Analytics devono essere autorizzate. La guida all'autorizzazione spiega come utilizzare il protocollo OAuth 2.0 per recuperare i token di autorizzazione.

Le richieste dell'API YouTube Analytics utilizzano i seguenti ambiti di autorizzazione:

Mirini con ingrandimento
https://www.googleapis.com/auth/yt-analytics.readonly Visualizza i report Analytics su YouTube per i tuoi contenuti di YouTube. Questo ambito fornisce l'accesso alle metriche relative alle attività degli utenti, come il numero di visualizzazioni e di valutazioni.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly Visualizza i report Analytics su YouTube relativi al valore monetario per i tuoi contenuti di YouTube. Questo ambito fornisce l'accesso alle metriche relative all'attività utente e alle entrate stimate e alle metriche sul rendimento degli annunci.
https://www.googleapis.com/auth/youtube Gestisci il tuo account YouTube. Nell'API di YouTube Analytics, i proprietari dei canali utilizzano questo ambito per gestire i gruppi e gli elementi di YouTube Analytics.
https://www.googleapis.com/auth/youtubepartner Visualizzare e gestire le risorse di YouTube e i contenuti associati su YouTube. Nell'API di YouTube Analytics, i proprietari dei contenuti utilizzano questo ambito per gestire gli elementi e i gruppi di YouTube Analytics.

Recupero dei report

Il metodo reports.query dell'API ti consente di recuperare molti report di YouTube Analytics diversi. Ogni richiesta utilizza parametri di ricerca per specificare un ID canale o un proprietario dei contenuti, una data di inizio, una data di fine e almeno una metrica. Puoi anche fornire parametri di ricerca aggiuntivi, come dimensioni, filtri e istruzioni di ordinamento.

Metodo Richiesta HTTP Descrizione
URI relativi a https://youtubeanalytics.googleapis.com/v2
query GET /reports Recupera un report di YouTube Analytics. Ogni richiesta API utilizza i parametri di ricerca per specificare un ID canale o un proprietario dei contenuti, una data di inizio, una data di fine e almeno una metrica. Puoi anche fornire parametri di ricerca aggiuntivi, come dimensioni, filtri o istruzioni di ordinamento.
  • Le metriche sono misurazioni individuali dell'attività degli utenti, ad esempio visualizzazioni o valutazioni dei video (Mi piace e Non mi piace).
  • Le dimensioni sono criteri comuni utilizzati per aggregare i dati, ad esempio la data in cui si è verificata l'attività utente o il paese in cui si trovano. In un report, ogni riga di dati ha una combinazione unica di valori di dimensioni.
  • I filtri sono valori di dimensione che specificano i dati che verranno recuperati. Ad esempio, puoi recuperare i dati relativi a un paese, a un video o a un gruppo di video specifici.
Gli elenchi di report sui canali e report sui proprietari dei contenuti supportati definiscono le combinazioni valide di metriche, dimensioni e filtri.

Gestione dei gruppi

L'API fornisce due risorse per creare e gestire i gruppi di YouTube Analytics:

Gruppi

Una risorsa group rappresenta un gruppo di YouTube Analytics, ovvero una raccolta personalizzata di massimo 500 canali, video, playlist o asset.

Tutti gli elementi di un gruppo devono rappresentare lo stesso tipo di risorsa. Ad esempio, non puoi creare un gruppo che contenga 100 video e 100 playlist.

Un gruppo di Analytics può contenere solo le risorse che hai caricato o rivendicato oppure che sono collegate a un canale che amministri. Di conseguenza, i proprietari dei canali possono creare gruppi di video e playlist. I proprietari dei contenuti possono creare gruppi di video, playlist, canali o risorse.

Per ulteriori informazioni su questa risorsa, consulta la relativa rappresentazione e l'elenco di proprietà.

Metodo Richiesta HTTP Descrizione
URI relativi a https://youtubeanalytics.googleapis.com/v2
list GET /groups Restituisce un elenco di gruppi che corrispondono ai parametri della richiesta API. Ad esempio, puoi recuperare tutti i gruppi di proprietà dell'utente autenticato oppure uno o più gruppi in base agli ID univoci.
insert POST /groups Crea un gruppo di YouTube Analytics. Dopo aver creato un gruppo, utilizza il metodo groupItems.insert per aggiungere elementi al gruppo.
update PUT /groups Modifica i metadati di un gruppo. Attualmente, l'unica proprietà che può essere aggiornata è il titolo del gruppo. Utilizza groupItems.insert e groupItems.delete per aggiungere e rimuovere elementi del gruppo.
delete DELETE /groups Elimina un gruppo.

GroupGroup

Una risorsa groupItem rappresenta un elemento in un gruppo di YouTube Analytics.

Per ulteriori informazioni su questa risorsa, consulta la relativa rappresentazione e l'elenco di proprietà.

Metodo Richiesta HTTP Descrizione
URI relativi a https://youtubeanalytics.googleapis.com/v2
list GET /groupItems Restituisce una raccolta di elementi di gruppo che corrispondono ai parametri della richiesta API.
insert POST /groupItems Crea un elemento del gruppo.
delete DELETE /groupItems Rimuove un elemento da un gruppo.