YouTube Reporting API

L'API di reporting di YouTube consente agli sviluppatori di pianificare i job di reporting e scaricare i report collettivi generati. L'API supporta un insieme predefinito di report, ognuno dei quali contiene un set completo di dati di YouTube Analytics per un canale o un proprietario dei contenuti.

I seguenti passaggi spiegano come pianificare i job di report e recuperare i report:

  1. Chiama il metodo reportTypes.list() per recuperare un elenco di report che un canale o un proprietario dei contenuti può recuperare.
  2. Chiama il metodo jobs.create() per identificare un report che dovrebbe essere generato per un proprietario di canali o contenuti. Successivamente puoi utilizzare i valori jobs.list() e jobs.delete() dell'API per recuperare o modificare l'elenco dei report generati.
  3. Richiama il metodo jobs.reports.list() per recuperare un elenco di report generati per un determinato job. Ogni risorsa nella risposta contiene una proprietà downloadUrl che specifica l'URL da cui è possibile scaricare il report.
  4. Invia una richiesta GET autorizzata a recuperare il report dall'URL di download.

Autorizzazione

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

Le richieste all'API di reporting di YouTube 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.

Tipi di risorse

Le seguenti sezioni forniscono descrizioni generali delle risorse e dei metodi dell'API. Tutti gli URI del metodo mostrati nelle tabelle sono relativi a https://youtubereporting.googleapis.com.

offerte di lavoro

Metodi
create POST /v1/jobs
Crea un job di reporting. Creando un job di segnalazione, indichi a YouTube di generare tale rapporto quotidianamente. Il report è disponibile entro 24 ore dall'ora di creazione del job.
delete DELETE /v1/jobs/{jobId}
Elimina un job di reporting.
get GET /v1/jobs/{jobId}
Recupera le informazioni su un'attività di report specifica che è stata programmata per un canale o un proprietario dei contenuti.
list GET /v1/jobs
Elenca i job di report pianificati per un canale o un proprietario dei contenuti. Ogni risorsa nella risposta contiene una proprietà id, che specifica l'ID utilizzato da YouTube per identificare in modo univoco il job. Questo ID è necessario per recuperare l'elenco dei report generati per il job o per eliminarlo.

offerte_di_lavoro

Metodi
get GET /v1/jobs/{jobId}/reports/{reportId}
Recupera i metadati per un report specifico.
list GET /v1/jobs/{jobId}/reports
Elenca i report generati per il job di report specificato.

reportTypes

Metodi
list GET /v1/reportTypes
Restituisce un elenco di tipi di report che il canale o il proprietario dei contenuti può recuperare.