YouTube Reporting API

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

I passaggi riportati di seguito spiegano come pianificare i job di generazione dei 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 da generare per un canale o un proprietario dei contenuti. Successivamente, puoi utilizzare jobs.list() e jobs.delete() dell'API per recuperare o modificare l'elenco dei report generati.
  3. Chiama 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 per recuperare il report dall'URL di download.

Autorizzazione

Tutte le richieste all'API YouTube Reporting 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 YouTube Reporting utilizzano i seguenti ambiti di autorizzazione:

Ambiti
https://www.googleapis.com/auth/yt-analytics.readonly Visualizzare i report di YouTube Analytics per i contenuti di YouTube. Questo ambito fornisce l'accesso alle metriche sull'attività degli utenti, come i conteggi delle visualizzazioni e delle valutazioni.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly Visualizzare i report Analytics su YouTube relativi al valore monetario per i contenuti di YouTube. Questo ambito fornisce l'accesso alle metriche sull'attività utente e alle metriche stimate su entrate e rendimento degli annunci.

Tipi di risorse

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

job

Metodi
create POST /v1/jobs
Crea un job di generazione di report. Creando un job di generazione report, chiedi a YouTube di generare il report quotidianamente. Il report è disponibile entro 24 ore dalla creazione del job.
delete DELETE /v1/jobs/{jobId}
Elimina un job di generazione di report.
get GET /v1/jobs/{jobId}
Recupera informazioni su un job di generazione di report specifico pianificato per un canale o un proprietario dei contenuti.
list GET /v1/jobs
Elenca i job di generazione 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. Ti serve questo ID per recuperare l'elenco dei report generati per il job o per eliminarlo.

jobs.reports

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

reportTypes

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