Dengan YouTube Analytics API, Anda dapat mengambil data YouTube Analytics untuk channel atau pemilik konten YouTube. API mendukung kueri real-time dan menghasilkan laporan berdasarkan parameter permintaan API.
API ini mendukung dua jenis fungsi:
-
Pengambilan laporan – Metode
reports.query
API mengambil laporan YouTube Analytics. -
Pengelolaan grup YouTube Analytics – Grup YouTube Analytics adalah kumpulan kustom yang berisi hingga 500 channel, video, playlist, atau aset. API mendukung beberapa metode untuk membuat, mengambil, dan memperbarui grup YouTube Analytics. Kemudian, pemilik saluran dan konten dapat menggunakan metode
reports.query
untuk mengambil data gabungan untuk semua item dalam grup, yang dapat membantu analisis performa.
Halaman ini menyediakan ringkasan singkat tentang resource dan metode API yang mengaktifkan fungsi tersebut.
Otorisasi
Semua permintaan YouTube Analytics API harus diizinkan. Panduan otorisasi menjelaskan cara menggunakan protokol OAuth 2.0 untuk mengambil token otorisasi.
Permintaan YouTube Analytics 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. |
https://www.googleapis.com/auth/youtube | Mengelola akun YouTube Anda. Di YouTube Analytics API, pemilik channel menggunakan cakupan ini untuk mengelola grup dan item grup YouTube Analytics. |
https://www.googleapis.com/auth/youtubepartner | Melihat dan mengelola aset YouTube dan konten terkait di YouTube. Di YouTube Analytics API, pemilik konten menggunakan cakupan ini untuk mengelola grup dan item grup YouTube Analytics. |
Pengambilan laporan
Metode reports.query
API memungkinkan Anda mengambil banyak laporan YouTube Analytics yang berbeda. Setiap permintaan menggunakan parameter kueri untuk menentukan ID channel atau pemilik konten, tanggal mulai, tanggal akhir, dan setidaknya satu metrik. Anda juga dapat memberikan parameter kueri tambahan, seperti dimensi, filter, dan petunjuk pengurutan.
Metode | Permintaan HTTP | Deskripsi |
---|---|---|
URI relatif terhadap https://youtubeanalytics.googleapis.com/v2 |
||
query |
GET /reports |
Mengambil laporan YouTube Analytics. Setiap permintaan API menggunakan parameter kueri untuk menentukan ID channel atau pemilik konten, tanggal mulai, tanggal akhir, dan setidaknya satu metrik. Anda juga dapat memberikan parameter kueri tambahan, seperti dimensi, filter, atau petunjuk pengurutan.
|
Pengelolaan grup
API ini menyediakan dua referensi untuk membuat dan mengelola grup YouTube Analytics:
Grup
Resource group
mewakili grup YouTube Analytics, yang merupakan kumpulan khusus hingga 500 saluran, video, playlist, atau aset.
Semua item dalam grup harus mewakili jenis resource yang sama. Misalnya, Anda tidak dapat membuat grup yang berisi 100 video dan 100 playlist.
Grup Analytics hanya dapat berisi resource yang telah Anda upload atau klaim atau yang ditautkan ke channel yang Anda kelola. Akibatnya, pemilik channel dapat membuat grup video dan playlist. Pemilik konten dapat membuat grup video, playlist, channel, atau aset.
Untuk informasi selengkapnya tentang resource ini, lihat representasi resource dan daftar properti.
Metode | Permintaan HTTP | Deskripsi |
---|---|---|
URI relatif terhadap https://youtubeanalytics.googleapis.com/v2 |
||
list |
GET /groups |
Menampilkan daftar grup yang cocok dengan parameter permintaan API. Misalnya, Anda dapat mengambil semua grup yang dimiliki pengguna terautentikasi, atau Anda dapat mengambil satu atau beberapa grup berdasarkan ID unik mereka. |
insert |
POST /groups |
Membuat grup YouTube Analytics. Setelah membuat grup, gunakan metode groupItems.insert untuk menambahkan item ke grup. |
update |
PUT /groups |
Memodifikasi metadata untuk grup. Saat ini, satu-satunya properti yang dapat diperbarui adalah judul grup. (Gunakan groupItems.insert dan groupItems.delete untuk menambahkan dan menghapus item grup.) |
delete |
DELETE /groups |
Menghapus grup. |
ItemGrup
Resource groupItem
mewakili item dalam grup YouTube Analytics.
Untuk informasi selengkapnya tentang resource ini, lihat representasi resource dan daftar properti.
Metode | Permintaan HTTP | Deskripsi |
---|---|---|
URI relatif terhadap https://youtubeanalytics.googleapis.com/v2 |
||
list |
GET /groupItems |
Menampilkan kumpulan item grup yang cocok dengan parameter permintaan API. |
insert |
POST /groupItems |
Membuat item grup. |
delete |
DELETE /groupItems |
Menghapus item dari kelompok. |