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.
|
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. |