YouTube Reporting API

Dengan YouTube Reporting API, developer dapat menjadwalkan tugas pelaporan, lalu mendownload laporan massal yang dibuat. API ini mendukung kumpulan laporan standar, yang masing-masing berisi kumpulan data YouTube Analytics yang komprehensif untuk sebuah channel atau pemilik konten.

Langkah-langkah di bawah menjelaskan cara menjadwalkan tugas pelaporan dan mengambil laporan:

  1. Panggil metode reportTypes.list() untuk mengambil daftar laporan yang dapat diambil oleh channel atau pemilik konten.
  2. Panggil metode jobs.create() untuk mengidentifikasi laporan yang harus dibuat untuk channel atau pemilik konten. Anda kemudian dapat menggunakan jobs.list() dan jobs.delete() API untuk mengambil atau mengubah daftar laporan yang dibuat.
  3. Panggil metode jobs.reports.list() untuk mengambil daftar laporan yang telah dibuat untuk tugas tertentu. Setiap resource dalam respons berisi properti downloadUrl yang menentukan URL tempat laporan dapat didownload.
  4. Kirim permintaan GET yang diotorisasi untuk mengambil laporan dari URL download.

Otorisasi

Semua permintaan YouTube Reporting API harus diizinkan. Panduan otorisasi menjelaskan cara menggunakan protokol OAuth 2.0 untuk mengambil token otorisasi.

Permintaan YouTube Reporting API menggunakan cakupan otorisasi berikut:

Cakupan
https://www.googleapis.com/auth/yt-analytics.readonly Lihat laporan YouTube Analytics untuk konten YouTube Anda. Cakupan ini memberikan akses ke metrik aktivitas pengguna, seperti jumlah penayangan dan jumlah rating.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly Lihat laporan moneter YouTube Analytics untuk konten YouTube Anda. Cakupan ini memberikan akses ke metrik aktivitas pengguna dan estimasi pendapatan serta metrik performa iklan.

Jenis resource

Bagian berikut memberikan deskripsi umum tentang resource dan metode API. Semua URI metode yang ditampilkan dalam tabel relatif terhadap https://youtubereporting.googleapis.com.

tugas

Metode
create POST /v1/jobs
Membuat tugas pelaporan. Dengan membuat tugas pelaporan, Anda meminta YouTube untuk membuat laporan tersebut setiap hari. Laporan tersedia dalam waktu 24 jam sejak pekerjaan dibuat.
delete DELETE /v1/jobs/{jobId}
Menghapus tugas pelaporan.
get GET /v1/jobs/{jobId}
Mengambil informasi tentang tugas pelaporan tertentu yang telah dijadwalkan untuk channel atau pemilik konten.
list GET /v1/jobs
Mencantumkan tugas pelaporan yang telah dijadwalkan untuk channel atau pemilik konten. Setiap resource dalam respons berisi properti id, yang menentukan ID yang digunakan YouTube untuk mengidentifikasi pekerjaan secara unik. Anda memerlukan ID tersebut untuk mengambil daftar laporan yang telah dibuat untuk tugas atau untuk menghapus tugas.

laporan.tugas

Metode
get GET /v1/jobs/{jobId}/reports/{reportId}
Mengambil metadata untuk laporan tertentu.
list GET /v1/jobs/{jobId}/reports
Mencantumkan laporan yang telah dibuat untuk tugas pelaporan yang ditentukan.

reportTypes

Metode
list GET /v1/reportTypes
Menampilkan daftar jenis laporan yang dapat diambil oleh channel atau pemilik konten.