Halaman ini mencantumkan perubahan API dan pembaruan dokumentasi untuk YouTube Reporting API dan YouTube Analytics API. Dengan kedua API tersebut, developer dapat mengakses data YouTube Analytics, meskipun dengan cara yang berbeda. Berlangganan log perubahan ini.
6 Mei 2024
API YouTube Analytics (Kueri yang Ditargetkan) mendukung tiga laporan baru untuk saluran:
-
Laporan Aktivitas pengguna menurut DMA adalah laporan geografis yang memberikan statistik aktivitas pengguna berdasarkan Designated Market Area (DMA). Untuk laporan ini, Anda harus menetapkan parameter value
filters
kecountry==US
. -
Laporan Penonton serentak menunjukkan jumlah penonton serentak untuk berbagai bagian dari satu video live stream.
-
Laporan Pembatalan Pelanggan menyediakan statistik yang menunjukkan alasan pengguna membatalkan langganan channel mereka.
Laporan ini menggunakan dimensi
membershipsCancellationSurveyReason
baru, yang menentukan alasan pengguna membatalkan langganan channel. Laporan ini juga menggunakan metrikmembershipsCancellationSurveyResponses
baru, yang menunjukkan jumlah langganan channel yang dibatalkan karena alasan tersebut.
Selain itu, laporan Retensi Audiens telah ditingkatkan untuk mendukung tiga metrik baru:
7 April 2024
YouTube Analytics (Targeted Queries) API memiliki beberapa pembaruan terkait laporan playlist pemilik konten. Pembaruan ini sama dengan pembaruan terkait laporan playlist channel, yang diumumkan pada 19 Januari 2024.
Entri histori revisi berikut memberikan informasi yang hampir sama dengan entri yang tercatat pada 19 Januari 2024. Namun, perlu diperhatikan bahwa laporan playlist
pemilik konten akan mendukung dimensi
isCurated
hingga
31 Desember 2024, sedangkan dimensi tersebut akan didukung untuk laporan playlist channel hingga
30 Juni 2024.
-
Catatan: Ini adalah pengumuman penghentian.
Dimensi
isCurated
tidak digunakan lagi untuk laporan playlist pemilik konten. API tersebut tidak akan didukung lagi pada atau setelah 31 Desember 2024. Definisi dimensi tersebut telah diperbarui.Untuk mempertahankan kompatibilitas mundur saat menghapus dimensi
isCurated
, Anda juga harus memperbarui kode untuk mengambil metrikplaylistViews
, bukan metrikviews
untuk laporan playlist saja. Karena metrikviews
masih didukung untuk laporan playlist, meskipun dengan arti yang berbeda, API akan tetap menampilkan data jika Anda tidak memperbarui nama metrik. Tentu saja, Anda dapat mengubah aplikasi untuk mengambil dan menampilkanviews
danplaylistViews
.Selain dimensi
isCurated
, fungsi API berikut tidak lagi didukung dalam laporan baru:- Filter lokasi, seperti
continent
dansubcontinent
tidak didukung untuk laporan playlist channel baru. - Metrik
redViews
danestimatedRedMinutesWatched
tidak lagi didukung untuk laporan playlist channel baru. Metrik ini belum tersedia di YouTube Studio, sehingga perubahan ini menyelaraskan fungsi API dengan fungsi yang tersedia di aplikasi Studio. - Dimensi
subscribedStatus
danyoutubeProduct
tidak lagi didukung sebagai filter untuk laporan playlist channel. Filter ini belum tersedia di YouTube Studio, sehingga perubahan ini menyelaraskan fungsi API dengan fungsi yang tersedia di aplikasi Studio.
- Filter lokasi, seperti
-
Bagian laporan playlist dalam dokumentasi laporan pemilik konten telah diperbarui untuk menjelaskan secara lebih menyeluruh jenis metrik yang didukung untuk laporan playlist:
- Metrik video gabungan
memberikan metrik aktivitas dan tayangan pengguna yang digabungkan untuk semua video dalam
playlist pemilik konten yang juga dimiliki oleh pemilik konten tersebut. Metrik video gabungan
hanya didukung untuk permintaan API yang tidak menggunakan dimensi
isCurated
. - Metrik dalam playlist mencerminkan aktivitas dan interaksi pengguna dalam konteks halaman playlist. Metrik ini menyertakan data untuk juga akan menyertakan penayangan dari video yang tidak dimiliki dalam playlist, tetapi hanya saat penayangan tersebut terjadi dalam konteks playlist.
- Bagian metrik playlist yang didukung mengidentifikasi metrik video gabungan dan metrik dalam playlist yang didukung untuk laporan playlist.
- Metrik video gabungan
memberikan metrik aktivitas dan tayangan pengguna yang digabungkan untuk semua video dalam
playlist pemilik konten yang juga dimiliki oleh pemilik konten tersebut. Metrik video gabungan
hanya didukung untuk permintaan API yang tidak menggunakan dimensi
-
Metrik dalam playlist baru berikut didukung untuk laporan playlist bagi pemilik konten. Perhatikan bahwa metrik ini hanya didukung jika permintaan API untuk mengambil laporan tidak menggunakan dimensi
isCurated
. Lihat dokumentasi metrics untuk mengetahui definisi setiap metrik: -
Perilaku metrik
views
kini bergantung pada apakah permintaan API yang mengambil laporan playlist menggunakan dimensiisCurated
:- Jika permintaan menyertakan dimensi
isCurated
, metrikviews
adalah metrik dalam playlist yang menunjukkan berapa kali video ditonton dalam konteks playlist pemilik konten. - Jika permintaan tidak menyertakan dimensi
isCurated
, metrikviews
adalah metrik video gabungan yang menentukan total berapa kali video dalam playlist pemilik konten ditonton, terlepas dari apakah penayangan tersebut terjadi dalam konteks playlist atau tidak. Total gabungan hanya mencakup penayangan video yang dimiliki oleh pemilik konten yang terkait dengan channel yang memiliki playlist tersebut.
Dalam laporan ini, yang tidak menggunakan dimensiisCurated
, metrikplaylistViews
menunjukkan frekuensi video ditonton dalam konteks playlist. Metrik tersebut menghitung penayangan untuk semua video di playlist, terlepas dari channel yang memilikinya.
- Jika permintaan menyertakan dimensi
-
Untuk setiap laporan playlist, dokumentasi laporan pemilik konten kini menyertakan tabel yang menampilkan metrik yang didukung untuk laporan tersebut, bergantung pada apakah permintaan API menyertakan dimensi
isCurated
atau tidak. Lihat bagian yang menentukan laporan playlist berbasis waktu sebagai contoh.
19 Januari 2024
YouTube Analytics (Targeted Queries) API memiliki beberapa pembaruan terkait laporan playlist channel. Update ini mencakup dimensi yang tidak digunakan lagi serta beberapa metrik baru dan yang diupdate:
-
Catatan: Ini adalah pengumuman penghentian.
Dimensi
isCurated
tidak digunakan lagi untuk laporan saluran. Aplikasi ini tidak akan didukung lagi pada atau setelah 30 Juni 2024. Definisi dimensi tersebut telah diperbarui sebagaimana mestinya.Untuk mempertahankan kompatibilitas mundur saat menghapus dimensi
isCurated
, Anda juga harus memperbarui kode untuk mengambil metrikplaylistViews
, bukan metrikviews
untuk laporan playlist saja. Karena metrikviews
masih didukung untuk laporan playlist, meskipun dengan arti yang berbeda, API akan tetap menampilkan data jika Anda tidak memperbarui nama metrik. Tentu saja, Anda dapat mengubah aplikasi untuk mengambil dan menampilkanviews
danplaylistViews
.Selain dimensi
isCurated
, fungsi API berikut tidak lagi didukung dalam laporan baru:- Filter lokasi, seperti
continent
dansubcontinent
tidak didukung untuk laporan playlist channel baru. - Metrik
redViews
danestimatedRedMinutesWatched
tidak lagi didukung untuk laporan playlist channel baru. Metrik ini belum tersedia di YouTube Studio, sehingga perubahan ini menyelaraskan fungsi API dengan fungsi yang tersedia di aplikasi Studio. - Dimensi
subscribedStatus
danyoutubeProduct
tidak lagi didukung sebagai filter untuk laporan playlist channel. Filter ini belum tersedia di YouTube Studio, sehingga perubahan ini menyelaraskan fungsi API dengan fungsi yang tersedia di aplikasi Studio.
- Filter lokasi, seperti
-
Bagian laporan playlist dalam dokumentasi laporan channel telah diperbarui untuk menjelaskan secara lebih menyeluruh jenis metrik yang didukung untuk laporan playlist:
- Metrik video gabungan memberikan metrik aktivitas dan tayangan pengguna yang digabungkan untuk semua video dalam playlist channel yang juga dimiliki oleh channel tersebut. Metrik video gabungan
hanya didukung untuk permintaan API yang tidak menggunakan dimensi
isCurated
. - Metrik dalam playlist mencerminkan aktivitas dan interaksi pengguna dalam konteks halaman playlist. Metrik ini menyertakan data untuk juga akan menyertakan penayangan dari video yang tidak dimiliki dalam playlist, tetapi hanya saat penayangan tersebut terjadi dalam konteks playlist.
- Bagian metrik playlist yang didukung mengidentifikasi metrik video gabungan dan metrik dalam playlist yang didukung untuk laporan playlist.
- Metrik video gabungan memberikan metrik aktivitas dan tayangan pengguna yang digabungkan untuk semua video dalam playlist channel yang juga dimiliki oleh channel tersebut. Metrik video gabungan
hanya didukung untuk permintaan API yang tidak menggunakan dimensi
-
Metrik dalam playlist yang baru berikut didukung untuk laporan playlist untuk channel. Metrik ini belum didukung untuk laporan pemilik konten. Perhatikan bahwa metrik ini hanya didukung jika permintaan API untuk mengambil laporan tidak menggunakan dimensi
isCurated
. Lihat dokumentasi metrics untuk mengetahui definisi setiap metrik: -
Perilaku metrik
views
kini bergantung pada apakah permintaan API yang mengambil laporan playlist menggunakan dimensiisCurated
:- Jika permintaan menyertakan dimensi
isCurated
, metrikviews
adalah metrik dalam playlist yang menunjukkan berapa kali video ditonton dalam konteks playlist channel. - Jika permintaan tidak menyertakan dimensi
isCurated
, metrikviews
adalah metrik video gabungan yang menentukan total berapa kali video dalam playlist channel ditonton, terlepas dari apakah penayangan tersebut terjadi dalam konteks playlist atau tidak. Total gabungan hanya mencakup penayangan video yang dimiliki channel yang memiliki playlist tersebut.
Dalam laporan ini, yang tidak menggunakan dimensiisCurated
, metrikplaylistViews
menunjukkan frekuensi video ditonton dalam konteks playlist. Metrik tersebut menghitung penayangan untuk semua video di playlist, terlepas dari channel yang memilikinya.
- Jika permintaan menyertakan dimensi
-
Untuk setiap laporan playlist, dokumentasi laporan saluran kini menyertakan tabel yang menampilkan metrik yang didukung untuk laporan tersebut, bergantung pada apakah permintaan API menyertakan dimensi
isCurated
atau tidak. Lihat bagian yang menentukan laporan playlist berbasis waktu sebagai contoh.
4 Desember 2023
YouTube Analytics (Targeted Queries) API telah diperbarui untuk menggabungkan dua
nilai dimensi
insightTrafficSourceType
. Sebelumnya, dimensi yang membedakan antara video yang diputar sebagai bagian dari playlist
(PLAYLIST
) dan penayangan yang berasal dari halaman yang mencantumkan semua video dalam playlist
(YT_PLAYLIST_PAGE
). Ke depannya, kedua jenis penayangan tersebut akan dikaitkan dengan
nilai dimensi PLAYLIST
.
15 Desember 2022
YouTube Analytics (Target Queries) API mendukung dua dimensi baru dan satu laporan baru:
-
Laporan baru menampilkan aktivitas pengguna menurut kota. Laporan ini tersedia untuk channel dan pemilik konten. Laporan ini berisi dimensi
city
baru, yang mengidentifikasi estimasi YouTube untuk kota tempat aktivitas pengguna terjadi. -
Dimensi
creatorContentType
baru mengidentifikasi jenis konten YouTube yang dikaitkan dengan metrik aktivitas pengguna di baris data. Nilai yang didukung adalahLIVE_STREAM
,SHORTS
,STORY
, danVIDEO_ON_DEMAND
.Dimensi
creatorContentType
didukung sebagai dimensi opsional untuk semua laporan video channel dan pemilik konten. -
Panduan contoh permintaan YouTube Analytics API kini menyertakan contoh untuk kedua dimensi baru.
-
Referensi ke dimensi
7DayTotals
dan30DayTotals
telah dihapus dari dokumentasi. Penghentian dimensi ini diumumkan pada Oktober 2019.
26 Agustus 2022
YouTube Analytics (Targeted Queries) API dan YouTube Reporting (Bulk Reports) API mendukung nilai detail sumber traffic baru:
- Di YouTube Analytics API (Targeted Queries) API, jika nilai dimensi
insightTrafficSourceType
adalahSUBSCRIBER
, nilaiinsightTrafficSourceDetail
dapat ditetapkan kepodcasts
, yang menunjukkan bahwa traffic dirujuk dari halaman tujuan Podcast. - Di YouTube Reporting (Bulk Reports) API, jika nilai dimensi
traffic_source_type
adalah3
, nilaitraffic_source_detail
dapat ditetapkan kepodcasts
, yang menunjukkan bahwa traffic dirujuk dari halaman tujuan Podcast.
11 Februari 2022
Kumpulan nilai yang valid untuk dimensi gender
akan berubah pada atau setelah 11 Agustus 2022. Perubahan ini mungkin tidak kompatibel dengan versi sebelumnya dalam implementasi API Anda. Sesuai dengan bagian Perubahan Tidak Kompatibel dengan Mundur dalam Persyaratan Layanan untuk Layanan YouTube API, perubahan ini diumumkan enam bulan sebelum mulai berlaku. Perbarui penerapan API Anda sebelum 11 Agustus 2022 untuk memastikan transisi yang lancar ke kumpulan nilai baru.
Perubahan spesifik yang dilakukan adalah:
- Di YouTube Analytics (Targeted Queries) API, dimensi
gender
saat ini mendukung dua nilai:female
danmale
. Pada atau setelah 11 Agustus 2022, dimensi tersebut akan mendukung tiga nilai:female
,male
, danuser_specified
. - Di YouTube Reporting API (Bulk Reports) API, dimensi
gender
saat ini mendukung tiga nilai:FEMALE
,MALE
, danGENDER_OTHER
. Pada atau setelah 11 Agustus 2022, kumpulan nilai yang didukung akan berubah menjadiFEMALE
,MALE
, danUSER_SPECIFIED
.
9 Februari 2022
Dua metrik telah diperbarui untuk mengecualikan traffic klip loop per 13 Desember 2021. Perubahan ini memengaruhi YouTube Analytics (Targeted Queries) API dan YouTube Reporting API (Bulk Reports).
- Di YouTube Analytics (Targeted Queries) API, metrik
averageViewDuration
danaverageViewPercentage
mengecualikan traffic klip loop per 13 Desember 2021. - Di YouTube Reporting (Bulk Reports) API, metrik
average_view_duration_seconds
danaverage_view_duration_percentage
mengecualikan traffic klip loop per 13 Desember 2021.
2 Februari 2022
YouTube Reporting (Bulk Reports) API ini mendukung nilai dimensi sumber traffic baru yang menunjukkan bahwa penayangan berasal dari Live Redirect:
- Di YouTube Reporting (Bulk Reports) API, dimensi
traffic_source_type
mendukung nilai28
.
Untuk jenis sumber traffic ini, dimensi
traffic_source_detail
menentukan ID channel tempat penonton diarahkan.
23 September 2020
YouTube Analytics (Targeted Queries) API dan YouTube Reporting (Bulk Reports) API ini mendukung nilai dimensi sumber traffic baru yang menunjukkan bahwa penonton diarahkan dengan menggeser secara vertikal pengalaman menonton YouTube Shorts:
- Di YouTube Analytics API (Targeted Queries) API, dimensi
insightTrafficSourceType
mendukung nilaiSHORTS
. - Di YouTube Reporting (Bulk Reports) API, dimensi
traffic_source_type
mendukung nilai24
.
Dimensi detail sumber traffic — insightTrafficSourceDetail
di YouTube Analytics API atau traffic_source_detail
di YouTube Reporting API — tidak diisi untuk jenis sumber traffic baru ini.
20 Juli 2020
Pembaruan ini mencakup dua perubahan yang memengaruhi API YouTube Analytics (Target Kueri):
- Ukuran maksimum grup pelaporan YouTube Analytics telah dinaikkan dari 200 menjadi 500 entitas.
- Parameter
filters
metodereports.query
mengidentifikasi daftar filter yang harus diterapkan saat mengambil data YouTube Analytics. Parameter ini mendukung kemampuan untuk menentukan beberapa nilai untuk filtervideo
,playlist
, danchannel
, serta jumlah maksimum ID yang dapat ditentukan untuk filter tersebut telah meningkat dari 200 menjadi 500 ID.
13 Februari 2020
Pembaruan ini berisi perubahan berikut yang terkait dengan YouTube Analytics (Targeted Queries) API dan YouTube Reporting (Bulk Reports) API. Anda dapat mempelajari perubahan ini lebih lanjut di Pusat Bantuan YouTube.
Di kedua API, kumpulan kemungkinan nilai detail sumber traffic untuk notifikasi akan berubah.
Dalam kueri yang ditargetkan,
notifikasi dilaporkan sebagai insightTrafficSourceType=NOTIFICATION
. Dalam
laporan massal,
notifikasi dilaporkan sebagai traffic_source_type=17
.
Nilai baru membagi notifikasi terkait video yang diupload dan live stream, yang sebelumnya
dilaporkan sebagai uploaded
, ke dalam dua kategori:
uploaded_push
- Penayangan berasal dari notifikasi push yang dikirimkan kepada subscriber saat video diuploaduploaded_other
- Penayangan yang berasal dari notifikasi non-push, seperti notifikasi email atau Kotak masuk, yang dikirim kepada subscriber saat video diupload.
Nilai ini ditampilkan untuk rentang waktu mulai 13-01-2020 (13 Januari 2020).
Selain itu, sebagai pengingat, nilai ini tidak mewakili notifikasi itu sendiri, melainkan sumber traffic yang mendorong penayangan YouTube tertentu. Misalnya, jika baris laporan menunjukkan views=3
,
traffic_source_type=17
(NOTIFICATION
), dan
traffic_source_detail=uploaded_push
, baris tersebut menunjukkan bahwa tiga penayangan
dihasilkan dari penonton yang mengklik notifikasi push yang dikirim saat video diupload.
15 Oktober 2019
Pembaruan ini berisi perubahan berikut yang terkait dengan YouTube Analytics (Targeted Queries) API:
-
Catatan: Ini adalah pengumuman penghentian.
YouTube menghapus dukungan untuk dimensi
7DayTotals
dan30DayTotals
. Anda tetap dapat mengambil data menggunakan dimensi tersebut hingga 15 April 2020. Pada atau setelah tanggal tersebut, upaya untuk mengambil laporan menggunakan dimensi7DayTotals
atau30DayTotals
akan menampilkan error.Perhatikan bahwa pengguna dapat mereproduksi beberapa data untuk dimensi ini dengan membuat kueri menggunakan dimensi
day
dan menggabungkan atau mendapatkan data dalam periode tujuh atau 30 hari. Contoh:- Jumlah penayangan selama jangka waktu tujuh hari dapat dihitung dengan menggabungkan jumlah penayangan dari setiap hari pada periode tersebut.
- Persentase penonton untuk periode tujuh hari dapat dihitung dengan mengalikan jumlah penayangan yang terjadi setiap hari, dikali persentase penonton untuk hari tersebut, guna mendapatkan jumlah penonton yang login saat menonton video pada hari itu. Kemudian, jumlah penonton yang login dapat ditambahkan untuk seluruh periode dan dibagi dengan jumlah total penayangan selama periode tersebut agar mendapatkan persentase viewerPercentage selama keseluruhan periode.
- Jumlah penonton unik selama tujuh hari tidak dapat dihitung karena penonton yang sama dapat dihitung sebagai penonton unik pada hari yang berbeda-beda. Namun, Anda mungkin dapat menggunakan dimensi
month
, bukan dimensi30DayTotals
, untuk mengekstrapolasi data tentang jumlah pelihat unik selama periode 30 hari. Perhatikan bahwa dimensimonth
mengacu pada bulan kalender, sedangkan dimensi30DayTotals
menghitung periode 30 hari berdasarkan tanggal mulai dan akhir yang ditentukan.
27 Juni 2019
Pembaruan ini berisi perubahan berikut yang terkait dengan YouTube Analytics (Targeted Queries) API:
-
Karena API versi 1 sekarang sepenuhnya tidak digunakan lagi, dokumentasi telah diperbarui untuk menghapus referensi ke versi tersebut, termasuk pemberitahuan penghentian penggunaan dan panduan migrasi yang menjelaskan cara mengupdate ke versi 2.
1 November 2018
Pembaruan ini berisi perubahan berikut yang terkait dengan YouTube Analytics (Targeted Queries) API:
-
API versi 1 kini tidak digunakan lagi. Jika Anda belum melakukannya, update klien API agar menggunakan API versi 2 sesegera mungkin untuk meminimalkan gangguan layanan. Lihat panduan migrasi untuk mengetahui detail selengkapnya.
Perlu diperhatikan bahwa jadwal penghentian ini awalnya diumumkan pada 26 April 2018.
17 September 2018
Pembaruan ini berisi perubahan berikut yang terkait dengan YouTube Analytics (Targeted Queries) API:
-
Bagian anonimisasi data yang baru dalam dokumen ringkasan Model Data menjelaskan bahwa beberapa data YouTube Analytics akan dibatasi ketika metrik tidak memenuhi nilai minimum tertentu. Hal ini dapat terjadi dalam berbagai kasus. Dalam praktiknya, laporan mungkin tidak berisi semua (atau sebagian) data Anda jika:
-
video atau channel memiliki traffic terbatas selama jangka waktu tertentu,
atau
-
Anda memilih filter atau dimensi, seperti sumber traffic atau negara, yang nilainya tidak memenuhi batas tertentu.
Bagian baru ini juga berisi diskusi tentang jenis data yang mungkin dibatasi dalam laporan YouTube Analytics.
-
-
Dokumen laporan channel dan laporan pemilik konten telah diperbarui untuk mencerminkan fakta bahwa metrik
redViews
danestimatedRedMinutesWatched
tidak lagi didukung untuk laporan lokasi pemutaran, sumber traffic, dan jenis perangkat/sistem operasi.
18 Juni 2018
Pembaruan ini berisi perubahan berikut pada YouTube Analytics (Targeted Queries) API:
- Persyaratan cakupan untuk metode berikut telah berubah:
- Permintaan ke metode
reports.query
harus memiliki akses ke cakupanhttps://www.googleapis.com/auth/youtube.readonly
. - Permintaan ke metode
groupItems.list
harus memiliki akses ke:https://www.googleapis.com/auth/youtube
cakupan
atau- cakupan
https://www.googleapis.com/auth/youtube.readonly
dan
cakupanhttps://www.googleapis.com/auth/yt-analytics.readonly
Opsi pertama menggunakan satu cakupan, yang kebetulan berupa cakupan baca-tulis, sedangkan opsi kedua menggunakan dua cakupan hanya baca.
- Permintaan ke metode
23 Mei 2018
Pembaruan ini berisi perubahan berikut pada YouTube Analytics (Targeted Queries) API:
- Ringkasan API berisi bagian baru, gabungan metrik dan item yang dihapus, yang menjelaskan cara respons API menangani data yang terkait dengan resource yang telah dihapus, seperti video, playlist, atau channel.
- Bagian praktik terbaik Ringkasan API telah diperbarui untuk mengingatkan bahwa Anda dapat menggunakan YouTube Data API guna mengambil metadata tambahan untuk resource yang diidentifikasi dalam respons YouTube Analytics API. Seperti disebutkan dalam Kebijakan Developer Layanan YouTube API (bagian III.E.4.b hingga III.E.4.d), klien API harus menghapus atau memperbarui metadata resource yang disimpan dari API tersebut setelah 30 hari.
22 Mei 2018
Pembaruan ini berisi perubahan berikut terkait YouTube Reporting API (Bulk Reports) API:
- Perubahan berikut saat ini dijadwalkan akan berlaku pada Juli 2018, dan kebijakan baru tersebut berlaku secara global untuk semua tugas pelaporan dan pelaporan.
-
Setelah perubahan, sebagian besar laporan API, termasuk laporan pengisian ulang, akan tersedia selama 60 hari sejak dibuat. Namun, laporan yang berisi data historis akan tersedia selama 30 hari sejak dibuat.
Sebelum pengumuman ini, semua laporan API telah tersedia selama 180 hari sejak dibuat. Untuk lebih jelasnya, saat perubahan kebijakan ini berlaku, laporan data historis yang sudah lebih dari 30 hari juga tidak akan dapat diakses lagi melalui API. Semua laporan lain yang sudah lebih dari 60 hari juga tidak dapat diakses lagi. Dengan demikian, dokumentasi kini menyatakan bahwa laporan yang dibuat sebelum perubahan kebijakan akan tersedia selama hingga 180 hari.
-
Setelah perubahan ini, saat Anda menjadwalkan tugas pelaporan, YouTube akan membuat laporan mulai hari tersebut dan mencakup periode 30 hari sebelum jadwal tugas tersebut. Sebelum perubahan ini dilakukan, saat Anda menjadwalkan tugas pelaporan, YouTube akan membuat laporan yang mencakup periode 180 hari sebelum waktu tugas tersebut dijadwalkan.
-
-
Bagian praktik terbaik telah diperbarui untuk mengingatkan bahwa Anda dapat menggunakan YouTube Data API untuk mengambil metadata tambahan untuk referensi yang diidentifikasi dalam laporan. Seperti disebutkan dalam Kebijakan Developer Layanan YouTube API (bagian III.E.4.b hingga III.E.4.d), klien API harus menghapus atau memperbarui metadata resource yang disimpan dari API tersebut setelah 30 hari.
-
Bagian Karakteristik laporan telah diperbarui untuk diperhatikan bahwa meskipun data laporan tidak difilter, laporan yang berisi data untuk jangka waktu tertentu pada atau setelah 1 Juni 2018 tidak akan berisi referensi ke referensi YouTube yang telah dihapus setidaknya 30 hari sebelum tanggal laporan dibuat.
-
Bagian data historis pada ringkasan API telah diperbarui untuk memperhatikan bahwa saat Anda menjadwalkan tugas pelaporan baru, laporan historis biasanya akan diposting dalam beberapa hari. Sebelumnya, dokumentasi menyatakan bahwa perlu waktu hingga 30 hari agar laporan tersebut tersedia.
-
Bagian data pengisian ulang pada ringkasan API telah diperbarui untuk menentukan data pengisian ulang dengan lebih jelas sebagai set data yang menggantikan set yang ditayangkan sebelumnya.
26 April 2018
API YouTube Analytics (Targeted Queries) versi 2 (v2) kini tersedia untuk publik. Daftar berikut mengidentifikasi perubahan produk dan dokumentasi yang terkait dengan versi API baru:
-
API v2 hampir sama dengan API v1. Namun, Anda mungkin harus memperbarui kode untuk mencerminkan perubahan yang tercantum di bawah ini. Semua perubahan ini dijelaskan secara mendetail dalam panduan migrasi baru.
- Versi API telah berubah dari
v1
menjadiv2
. - URL dasar untuk permintaan API telah berubah dari
https://www.googleapis.com/youtube/analytics/v1
menjadihttps://youtubeanalytics.googleapis.com/v2
. - Beberapa parameter untuk metode
reports.query
telah memperbarui nama. Secara khusus, nama parameter yang berisi tanda hubung, sepertiend-date
di API v1 menggunakan camel case (endDate
), bukan tanda hubung di API v2. Perubahan ini membuat nama parameter konsisten di seluruh API karena metode API untuk membuat dan mengelola grup sudah menggunakan camel case untuk nama parameter. - API v2 tidak mendukung permintaan batch yang dikirim ke endpoint batch HTTP global Google (
www.googleapis.com/batch
). Jika mengirim permintaan batch di API v2, Anda harus menggunakan endpointhttps://youtubeanalytics.googleapis.com/v2
sebagai gantinya.
Selain itu, beberapa fitur v1 yang tidak didukung di API v2:
- Metode
reports.query
tidak lagi mendukung parameter permintaanalt
,quotaUser
, danuserIp
. - API v2 tidak menyediakan endpoint batch yang mendukung batch yang terdiri dari permintaan ke API yang berbeda. (Namun, satu batch bisa terdiri dari permintaan ke berbagai metode API yang sama.) Penghentian ini tidak khusus untuk YouTube Analytics API karena Google akan menghentikan endpoint batch global di semua API-nya.
- API v2 tidak mendukung protokol JSON-RPC yang didukung di API v1. Sekali lagi, penghentian ini tidak khusus untuk YouTube Analytics API.
- Versi API telah berubah dari
-
Catatan: Ini adalah pengumuman penghentian.
API versi 1 (v1) kini tidak digunakan lagi dan akan didukung hingga 31 Oktober 2018. Semua permintaan ke API v1 akan berhenti berfungsi setelah tanggal tersebut. Oleh karena itu, pastikan untuk mengupgrade ke API v2 paling lambat 31 Oktober 2018 agar Anda dapat terus mengakses data YouTube Analytics melalui API tersebut.
21 Februari 2018
Pembaruan ini berisi perubahan berikut pada YouTube Analytics (Targeted Queries) API:
- Laporan demografi penonton, yang menggabungkan statistik penayangan berdasarkan kelompok usia dan gender penonton, tidak lagi mendukung dimensi
youtubeProduct
, yang mengidentifikasi layanan YouTube tempat aktivitas pengguna terjadi.
18 Januari 2018
Update ini berisi perubahan berikut:
-
YouTube Reporting API (Laporan Massal)
- Dimensi
operating_system
, yang mengidentifikasi sistem software perangkat tempat tampilan terjadi, kini mendukung nilai berikut:25
: KaiOS
- Dimensi
-
YouTube Analytics API (Target Kueri)
- Dimensi
operatingSystem
mendukung nilai dimensiKAIOS
.
- Dimensi
20 Desember 2017
Pembaruan ini memuat dua perubahan terkait YouTube Reporting API:
-
Server API kini mendukung kompresi gzip untuk permintaan yang mendownload laporan. Perhatikan bahwa kompresi gzip tidak didukung untuk jenis permintaan API lainnya. Mengaktifkan kompresi gzip akan mengurangi bandwidth yang diperlukan untuk setiap respons API. Dan, meskipun aplikasi Anda akan memerlukan waktu CPU tambahan untuk membatalkan kompresi respons API, manfaat menggunakan resource jaringan yang lebih sedikit biasanya lebih besar daripada biaya tersebut.
Untuk menerima respons yang dienkode dengan gzip, setel header permintaan HTTP
Accept-Encoding
kegzip
seperti yang ditunjukkan dalam contoh berikut:Accept-Encoding: gzip
Fungsi ini dijelaskan dalam Ringkasan API dan dalam definisi properti
downloadUrl
resourcereport
. -
Dokumentasi dimensi
age group
dangender
telah dikoreksi agar menampilkan nilai sebenarnya yang ditampilkan API untuk dimensi tersebut. Perhatikan bahwa ini adalah koreksi dokumentasi dan tidak mencerminkan perubahan pada fungsi atau perilaku API. Secara khusus, nilai berikut telah berubah:- Nilai untuk dimensi
age_group
menggunakan huruf besar, berisi garis bawah di antara kataAGE
dan angka dalam kelompok usia, serta menggunakan garis bawah, bukan tanda hubung. Dengan demikian, nilai sepertiage13-17
danage18-24
masing-masing telah dikoreksi menjadiAGE_13_17
danAGE_18_24
. - Nilai untuk dimensi
gender
menggunakan huruf besar. Dengan demikian, nilaifemale
,male
, dangender_other
telah dikoreksi menjadiFEMALE
,MALE
, danGENDER_OTHER
.
- Nilai untuk dimensi
10 Agustus 2017
Pada 10 Agustus 2016, dokumentasi ini mengumumkan penghentian penggunaan metrik earnings
YouTube Analytics API. (Pada saat yang sama, API menambahkan dukungan untuk metrik baru, yang bernama estimatedRevenue
, yang memberikan data yang sama.)
Karena metrik earnings
adalah metrik inti, metrik ini didukung selama satu tahun sejak tanggal pengumuman. Namun, setelah periode setahun tersebut berakhir, metrik earnings
tidak lagi didukung. Akibatnya, permintaan API yang menentukan metrik earnings
kini menampilkan kode respons HTTP 400
. Jika Anda belum mengupdate aplikasi untuk menggunakan metrik estimatedRevenue
, bukan metrik earnings
, harap lakukan sesegera mungkin.
Dokumentasi API telah diperbarui untuk menghapus referensi yang tersisa ke metrik earnings
.
6 Juli 2017
Update ini berisi perubahan berikut:
-
YouTube Analytics API (Target Kueri)
-
Dokumentasi API telah diperbarui untuk mencerminkan fakta bahwa respons API berisi data hingga hari terakhir dalam rentang tanggal yang diminta saat semua metrik yang dikueri tersedia.
Misalnya, jika permintaan mencantumkan tanggal akhir 5 Juli 2017, dan nilai untuk semua metrik yang diminta hanya tersedia hingga 3 Juli 2017, tanggal tersebut akan menjadi tanggal terakhir saat data disertakan dalam respons. (Hal ini tetap berlaku meskipun data untuk beberapa metrik yang diminta tersedia untuk 4 Juli 2017.)
-
Dimensi
adType
kini mendukung nilaireservedBumperInstream
, yang mengacu pada iklan video yang tidak dapat dilewati berdurasi hingga 6 detik dan diputar sebelum video dapat ditonton. Format iklan sama dengan iklanauctionBumperInstream
, tetapi jenis ini mengacu pada iklan yang dijual berdasarkan reservasi, bukan lelang.
-
-
YouTube Reporting API (Laporan Massal)
-
Dimensi
ad_type
kini mendukung nilai20
, yang mengacu pada iklan bumper yang dijual berdasarkan pesanan. Iklan bumper adalah iklan video yang tidak dapat dilewati berdurasi maksimal 6 detik dan diputar sebelum video dapat diputar. Perhatikan bahwa nilai19
untuk dimensi ini juga mengacu pada iklan bumper yang dijual secara lelang, bukan secara reservasi. -
Tugas pelaporan untuk laporan YouTube Reporting API berikut telah dihapus:
channel_basic_a1
channel_province_a1
channel_playback_location_a1
channel_traffic_source_a1
channel_device_os_a1
channel_subtitles_a1
channel_combined_a1
content_owner_basic_a2
content_owner_province_a1
content_owner_playback_location_a1
content_owner_traffic_source_a1
content_owner_device_os_a1
content_owner_subtitles_a1
content_owner_combined_a1
content_owner_asset_basic_a1
content_owner_asset_province_a1
content_owner_asset_playback_location_a1
content_owner_asset_traffic_source_a1
content_owner_asset_device_os_a1
content_owner_asset_combined_a1
Jenis laporan ini diumumkan sebagai tidak digunakan lagi pada 15 September 2016, dan laporan tidak lagi dibuat untuk jenis laporan tersebut setelah 15 Desember 2016. Laporan yang dibuat sebelumnya masih tersedia selama 180 hari sejak dibuat. Dengan demikian, beberapa laporan dapat diakses paling lambat tanggal 15 Juni 2017. Namun, karena laporan tidak lagi tersedia, tugas yang terkait dengan laporan juga tidak diperlukan.
-
24 Mei 2017
Semua tugas pelaporan untuk laporan YouTube Reporting API berikut telah dihapus:
content_owner_ad_performance_a1
content_owner_asset_estimated_earnings_a1
content_owner_estimated_earnings_a1
Jenis laporan ini diumumkan sebagai tidak digunakan lagi pada 22 Juni 2016, dan laporan tidak lagi dibuat untuk jenis laporan tersebut setelah 22 September 2016. Laporan yang dibuat sebelumnya masih tersedia selama 180 hari sejak dibuat. Dengan demikian, beberapa laporan dapat diakses paling lambat tanggal 22 Maret 2017. Namun, karena laporan tidak lagi tersedia, tugas yang terkait dengan laporan juga tidak diperlukan.
22 Mei 2017
Update ini berisi perubahan berikut:
-
YouTube Reporting API (Laporan Massal)
- Dimensi
sharing_service
, yang mengidentifikasi layanan yang digunakan untuk berbagi video, kini mendukung nilai berikut:85
: YouTube Music86
: YouTube Game87
: YouTube Kids88
: YouTube TV
Selain itu, nama yang digunakan untuk mengidentifikasi nilai
52
telah diperbarui dalam dokumentasi menjadi Kakao (Kakao Talk) untuk membedakannya dengan lebih jelas dari nilai73
(Cerita Kakao). Perubahan ini tidak mencerminkan perubahan apa pun pada perilaku API atau klasifikasi video yang dibagikan ke layanan ini.
- Dimensi
-
YouTube Analytics API (Target Kueri)
- Dimensi
sharingService
kini mendukung nilai berikut:YOUTUBE_GAMING
YOUTUBE_KIDS
YOUTUBE_MUSIC
YOUTUBE_TV
- Dimensi
28 Maret 2017
Pemilik channel yang dapat mengakses data pendapatan melalui YouTube Analytics di Creator Studio kini juga dapat mengakses data pendapatan tersebut melalui YouTube Analytics API:
-
API ini mendukung metrik terkait pendapatan berikut:
adImpressions
cpm
estimatedAdRevenue
estimatedRedPartnerRevenue
estimatedRevenue
grossRevenue
monetizedPlaybacks
playbackBasedCpm
Metrik ini didukung untuk laporan berikut:
-
Pemilik saluran kini juga dapat mengambil laporan performa iklan, yang mendukung dimensi
adType
serta dimensiday
opsional. -
Panduan contoh permintaan YouTube Analytics API kini menyertakan bagian untuk laporan pendapatan channel.
17 Maret 2017
Update ini berisi perubahan berikut:
-
YouTube Analytics API mendukung metrik
redViews
danestimatedRedMinutesWatched
, yang keduanya terkait dengan penayangan YouTube Red. Bahkan, API sebenarnya telah mendukung metrik ini selama beberapa waktu, dan YouTube Reporting API sudah mendukung kedua metrik tersebut seperti yang diumumkan pada 15 September 2016.- Metrik
redViews
mengidentifikasi berapa kali video ditonton oleh pelanggan YouTube Red. - Metrik
estimatedRedMinutesWatched
mengidentifikasi jumlah menit yang ditonton oleh pelanggan YouTube Red untuk menonton video.
Dokumentasi laporan channel dan laporan pemilik konten telah diperbarui untuk menampilkan laporan yang mendukung kedua metrik baru tersebut. Dimensi dan metrik ini didukung dalam laporan yang telah mendukung metrik
views
danestimatedMinutesWatched
. - Metrik
3 Maret 2017
Update ini berisi perubahan berikut:
-
YouTube Reporting API (Laporan Massal)
-
Definisi dimensi
date
telah dikoreksi untuk mendapatkan catatan bahwa nilai dimensi mengacu pada periode yang dimulai pada pukul 00.00 waktu Pasifik dan berakhir pada pukul 23.59 waktu Pasifik pada hari, bulan, dan tahun yang ditentukan. Bergantung pada waktu tahun tersebut, waktu Pasifik adalah UTC-7 atau UTC-8.Meskipun tanggal biasanya mewakili periode 24 jam, tanggal ketika jam disesuaikan maju mewakili periode 23 jam, dan tanggal ketika jam disesuaikan mundur mewakili periode 25 jam. (Sebelumnya, dokumentasi menyatakan bahwa setiap tanggal mewakili periode 24 jam yang unik dan waktu Pasifik selalu UTC-8.)
Perhatikan, koreksi ini tidak mewakili perubahan dalam perilaku API sebenarnya.
- Dimensi
operating_system
, yang mengidentifikasi sistem software perangkat tempat tampilan terjadi, kini mendukung nilai berikut:22
: Tizen23
: Firefox24
: RealMedia
-
Semua tugas pelaporan untuk jenis laporan
content_owner_basic_a1
telah dihapus. Jenis laporan tersebut sepenuhnya tidak digunakan lagi mulai 19 Agustus 2016, tetapi laporancontent_owner_basic_a1
yang dibuat sebelumnya masih tersedia selama 180 hari sejak dibuat. Karena itu, beberapa laporan dapat diakses paling lambat tanggal 19 Februari 2017. Namun, karena laporan tidak lagi tersedia, tugas yang terkait dengan laporan juga tidak diperlukan.
-
-
YouTube Analytics API (Target Kueri)
-
Deskripsi dimensi yang terkait dengan
time periods
telah diperbaiki untuk diperhatikan bahwa nilai dimensi mengacu pada periode yang dimulai pada pukul 00.00 waktu Pasifik dan berakhir pada pukul 23.59 waktu Pasifik pada hari, bulan, dan tahun yang ditentukan. Bergantung pada waktu tahun tersebut, waktu Pasifik adalah UTC-7 atau UTC-8.Meskipun tanggal biasanya mewakili periode 24 jam, tanggal ketika jam disesuaikan maju mewakili periode 23 jam, dan tanggal ketika jam disesuaikan mundur mewakili periode 25 jam. (Sebelumnya, dokumentasi menyatakan bahwa waktu Pasifik adalah UTC-8 dan tidak menyebutkan kemungkinan bahwa satu hari mungkin tidak mewakili periode 24 jam.)
Perhatikan, koreksi ini tidak mewakili perubahan dalam perilaku API sebenarnya.
-
Dokumentasi laporan saluran telah diperbarui untuk diperhatikan bahwa laporan saluran saat ini tidak berisi metrik penghasilan atau performa iklan. Akibatnya, cakupan
https://www.googleapis.com/auth/yt-analytics-monetary.readonly
saat ini tidak memberikan akses ke data moneter dalam laporan saluran. - Dimensi
operatingSystem
mendukung tiga nilai dimensi baru:FIREFOX
REALMEDIA
TIZEN
-
8 Februari 2017
YouTube Analytics API kini mendukung parameter include-historical-channel-data
opsional. Perlu diingat bahwa parameter ini hanya relevan saat mengambil laporan pemilik konten.
Parameter ini memungkinkan pemilik konten menunjukkan bahwa respons API harus menyertakan waktu tonton channel dan data penayangan dari jangka waktu sebelum channel ditautkan ke pemilik konten. Nilai parameter defaultnya adalah false
, yang berarti bahwa, secara default, respons API hanya menyertakan waktu tonton dan data penayangan dari waktu saat channel ditautkan ke pemilik konten.
Aturan ini juga berlaku jika permintaan API mengambil data untuk beberapa saluran:
- Jika parameter value adalah
false
, maka data waktu tonton dan penayangan yang ditampilkan untuk channel tertentu didasarkan pada tanggal saat channel tersebut ditautkan ke pemilik konten.
Penting untuk diingat bahwa channel yang berbeda mungkin telah ditautkan ke pemilik konten pada tanggal yang berbeda. Jika permintaan API mengambil data untuk beberapa saluran dan nilai parameternya adalahfalse
, respons API akan berisi waktu tonton dan data penayangan berdasarkan tanggal penautan untuk setiap saluran masing-masing. - Jika nilai parameter adalah
true
, respons akan menampilkan waktu tonton dan data penayangan untuk semua saluran berdasarkan tanggal mulai dan akhir yang ditentukan dalam permintaan API.
15 Desember 2016
Laporan YouTube Reporting API berikut tidak lagi didukung dan telah dihapus dari dokumentasi. Versi yang lebih baru untuk setiap laporan tersedia. (Pengumuman penghentian untuk laporan ini dibuat pada 15 September 2016.)
-
Laporan saluran
channel_basic_a1
- Diganti dengan laporanchannel_basic_a2
.channel_province_a1
- Diganti dengan laporanchannel_province_a2
.channel_playback_location_a1
- Diganti dengan laporanchannel_playback_location_a2
.channel_traffic_source_a1
- Diganti dengan laporanchannel_traffic_source_a2
.channel_device_os_a1
- Diganti dengan laporanchannel_device_os_a2
.channel_subtitles_a1
- Diganti dengan laporanchannel_subtitles_a2
.channel_combined_a1
- Diganti dengan laporanchannel_combined_a2
.
-
Laporan pemilik konten
content_owner_basic_a2
- Diganti dengan laporancontent_owner_basic_a3
.content_owner_province_a1
- Diganti dengan laporancontent_owner_province_a2
.content_owner_playback_location_a1
- Diganti dengan laporancontent_owner_playback_location_a2
.content_owner_traffic_source_a1
- Diganti dengan laporancontent_owner_traffic_source_a2
.content_owner_device_os_a1
- Diganti dengan laporancontent_owner_device_os_a2
.content_owner_subtitles_a1
- Diganti dengan laporancontent_owner_subtitles_a2
.content_owner_combined_a1
- Diganti dengan laporancontent_owner_combined_a2
.content_owner_asset_basic_a1
- Diganti dengan laporancontent_owner_asset_basic_a2
.content_owner_asset_province_a1
- Diganti dengan laporancontent_owner_asset_province_a2
.content_owner_asset_playback_location_a1
- Diganti dengan laporancontent_owner_asset_playback_location_a2
.content_owner_asset_traffic_source_a1
- Diganti dengan laporancontent_owner_asset_traffic_source_a2
.content_owner_asset_device_os_a1
- Diganti dengan laporancontent_owner_asset_device_os_a2
.content_owner_asset_combined_a1
- Diganti dengan laporancontent_owner_asset_combined_a2
.
Daftar jenis laporan saat ini dalam dokumentasi referensi API juga telah diperbarui.
11 November 2016
Update ini berisi perubahan berikut:
-
Laporan layar akhir
- Laporan layar akhir untuk video channel berisi statistik untuk semua video di channel.
- Laporan layar akhir untuk video pemilik konten berisi statistik untuk video di channel pemilik konten mana pun.
- Laporan layar akhir untuk aset pemilik konten berisi statistik untuk aset yang terkait dengan video yang kemudian akan ditampilkan layar akhir.
-
Dimensi layar akhir
end_screen_element_type
: Jenis elemen layar akhir yang terkait dengan statistik.end_screen_element_id
: ID yang digunakan YouTube untuk mengidentifikasi elemen layar akhir secara unik.
Metrik layar akhir
Catatan: Data untuk metrik layar akhir tersedia mulai 1 Mei 2016.
end_screen_element_impressions
: Jumlah total tayangan elemen layar akhir. Satu tayangan dicatat untuk setiap elemen layar akhir yang ditampilkan.end_screen_element_clicks
: Frekuensi elemen layar akhir diklik.end_screen_element_click_rate
: Rasio klik-tayang untuk elemen layar akhir.
-
Laporan berikut tidak lagi didukung dan telah dihapus dari dokumentasi. Versi yang lebih baru untuk setiap laporan tersedia. (Pengumuman penghentian untuk laporan ini dibuat pada 22 Juni 2016.)
content_owner_ad_performance_a1
- Diganti dengan laporancontent_owner_ad_rates_a1
.content_owner_estimated_earnings_a1
- Diganti dengan laporancontent_owner_estimated_revenue_a1
.content_owner_asset_estimated_earnings_a1
- Diganti dengan laporancontent_owner_asset_estimated_revenue_a1
.
-
Metrik dalam daftar berikut sepenuhnya tidak digunakan lagi dan tidak lagi didukung. Seperti yang diumumkan pada 10 Agustus 2016, metrik baru yang merujuk pada data yang sama sudah didukung. Tabel di bawah menampilkan nama metrik yang tidak digunakan lagi dan nama metrik baru:
Metrik yang tidak digunakan lagi Metrik baru adEarnings
estimatedAdRevenue
impressionBasedCpm
cpm
impressions
adImpressions
redPartnerRevenue
estimatedRedPartnerRevenue
- Pendapatan iklan bulanan dari seluruh dunia per video
- Pendapatan iklan harian per negara per video
- Pendapatan iklan bulanan di seluruh dunia per aset
- Pendapatan iklan harian per negara per aset
- Klaim (laporan ini tidak berisi data pendapatan)
-
API ini mendukung dua metrik baru terkait penayangan YouTube Red:
red_views
: Berapa kali video ditonton oleh pelanggan YouTube Red.red_watch_time_minutes
: Jumlah menit yang dihabiskan pelanggan YouTube Red untuk menonton video.
-
API ini mendukung versi baru 20 laporan. Semua versi baru mendukung metrik
red_views
danred_watch_time_minutes
yang baru.Untuk setiap laporan, jumlah dalam ID jenis laporan baru satu angka lebih tinggi daripada jumlah dalam ID jenis laporan lama. (Versi lama laporan ini sekarang tidak digunakan lagi seperti yang akan dijelaskan nanti dalam histori revisi ini.) Misalnya, laporan
channel_basic_a1
kini tidak digunakan lagi dan telah diganti dengan laporanchannel_basic_a2
.Daftar berikut menunjukkan ID jenis laporan baru:
Laporan video channel
Laporan video pemilik konten
Laporan aset pemilik konten
-
Catatan: Ini adalah pengumuman penghentian.
Perhatikan bahwa jika Anda sudah memiliki tugas untuk membuat versi lama laporan yang tercantum di atas, Anda harus membuat tugas baru untuk laporan yang diganti namanya. Bersama dengan rilis versi laporan baru, versi laporan berikut tidak digunakan lagi:
channel_basic_a1
channel_province_a1
channel_playback_location_a1
channel_traffic_source_a1
channel_device_os_a1
channel_subtitles_a1
channel_combined_a1
content_owner_basic_a2
content_owner_province_a1
content_owner_playback_location_a1
content_owner_traffic_source_a1
content_owner_device_os_a1
content_owner_subtitles_a1
content_owner_combined_a1
content_owner_asset_basic_a1
content_owner_asset_province_a1
content_owner_asset_playback_location_a1
content_owner_asset_traffic_source_a1
content_owner_asset_device_os_a1
content_owner_asset_combined_a1
Jika Anda memiliki pekerjaan untuk salah satu laporan tersebut, jangan berharap YouTube akan membuat laporan baru untuk pekerjaan tersebut setelah 15 Desember 2016. Laporan yang dibuat akan tetap tersedia selama 180 hari sejak dibuat.
-
Laporan
content_owner_basic_a1
sepenuhnya tidak digunakan lagi dan dihapus dari dokumentasi. YouTube tidak akan lagi membuat laporan baru dari jenis tersebut, meskipun laporan yang telah dibuat akan tetap tersedia selama 180 hari sejak dibuat.Pengganti laporan
content_owner_basic_a1
adalah laporancontent_owner_basic_a2
seperti yang dijelaskan dalam entri histori revisi untuk 19 Mei 2016. -
Persyaratan Layanan untuk Layanan untuk Layanan YouTube API yang baru dipublikasikan ("Persyaratan yang Diperbarui"), yang dibahas secara mendetail di Blog Developer dan Engineering YouTube, memberikan beragam pembaruan pada Persyaratan Layanan saat ini. Selain Persyaratan yang Diperbarui, yang akan berlaku mulai 10 Februari 2017, pembaruan ini menyertakan beberapa dokumen pendukung untuk membantu menjelaskan kebijakan yang harus dipatuhi oleh developer.
Kumpulan lengkap dokumen baru dijelaskan di histori revisi untuk Persyaratan yang Diperbarui. Selain itu, perubahan mendatang pada Persyaratan yang Diperbarui atau pada dokumen pendukung juga akan dijelaskan dalam histori revisi tersebut. Anda dapat berlangganan ke perubahan listingan feed RSS dalam histori revisi tersebut dari link dalam dokumen tersebut.
-
YouTube Analytics API (Target Kueri)
-
Catatan: Ini adalah pengumuman penghentian.
Metrik dalam tabel berikut tidak digunakan lagi. Pada saat yang sama, metrik baru yang mengacu pada data yang sama mulai diterapkan. Pada dasarnya, metrik lama telah diganti namanya, meskipun YouTube Analytics API akan mendukung kedua nama metrik tersebut hingga tanggal penghentian yang tercantum dalam tabel.
Nama metrik lama Nama metrik baru Tanggal dukungan earnings
estimatedRevenue
10 Agustus 2017 adEarnings
estimatedAdRevenue
4 November 2016 redPartnerRevenue
estimatedRedPartnerRevenue
4 November 2016 impressionBasedCpm
cpm
4 November 2016 impressions
adImpressions
4 November 2016 Perhatikan bahwa metrik
earnings
merupakan metrik inti, sehingga akan didukung selama satu tahun sejak tanggal pengumuman ini. Metrik lainnya, yang bukan merupakan metrik inti, akan didukung selama tiga bulan, hingga 4 November 2016.Misalnya, hingga 4 November 2016, permintaan API dapat menentukan metrik
impressionBasedCpm
, metrikcpm
, atau keduanya. Namun, setelah tanggal tersebut, hanya metrikcpm
yang akan didukung. - Dimensi
insightTrafficSourceType
mendukung dua nilai dimensi baru:CAMPAIGN_CARD
: Sumber traffic ini hanya didukung untuk laporan pemilik konten. Tag ini menunjukkan bahwa penayangan berasal dari video yang diklaim dan diupload pengguna, yang digunakan pemilik konten untuk mempromosikan konten yang telah ditonton.END_SCREEN
: Data ini berkaitan dengan penayangan yang berasal dari layar akhir video lain.
Untuk kedua sumber traffic baru, Anda juga dapat mengambil laporan
traffic source detail
. Dalam kedua kasus tersebut, dimensiinsightTrafficSourceDetail
mengidentifikasi video yang dirujuk penonton. -
Dimensi
adType
kini mendukung nilaiauctionBumperInstream
, yang mengacu pada iklan video yang tidak dapat dilewati berdurasi hingga 6 detik dan diputar sebelum video dapat ditonton.
-
-
YouTube Reporting API (Laporan Massal)
- Dimensi
traffic_source_type
kini mendukung nilai berikut:19
: Sumber traffic ini hanya didukung untuk laporan pemilik konten. Tag ini menunjukkan bahwa penayangan berasal dari video yang diklaim dan diupload pengguna, yang digunakan pemilik konten untuk mempromosikan konten yang telah ditonton.20
: Data ini berkaitan dengan penayangan yang berasal dari layar akhir video lain.
Untuk kedua sumber traffic baru, dimensi
traffic_source_detail
mengidentifikasi video tempat penonton diarahkan. -
Daftar metrik inti API telah dikoreksi sehingga mencantumkan
estimated_partner_revenue
sebagai metrik inti dan menghapusearnings
dari daftar tersebut. (Metrikearnings
belum pernah didukung di YouTube Reporting API.) -
Dimensi
ad_type
kini mendukung nilai19
yang mengacu pada iklan bumper, yang merupakan iklan video yang tidak dapat dilewati berdurasi hingga 6 detik yang diputar sebelum video dapat ditonton.
- Dimensi
-
YouTube Analytics API (Target Kueri)
- Daftar metrik yang didukung untuk laporan channel berikut telah diperbarui untuk menyertakan metrik kartu. Dukungan untuk metrik kartu dalam laporan ini sebenarnya ditambahkan pada 28 Juni 2016, dan entri histori revisi untuk tanggal tersebut menjelaskan perubahan tersebut secara lebih mendetail. Laporannya adalah:
- Aktivitas pengguna dasar untuk negara bagian AS
- Aktivitas pengguna di negara bagian AS untuk jangka waktu tertentu
- Aktivitas pengguna menurut provinsi
- Aktivitas pengguna menurut status berlangganan
- Aktivitas pengguna menurut status berlangganan untuk provinsi
- Video teratas berdasarkan negara bagian
- Video teratas untuk penonton yang subscribe atau tidak subscribe
-
Daftar filter telah diperbaiki untuk laporan retensi audiens channel dan laporan retensi audiens pemilik konten agar mencerminkan bahwa filter
video
diperlukan dan filtergroup
tidak didukung.Sebelumnya, dokumentasi untuk kedua laporan tersebut salah menyatakan bahwa laporan dapat diambil menggunakan salah satu dari dua filter tersebut atau tidak menggunakan satu pun filter.
- Daftar metrik yang didukung untuk laporan channel berikut telah diperbarui untuk menyertakan metrik kartu. Dukungan untuk metrik kartu dalam laporan ini sebenarnya ditambahkan pada 28 Juni 2016, dan entri histori revisi untuk tanggal tersebut menjelaskan perubahan tersebut secara lebih mendetail. Laporannya adalah:
-
YouTube Reporting API (Laporan Massal)
- Di ringkasan API, bagian yang menjelaskan cara mengambil URL download laporan telah diperbaiki sehingga menyatakan bahwa YouTube menghasilkan laporan yang dapat didownload selama beberapa hari ketika tidak ada data yang tersedia. Laporan tersebut berisi baris header, tetapi tidak berisi data tambahan. Informasi ini telah diperbarui di bagian Karakteristik laporan pada dokumen yang sama pada 12 April 2016.
- Daftar dimensi dalam laporan
content_owner_asset_cards_a1
telah diperbaiki agar mencerminkan bahwa laporan menggunakan dimensicard_id
. Sebelumnya, dokumentasi salah mencantumkan nama dimensi sebagaicard_title
.
- Statistik dasar(channel, pemilik konten)
- Berbasis waktu(channel, pemilik konten)
- Geografi pengguna (channel, pemilik konten)
- Aktivitas pengguna menurut status subscribe (channel, pemilik konten)
- Video teratas (channel, pemilik konten)
-
Bagian Karakteristik laporan pada ringkasan API telah diperbarui untuk mengklarifikasi bahwa laporan tersedia melalui API selama 180 hari sejak dibuat.
Sebelumnya, dokumentasi menyatakan bahwa laporan tersedia untuk jangka waktu hingga 180 hari sebelum tanggal permintaan API dikirim. Meskipun secara teknis juga benar, teks aslinya memang cukup membingungkan.
-
API ini mendukung versi baru dari tiga laporan. Dua dari laporan tersebut juga berisi metrik baru dan yang diganti namanya:
-
Laporan
content_owner_ad_rates_a1
adalah versi baru dari laporancontent_owner_ad_performance_a1
. Laporan yang baru diganti namanya sama dengan versi sebelumnya. -
Dua laporan yang memiliki versi baru telah diganti namanya:
- Versi baru laporan
content_owner_estimated_earnings_a1
diberi namacontent_owner_estimated_revenue_a1
. - Versi baru laporan
content_owner_asset_estimated_earnings_a1
diberi namacontent_owner_asset_estimated_revenue_a1
.
Kedua laporan yang baru diganti namanya berbeda dari pendahulunya dalam hal berikut:
- Mereka menambahkan metrik
estimated_partner_red_revenue
baru, yang memperkirakan total penghasilan dari langganan YouTube Red. - Mereka menambahkan metrik
estimated_partner_transaction_revenue
baru, yang memperkirakan pendapatan dari transaksi, seperti konten berbayar dan Fan Funding, dikurangi pengembalian dana yang ditagih partner. - Dia mengganti nama metrik
estimated_partner_ad_sense_revenue
menjadiestimated_partner_ad_auction_revenue
. - Dia mengganti nama metrik
estimated_partner_double_click_revenue
menjadiestimated_partner_ad_reserved_revenue
.
- Versi baru laporan
Perhatikan bahwa jika Anda sudah memiliki tugas untuk membuat laporan versi lama ini, Anda perlu membuat tugas baru untuk laporan yang diganti namanya. Sehubungan dengan rilis versi laporan baru, laporan
content_owner_ad_performance_a1
,content_owner_estimated_earnings_a1
, dancontent_owner_asset_estimated_earnings_a1
tidak digunakan lagi.Jika Anda memiliki pekerjaan untuk salah satu laporan tersebut, jangan berharap YouTube akan membuat laporan baru untuk pekerjaan tersebut setelah 22 September 2016. Laporan yang dibuat akan tetap tersedia selama 180 hari sejak dibuat.
-
-
Definisi properti
id
resourcereportType
telah diperbarui untuk mencerminkan kumpulan laporan yang tersedia saat ini. -
Nama dua metrik telah dikoreksi dalam dokumentasi agar cocok dengan nama yang muncul di laporan. Perubahan ini hanyalah perbaikan dokumentasi dan tidak mencerminkan perubahan pada konten laporan yang sebenarnya:
- Nama metrik
estimated_partner_adsense_revenue
telah diperbarui menjadiestimated_partner_ad_sense_revenue
. Namun, perhatikan bahwa metrik ini hanya muncul dalam dua laporan yang tidak akan digunakan lagi dengan pembaruan ini. Seperti yang dijelaskan di atas, metrik ini telah diganti namanya menjadiestimated_partner_ad_auction_revenue
dalam versi laporan tersebut yang lebih baru. - Nama metrik
estimated_partner_doubleclick_revenue
telah diperbarui menjadiestimated_partner_double_click_revenue
. Sekali lagi, perhatikan bahwa metrik ini hanya muncul dalam dua laporan yang tidak digunakan lagi dengan pembaruan ini. Seperti yang dijelaskan di atas, metrik ini telah diganti namanya menjadiestimated_partner_ad_reserved_revenue
dalam versi laporan tersebut yang lebih baru.
- Nama metrik
-
Dokumentasi dimensi untuk Reporting API telah diperbarui agar tidak lagi mencantumkan properti
elapsed_video_time_percentage
danaudience_retention_type
. Dimensi tersebut saat ini tidak didukung oleh laporan yang tersedia melalui API. -
API ini mendukung versi baru laporan aktivitas pengguna untuk pemilik konten. ID jenis laporan untuk laporan baru adalah
content_owner_basic_a2
. Tidak seperti laporan versi sebelumnya,content_owner_basic_a1
, versi baru mendukung metriklikes
dandislikes
.Jika sudah memiliki tugas untuk membuat laporan
content_owner_basic_a1
, Anda masih harus membuat tugas baru untuk laporancontent_owner_basic_a2
. YouTube tidak memigrasikan pemilik konten secara otomatis ke versi laporan baru atau otomatis membuat tugas untuk membuat versi laporan baru. Dalam beberapa implementasi, tampilan pekerjaan baru yang tidak terduga bisa menjadi perubahan yang dapat menyebabkan gangguan.Bersama dengan rilis laporan baru, laporan
content_owner_basic_a1
kini tidak digunakan lagi. Jika Anda memiliki tugas untuk laporan tersebut, jangan berharap YouTube akan membuat laporan baru untuk pekerjaan tersebut setelah 19 Agustus 2016. Laporan yang dibuat akan tetap tersedia selama 180 hari sejak dibuat. -
Resource
reportType
,job
, danreport
mendukung properti baru yang mengidentifikasi apakah resource terkait mewakili jenis laporan yang tidak digunakan lagi:-
Properti
deprecateTime
resourcereportType
menentukan tanggal dan waktu saat jenis laporan tidak akan digunakan lagi. Properti ini hanya memiliki nilai untuk laporan yang telah diumumkan sebagai tidak digunakan lagi, dan nilai tersebut mewakili tanggal saat YouTube berhenti membuat laporan jenis tersebut.Setelah jenis laporan diumumkan sebagai tidak digunakan lagi, YouTube akan membuat laporan jenis tersebut selama tiga bulan berikutnya. Misalnya, update pada 19 Mei 2016 ini mengumumkan penghentian laporan
content_owner_basic_a1
. Dengan demikian,deprecateTime
untuk jenis laporan tersebut menentukan waktu pada 19 Agustus 2016, setelah itu YouTube akan berhenti membuat laporan jenis tersebut. -
Properti
expireTime
resourcejob
menentukan tanggal dan waktu saat lowongan berakhir atau akan habis masa berlakunya. Properti ini memiliki nilai jika jenis laporan yang terkait dengan tugas sudah tidak digunakan lagi atau jika laporan yang dihasilkan untuk tugas tersebut belum didownload dalam waktu yang lama. Tanggal tersebut menandai waktu saat YouTube tidak lagi membuat laporan baru untuk lowongan tersebut. -
Properti
jobExpireTime
resourcereport
menentukan tanggal dan waktu saat tugas yang terkait dengan laporan tidak berlaku atau akan habis masa berlakunya. Properti ini berisi nilai yang sama dengan propertiexpireTime
di resourcejob
, seperti yang dijelaskan di item sebelumnya dalam daftar ini.
-
-
Metode
jobs.create
sekarang menampilkan kode respons HTTP400
(Bad Request
) jika Anda mencoba membuat tugas untuk laporan yang tidak digunakan lagi. Selain itu, dokumentasi metode sekarang mencantumkan beberapa alasan lain yang menyebabkan permintaan API gagal. -
YouTube kini menghasilkan data yang mencakup periode 180 hari sebelum tugas pelaporan pertama kali dijadwalkan. Sebelumnya, Reporting API tidak mengirimkan data historis apa pun. Perubahan ini memengaruhi semua lowongan, termasuk pekerjaan yang dibuat sebelum pengumuman ini.
Laporan historis diposting segera setelah tersedia, meskipun perlu waktu sekitar satu bulan agar semua data historis diposting untuk suatu pekerjaan. Jadi, sebulan setelah menjadwalkan pekerjaan pelaporan, Anda akan memiliki akses ke data sekitar tujuh bulan. (Semua data historis untuk pekerjaan yang dibuat sebelum pengumuman ini harus diposting dalam waktu satu bulan setelah pengumuman.)
Perhatikan bahwa data historis hanya tersedia sejak 1 Juli 2015. Akibatnya, pekerjaan yang dibuat sebelum 28 Desember 2015, akan memiliki data historis kurang dari 180 hari.
Semua perubahan ini dijelaskan di bagian data historis baru dalam ringkasan Reporting API.
-
Bagian karakteristik laporan dalam ringkasan YouTube Reporting API telah diperbarui dengan perubahan berikut:
-
Dokumentasi kini menyatakan bahwa laporan tersedia untuk jangka waktu 180 hari setelah dibuat, sehingga tersedia untuk didownload oleh klien API. Sebelumnya, dokumentasi menyatakan bahwa laporan tersedia untuk periode hingga enam bulan sebelum tanggal permintaan API dikirim.
-
Dokumentasi telah diperbarui untuk mencerminkan fakta bahwa API sekarang menghasilkan laporan yang dapat didownload selama hari-hari ketika data tidak tersedia. Laporan tersebut akan berisi baris {i>header<i}, tetapi tidak akan berisi data tambahan.
-
-
YouTube Reporting API akan segera mendukung serangkaian laporan yang dikelola sistem dan dibuat secara otomatis, yang berisi data pendapatan iklan atau data pendapatan langganan YouTube Red. Laporan ini akan tersedia bagi pemilik konten yang sudah dapat mengakses laporan pendapatan yang dapat didownload secara manual di YouTube Creator Studio. Dengan demikian, fungsi API baru akan memberikan akses terprogram ke data tersebut.
Perubahan API berikut kini diumumkan sebagai persiapan untuk peluncuran laporan yang dikelola sistem:
-
Properti
systemManaged
baru resourcejob
menunjukkan apakah resource menjelaskan tugas yang menghasilkan laporan yang dikelola sistem. YouTube secara otomatis membuat laporan yang dikelola sistem untuk pemilik konten YouTube, dan pemilik konten tidak dapat mengubah atau menghapus pekerjaan yang membuat laporan tersebut. -
Parameter
includeSystemManaged
baru metodejobs.list
menunjukkan apakah respons API harus menyertakan tugas untuk laporan yang dikelola sistem. Nilai default parameter ini adalahfalse
. -
Parameter
startTimeAtOrAfter
baru metodejobs.reports.list
menunjukkan bahwa respons API hanya boleh berisi laporan jika data paling awal dalam laporan adalah pada atau setelah tanggal yang ditentukan. Demikian pula, parameterstartTimeBefore
menunjukkan bahwa respons API hanya boleh berisi laporan jika data paling awal dalam laporan jatuh sebelum tanggal yang ditentukan.Tidak seperti parameter
createdAfter
metode, yang berkaitan dengan waktu pembuatan laporan, parameter baru berkaitan dengan data dalam laporan. -
Properti
systemManaged
baru resourcereportType
menunjukkan apakah resource menjelaskan laporan yang dikelola sistem. -
Parameter
includeSystemManaged
baru metodereportTypes.list
menunjukkan apakah respons API harus menyertakan laporan yang dikelola sistem. Nilai default parameter ini adalahfalse
.
-
- Di YouTube Reporting API, dimensi
sharing_service
mendukung nilai baru berikut:82
: Dialog aktivitas sistem iOS83
: Kotak Masuk Google84
: Android Messenger
- Di YouTube Analytics API, dimensi
sharingService
mendukung nilai baru berikut:ANDROID_MESSENGER
: Android MessengerINBOX
: Kotak Masuk GoogleIOS_SYSTEM_ACTIVITY_DIALOG
: Dialog aktivitas sistem iOS
- Dimensi
playback_location_type
mendukung dua nilai dimensi baru:7
: Data ini berkaitan dengan penayangan yang terjadi di halaman beranda atau layar utama YouTube, di feed subscription pengguna, atau di fitur penjelajahan YouTube lainnya.8
: Datanya berkaitan dengan penayangan yang terjadi langsung di halaman hasil penelusuran YouTube.
- Dimensi
traffic_source_type
kini mendukung18
sebagai nilai dimensi. Nilai ini menunjukkan bahwa jumlah tontonan video berasal dari halaman yang mencantumkan semua video di playlist. Sumber ini berbeda dengan jenis sumber14
, yang menunjukkan bahwa penayangan terjadi saat video diputar sebagai bagian dari playlist. - Dimensi
insightPlaybackLocationType
mendukung dua nilai dimensi baru:BROWSE
: Data ini berkaitan dengan penayangan yang terjadi di halaman beranda atau layar utama YouTube, di feed subscription pengguna, atau di fitur penjelajahan YouTube lainnya.SEARCH
: Datanya berkaitan dengan penayangan yang terjadi langsung di halaman hasil penelusuran YouTube.
- Dimensi
insightTrafficSourceType
kini mendukungYT_PLAYLIST_PAGE
sebagai nilai dimensi. Nilai ini menunjukkan bahwa jumlah tontonan video berasal dari halaman yang mencantumkan semua video di playlist. Sumber ini berbeda dengan jenis sumberPLAYLIST
, yang menunjukkan bahwa penayangan terjadi saat video diputar sebagai bagian dari playlist. - Di YouTube Reporting API, dimensi
operating_system
menggunakan nilai21
untuk mengidentifikasi penayangan yang terjadi melalui Chromecast. - Di YouTube Analytics API, dimensi
operatingSystem
menggunakan nilaiCHROMECAST
untuk mengidentifikasi penayangan yang terjadi melalui Chromecast. -
YouTube Analytics API kini mendukung tiga dimensi detail pemutaran baru, yang dapat digunakan di berbagai laporan channel dan pemilik konten:
liveOrOnDemand
: Dimensi ini menunjukkan apakah data dalam laporan menjelaskan aktivitas pengguna yang terjadi selama live streaming.subscribedStatus
: Dimensi ini menunjukkan apakah metrik aktivitas pengguna dalam data terkait dengan penonton yang subscribe ke channel video atau playlist tersebut.youtubeProduct
: Dimensi ini mengidentifikasi properti YouTube tempat aktivitas pengguna terjadi. Nilai yang memungkinkan mencakup situs YouTube inti (atau aplikasi YouTube), YouTube Gaming, dan YouTube Kids.
Dokumentasi telah diperbarui untuk mengidentifikasi laporan detail pemutaran baru yang tersedia untuk channel dan pemilik konten. Selain itu, banyak laporan lainnya telah diperbarui untuk mencatat bahwa satu atau beberapa dimensi ini dapat digunakan secara opsional sebagai dimensi dan/atau filter dalam laporan tersebut.
-
Format tabel yang menjelaskan laporan telah berubah untuk mempermudah Anda mengidentifikasi kombinasi dimensi, metrik, dan filter yang valid yang dapat digunakan untuk mengambil setiap laporan. Tabel di bawah, yang menjelaskan laporan "Jenis Perangkat" untuk saluran, menampilkan format baru:
Konten Dimensi: Wajib deviceType Gunakan 0 atau lebih day, liveOrOnDemand, subscribedStatus, youtubeProduct Metrik: Gunakan 1 atau lebih penayangan, estimatedMinutesWatched Filter: Gunakan 0 atau 1 negara, provinsi, benua, subContinent Gunakan 0 atau 1 video, grup Gunakan 0 atau lebih operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct Terminologi yang menjelaskan kolom wajib diisi dan opsional dijelaskan dalam dokumentasi untuk laporan channel dan pemilik konten.
-
YouTube Analytics API kini otomatis menghapus entitas yang datanya tidak dapat diambil oleh pengguna API dari filter yang mendukung beberapa nilai (
video
,playlist
, danchannel
). Sebelumnya, server API akan menampilkan error jika pengguna API tidak dapat mengakses data untuk setidaknya salah satu item yang ditentukan.Misalnya, pengguna mengirimkan permintaan API dengan filter
video
mencantumkan 20 ID video. Pengguna memiliki 18 video. Namun, satu ID video mengidentifikasi video yang dimiliki channel lain, dan ID lain mengidentifikasi video yang telah dihapus, sehingga tidak ada lagi. Dalam hal ini, server API sekarang menghapus dua video yang tidak dapat diakses pengguna, dan respons API berisi data untuk 18 video yang dimiliki pengguna API. -
Jika Anda meminta data untuk
group
YouTube Analytics kosong, API sekarang akan menampilkan set data kosong, bukan error. -
Metode
groupItems.insert
API YouTube Analytics kini menampilkan error (kode respons HTTP403
) yang tidak sah jika Anda mencoba menambahkan entitas ke grup tetapi Anda tidak memiliki akses ke entitas tersebut. Sebelumnya, API akan memungkinkan Anda menambahkan entitas ke grup, tetapi kemudian menampilkan error yang tidak sah saat Anda mencoba mengambil data laporan untuk grup tersebut. -
Metode
groups.list
YouTube Analytics API kini mendukung penomoran halaman. Jika respons API tidak memuat semua grup yang tersedia, parameternextPageToken
respons akan menentukan token yang dapat digunakan untuk mengambil halaman hasil berikutnya. Setel parameterpageToken
metode ke nilai tersebut untuk mengambil hasil tambahan. -
YouTube Analytics API kini mendukung metrik
redPartnerRevenue
, yang melaporkan total estimasi pendapatan yang diperoleh dari langganan YouTube Red untuk dimensi laporan yang dipilih. Nilai metrik mencerminkan penghasilan dari konten musik dan non-musik dan dapat dikenai penyesuaian akhir bulan.Daftar laporan pemilik konten di YouTube Analytics API telah diperbarui untuk mengidentifikasi laporan video yang mendukung metrik
redPartnerRevenue
:- Statistik dasar
- Berbasis waktu
- Geografi pengguna
- Video teratas – Untuk laporan ini,
redPartnerRevenue
juga didukung sebagai metrik pengurutan, yang berarti Anda dapat mengambil daftar video yang diurutkan berdasarkan penghasilan YouTube Red mereka.
-
Definisi laporan video teratas untuk YouTube Analytics API kini mencerminkan bahwa laporan ini juga mendukung metrik penghasilan berikut:
earnings
,adEarnings
,grossRevenue
,monetizedPlaybacks
,playbackBasedCpm
,impressions
, danimpressionBasedCpm
. -
Dokumentasi untuk dimensi
date
YouTube Reporting API telah dikoreksi agar mencerminkan tanggal yang merujuk pada periode 24 jam yang dimulai pada pukul 00.00 waktu Pasifik (UTC-8). Sebelumnya, dokumentasi menyatakan bahwa tanggal dimulai pada pukul 12.00 (GMT).Selain itu, dokumentasi YouTube Analytics API telah diperbarui untuk menyatakan bahwa semua dimensi terkait tanggal (
day
,7DayTotals
,30DayTotals
, danmonth
) merujuk ke tanggal yang dimulai pada pukul 00.00 waktu Pasifik (UTC-8). -
Metode
jobs.reports.list()
YouTube Reporting API sekarang mendukung parameter kuericreatedAfter
. Jika ditentukan, parameter ini menunjukkan bahwa respons API hanya boleh mencantumkan laporan yang dibuat setelah tanggal dan waktu yang ditentukan, termasuk laporan baru dengan data yang diisi ulang. Perhatikan bahwa nilai parameter berkaitan dengan waktu laporan dibuat dan bukan tanggal yang terkait dengan data yang ditampilkan.Nilai parameter adalah stempel waktu dalam format "Zulu" RFC3339 UTC, akurat hingga mikrodetik. Contoh:
"2015-10-02T15:01:23.045678Z"
.Praktik terbaik YouTube Reporting API juga telah diperbarui untuk menjelaskan cara menggunakan parameter
createdAfter
agar tidak berulang kali memproses laporan yang sama. -
Definisi properti
createTime
resourcejob
serta propertistartTime
,endTime
, dancreateTime
resourcereport
telah dikoreksi untuk mencatat bahwa nilai properti akurat hingga mikrodetik, bukan nanodetik. Selain itu, semua definisi kini secara akurat mencerminkan bahwa nilai properti merupakan stempel waktu. -
Dokumentasi untuk dimensi
sharingService
YouTube Analytics API telah diperbarui untuk menyertakan daftar kemungkinan nilai dimensi. Daftar ini mencakup sejumlah layanan yang baru saja didukung.Definisi dimensi
sharing_service
YouTube Reporting API juga telah diperbarui untuk mencantumkan nilai yang baru didukung. Nilai enum yang lebih besar dari59
adalah yang baru dalam daftar. -
YouTube Reporting API yang baru mengambil laporan data massal yang berisi data YouTube Analytics untuk sebuah channel atau pemilik konten. Ini dirancang untuk aplikasi yang dapat mengimpor set data besar dan menyediakan alat untuk memfilter, menyortir, dan menambang data tersebut.
Setiap laporan YouTube Reporting API berisi kumpulan dimensi dan metrik yang telah ditentukan. (Laporan YouTube Analytics API juga menggunakan metrik dan dimensi.) Dalam laporan, setiap baris data memiliki kombinasi nilai dimensi yang unik. Anda dapat menggabungkan data di seluruh baris berdasarkan nilai dimensi untuk menghitung metrik untuk setiap video, negara, video live, pengguna yang berlangganan, dan sebagainya.
Anda dapat menggunakan API untuk menjadwalkan tugas pelaporan, yang masing-masing mengidentifikasi laporan yang harus dibuat YouTube. Setelah Anda menyiapkan pekerjaan, YouTube menghasilkan laporan harian yang dapat didownload secara asinkron. Setiap laporan berisi data untuk periode 24 jam yang unik.
-
Meskipun merupakan API yang berbeda, YouTube Analytics API dan YouTube Reporting API memungkinkan developer mengambil data YouTube Analytics. Karena API menyediakan akses ke set data yang serupa, dokumentasi untuk kedua API ini dipublikasikan sebagai satu set dokumentasi.
- Tab Panduan di kumpulan dokumentasi berisi informasi yang umum untuk kedua API tersebut, termasuk petunjuk untuk mengizinkan permintaan API.
- Tab Laporan massal berisi dokumentasi referensi dan konten lainnya secara khusus untuk YouTube Reporting API.
- Tab Target kueri berisi dokumentasi referensi dan konten lainnya khusus untuk YouTube Analytics API.
- Tab Samples mencantumkan contoh kode yang tersedia untuk salah satu dari kedua API.
- Tab Alat mencantumkan referensi tambahan yang tersedia untuk membantu developer menerapkan salah satu dari kedua API tersebut.
-
Dokumentasi API telah disusun ulang sebagai upaya untuk membuat API lebih mudah dipahami. Oleh karena itu, perubahan berikut tidak menjelaskan fitur baru:
-
Dokumentasi kini berisi satu halaman yang mencantumkan semua laporan channel yang tersedia dan halaman lainnya yang mencantumkan semua laporan pemilik konten yang tersedia. Sebelumnya, dokumentasi memiliki halaman terpisah untuk laporan video channel, laporan playlist channel, dan sebagainya.
-
Ringkasan model data baru ini berupaya memberikan pengantar yang lebih jelas tentang cara kerja API. Secara khusus, dokumen ini berupaya menjelaskan dengan lebih baik cara YouTube menggunakan metrik, dimensi, dan filter untuk menghitung nilai laporan.
-
Metode
reports.query
API, yang Anda gunakan untuk mengambil laporan, kini didokumentasikan secara terpisah. Informasi di halaman tersebut sebelumnya ada di beberapa halaman lain. Halaman baru ini dirancang untuk membantu Anda lebih mudah mengidentifikasi informasi yang perlu dikirimkan untuk mengambil laporan.
-
-
Metrik
adEarnings
yang baru mencakup estimasi total penghasilan (pendapatan bersih) dari semua sumber iklan yang dijual oleh Google. Metrik ini bukan metrik inti. API mendukung metrikadEarnings
untuk laporan apa pun yang telah mendukung metrikearnings
.Selain itu, definisi metrik
earnings
telah dikoreksi untuk mencerminkan fakta bahwa nilainya mencakup total estimasi penghasilan dari semua sumber iklan yang dijual Google serta dari sumber non-iklan. Sebelumnya, definisi tersebut salah menunjukkan bahwa metrik hanya menyertakan penghasilan dari sumber iklan. -
Metrik
primaryAdGrossRevenue
tidak digunakan lagi. Sebagai gantinya, gunakan metrikgrossRevenue
untuk mengambil data pendapatan. -
Selain metrik
primaryAdGrossRevenue
yang tidak digunakan lagi, laporan performa iklan tidak lagi mendukung metrikmonetizedPlaybacks
danplaybackBasedCpm
. Namun, beberapa laporan video masih mendukung metrik tersebut. -
API tersebut kini mendukung dua metrik baru untuk laporan video,
videosAddedToPlaylists
danvideosRemovedFromPlaylists
. Daftar laporan video untuk channel dan pemilik konten telah diperbarui untuk mengidentifikasi laporan yang mendukung metrik baru tersebut.videosAddedToPlaylists
– Berapa kali video dalam cakupan kueri ditambahkan ke playlist YouTube mana pun. Video mungkin telah ditambahkan ke playlist pemilik video atau ke playlist channel lain.videosRemovedFromPlaylists
– Berapa kali video yang tercakup dalam kueri dihapus dari playlist YouTube mana pun. Video mungkin telah dihapus dari playlist pemilik video atau dari playlist channel lain.
Kedua metrik tersebut menyertakan playlist default seperti playlist "Tonton Nanti". Namun, metrik ini tidak menghitung playlist yang ditambahi video secara otomatis, seperti playlist upload channel atau histori tontonan pengguna. Perhatikan juga bahwa metrik ini mencerminkan jumlah penambahan dan penghapusan absolut. Jadi, jika pengguna menambahkan video ke playlist, lalu menghapusnya, lalu menambahkannya lagi, metrik tersebut menunjukkan bahwa video tersebut telah ditambahkan ke dua playlist dan dihapus dari satu playlist.
Data untuk metrik ini tersedia mulai 1 Oktober 2014.
-
Metrik
favoritesAdded
danfavoritesRemoved
tidak digunakan lagi mulai pengumuman ini. Keduanya adalah metrik inti dan tunduk pada Kebijakan Penghentian Layanan yang ditetapkan dalam persyaratan layanan. -
Parameter
currency
baru memungkinkan Anda mengambil metrik penghasilan dalam mata uang selain dolar Amerika Serikat (USD
). Jika parameter ditetapkan, API akan mengonversi nilai untuk metrikearnings
,grossRevenue
,playbackBasedCpm
, danimpressionBasedCpm
ke mata uang yang ditentukan. Nilai yang ditampilkan adalah perkiraan yang dihitung menggunakan nilai tukar yang berubah setiap hari.Nilai parameter adalah kode mata uang ISO 4217 tiga huruf. Nilai default-nya adalah
USD
. Definisi parameter berisi daftar kode mata uang yang didukung. -
Sekarang, API ini mendukung kemampuan untuk membuat dan mengelola grup YouTube Analytics serta kemampuan untuk mengambil data laporan untuk grup tersebut.
-
Membuat dan mengelola grup
Update ini memperkenalkan resource
group
dangroupItem
untuk membuat dan mengelola grup.- Referensi
group
mewakili grup Analytics, yaitu kumpulan kustom yang berisi hingga 200 channel, video, playlist, atau aset. API mendukung metodelist
,insert
,update
, dandelete
untuk resource ini. - Resource
groupItem
mewakili item dalam grup Analytics. API mendukung metodelist
,insert
, dandelete
untuk resource ini.
Jadi, misalnya, Anda dapat membuat grup menggunakan metode
groups.insert
, lalu menambahkan item ke grup tersebut menggunakan metodegroupItems.insert
. - Referensi
-
Mengambil data laporan untuk grup
Dokumentasi dimensi telah diperbarui untuk menyertakan dimensi
group
, yang dapat digunakan sebagai filter bagi banyak laporan channel dan laporan pemilik konten. Saat Anda menggunakan filtergroup
, API akan menampilkan data untuk semua item dalam grup tersebut. Perhatikan bahwa API saat ini tidak mendukung kemampuan untuk membuat laporan untuk grup aset.
Buka Pusat Bantuan YouTube untuk mengetahui informasi lebih lanjut mengenai grup YouTube Analytics.
-
-
API tidak lagi mendukung dimensi
show
. -
API kini mendukung kemampuan untuk menentukan beberapa nilai untuk dimensi
video
,playlist
,channel
, danshow
saat dimensi tersebut digunakan sebagai filter. Untuk menentukan beberapa nilai, setel parameter valuefilters
ke daftar yang dipisahkan koma dari ID video, playlist, channel, atau acara yang respons API-nya harus difilter. Nilai parameter dapat menentukan hingga 200 ID.Jika Anda menentukan beberapa nilai untuk filter yang sama, Anda juga dapat menambahkan filter tersebut ke daftar dimensi yang Anda tentukan untuk permintaan. Hal ini berlaku meskipun filter tidak tercantum sebagai dimensi yang didukung untuk laporan tertentu. Jika Anda menambahkan filter ke daftar dimensi, API juga akan menggunakan nilai filter untuk mengelompokkan hasil.
Lihat definisi parameter
filters
untuk detail selengkapnya tentang fungsi ini. -
Saat mengambil laporan saluran, Anda kini dapat mengambil data untuk saluran pengguna yang diautentikasi dengan menetapkan nilai parameter
ids
kechannel==MINE
. (Anda juga tetap dapat menetapkan parameterids
kechannel==CHANNEL_ID
untuk mengambil data untuk saluran yang ditentukan.) -
API tersebut kini mendukung laporan playlist, yang berisi statistik terkait jumlah tontonan video yang terjadi dalam konteks playlist. Laporan playlist tersedia untuk channel dan pemilik konten.
Semua laporan playlist mendukung metrik
views
danestimatedMinutesWatched
, dan beberapa laporan juga mendukung metrikaverageViewDuration
.Selain itu, semua laporan playlist mendukung metrik baru berikut. Perhatikan bahwa setiap metrik ini hanya mencerminkan penayangan playlist yang terjadi di web.
playlistStarts
: Berapa kali penonton memulai pemutaran playlist.viewsPerPlaylistStart
: Jumlah rata-rata penayangan video yang terjadi setiap kali playlist dimulai.averageTimeInPlaylist
: Estimasi jumlah waktu rata-rata, dalam menit, yang dihabiskan penonton untuk menonton video dalam playlist setelah playlist dimulai.
Setiap permintaan untuk mengambil laporan playlist harus menggunakan filter
isCurated
, yang harus ditetapkan ke1
(isCurated==1
). -
API tersebut kini mendukung laporan retensi audiens. Laporan ini mengukur kemampuan video untuk mempertahankan audiensnya. Dimensi
elapsedVideoTimeRatio
baru dalam laporan ini mengukur jumlah video yang telah berlalu untuk nilai metrik yang sesuai:-
Metrik
audienceWatchRatio
mengidentifikasi rasio absolut penonton yang menonton video pada titik tertentu dalam video. Rasio ini dihitung dengan membandingkan berapa kali suatu bagian video ditonton dengan total jumlah penayangan video.Perhatikan bahwa sebagian video dapat ditonton lebih dari sekali (atau tidak sama sekali) dalam penayangan video tertentu. Misalnya, jika pengguna memundurkan dan menonton bagian yang sama dari video beberapa kali, maka rasio absolut untuk bagian video tersebut bisa lebih besar dari
1
. -
Metrik
relativeRetentionPerformance
menunjukkan seberapa baik video mempertahankan penonton selama pemutaran dibandingkan dengan semua video YouTube yang berdurasi hampir sama. Nilai 0 menunjukkan bahwa video tersebut mempertahankan penonton dengan lebih buruk daripada video lain dengan durasi yang sama, sedangkan nilai 1 menunjukkan bahwa video tersebut mampu mempertahankan penonton dengan lebih baik daripada video lain dengan durasi yang sama. Nilai median 0,5 menunjukkan bahwa setengah dari video dengan durasi yang sama mampu mempertahankan penonton dengan lebih baik, sedangkan separuhnya mempertahankan penonton dengan lebih buruk.
Anda juga dapat menggunakan filter
audienceType
sehingga laporan hanya menampilkan data yang terkait dengan penayangan organik, penayangan dari iklan TrueView in-stream, atau penayangan dari iklan TrueView dalam-tampilan. (Penayangan organik adalah hasil langsung dari tindakan pengguna, seperti penelusuran video atau klik pada rekomendasi video.) -
-
API ini mendukung beberapa metrik baru yang terkait dengan anotasi. Metrik yang tercantum di bawah dapat diambil dengan laporan yang sebelumnya mendukung metrik
annotationClickThroughRate
danannotationCloseRate
.annotationImpressions
: Jumlah total tayangan anotasi.annotationClickableImpressions
: Jumlah anotasi yang muncul dan dapat diklik.annotationClosableImpressions
: Jumlah anotasi yang muncul dan dapat ditutup.annotationClicks
: Jumlah total anotasi yang diklik.annotationCloses
: Jumlah total anotasi tertutup.
Semua metrik baru merupakan metrik inti dan tunduk pada Kebijakan Penghentian Layanan. Namun, perhatikan bahwa data tersedia untuk metrik baru per 16 Juli 2013. (Data untuk metrik
annotationClickThroughRate
danannotationCloseRate
tersedia sejak 10 Juni 2012.) -
GOOGLE_SEARCH
tidak lagi dilaporkan sebagai nilai terpisah untuk dimensiinsightTrafficSourceType
. Sebagai gantinya, rujukan dari hasil penelusuran Google kini diatribusikan ke jenis sumber trafficEXT_URL
. Akibatnya, Anda juga tidak dapat lagi mengambil laporaninsightTrafficSourceDetail
yang menetapkan filterinsightTrafficSourceType
keGOOGLE_SEARCH
. -
Dokumen laporan pemilik konten telah diperbarui untuk mencerminkan bahwa metrik
subscribersGained
dansubscribersLost
kini dapat diambil untuk konten yang diklaim atau diupload oleh pemilik konten.Perubahan tersebut dapat dilihat di laporan statistik dasar pertama untuk pemilik konten, yang kini mendukung filter
claimedStatus
danuploaderType
. -
Dokumen contoh permintaan telah didesain ulang untuk mengelompokkan contoh dalam kategori, menggunakan format tab yang mirip dengan yang baru dirilis untuk laporan pemilik konten dan channel. Dengan desain baru ini, contoh dikelompokkan ke dalam kategori berikut:
- Statistik dasar
- Berbasis waktu
- Geografis
- Lokasi pemutaran
- Sumber traffic
- Perangkat/OS
- Demografi
- Sosial
- Penghasilan/Iklan (hanya untuk laporan pemilik konten)
-
Dokumen contoh permintaan kini menyertakan contoh baru untuk mengambil data spesifik per provinsi dalam laporan saluran atau laporan pemilik konten.
-
Metrik spesifik per provinsi untuk negara bagian AS dan Washington D.C.: Laporan ini mengambil perincian jumlah penayangan setiap provinsi dan statistik lain untuk video di suatu channel. Data ini mencakup negara bagian Amerika Serikat dan Washington D.C. Contoh ini menggunakan dimensi
province
, dan juga menggunakan parameterfilters
untuk membatasi respons agar hanya menyertakan hasil untuk Amerika Serikat. -
Demografi penonton di California (kelompok usia dan gender): Laporan ini mengambil statistik tentang kelompok usia dan gender penonton di California yang menonton video channel atau, untuk laporan pemilik konten, konten yang diklaim dari pemilik konten. Contoh ini menggunakan parameter
filters
untuk memastikan respons hanya menyertakan data untuk provinsi tertentu.
-
-
Definisi dimensi
province
telah diperbarui untuk diperhatikan bahwa saatprovince
disertakan dalam nilai parameterdimensions
, permintaan juga harus membatasi data ke Amerika Serikat dengan menyertakancountry==US
dalam nilai parameterfilters
. -
Dokumen yang mencantumkan laporan channel dan pemilik konten yang didukung telah dirancang ulang. Daripada menyediakan tabel yang mencantumkan semua kemungkinan laporan, setiap dokumen mengelompokkan laporan ke dalam kategori:
- Statistik dasar
- Berbasis waktu
- Geografis
- Lokasi pemutaran
- Sumber traffic
- Perangkat/OS
- Demografi
- Sosial
- Video teratas
Setiap dokumen menampilkan kategori ini sebagai daftar tab, dan Anda dapat mengklik tab mana pun untuk melihat laporan yang didukung dalam kategori tersebut.
-
API tersebut kini mendukung tiga dimensi geografis baru:
province
,continent
, dansubContinent
.-
Dimensi
province
memungkinkan Anda mengambil statistik untuk negara bagian AS dan Distrik Kolombia. API ini mendukung dua penggunaan dimensi ini:-
API ini mendukung dua laporan yang memerinci statistik berdasarkan setiap negara bagian. Kedua laporan tersedia untuk channel dan pemilik konten.
- Laporan statistik inti menyediakan beberapa statistik, termasuk jumlah penayangan dan perkiraan menit ditonton.
- Laporan berbasis waktu memberikan statistik yang sama, tetapi menggabungkan data per hari, 7 hari, 30 hari, atau bulanan.
-
Anda dapat menggunakan parameter kueri
filters
untuk membatasi laporan agar hanya berisi statistik untuk status tertentu. Beberapa laporan mendukung jenis pemfilteran ini, termasuk laporan geografis, laporan lokasi pemutaran, laporan sumber traffic, laporan perangkat, laporan sistem operasi, laporan demografis, dan laporan video teratas.
-
-
Dimensi
continent
menentukan kode wilayah statistik Perserikatan Bangsa-Bangsa (PBB) yang mengidentifikasi benua. Dimensi ini hanya dapat digunakan sebagai filter. -
Dimensi
subContinent
menentukan kode wilayah statistik Perserikatan Bangsa-Bangsa (PBB) yang mengidentifikasi subwilayah benua. Dimensi ini juga hanya dapat digunakan sebagai filter.Karena setiap sub-wilayah hanya dikaitkan dengan satu benua, Anda tidak perlu menggunakan filter
continent
saat menggunakan filtersubContinent
. (Bahkan, API akan mengembalikan error jika permintaan menggunakan kedua dimensi.)
-
-
Dokumentasi telah diperbaiki sehingga dimensi
insightTrafficSourceDetail
tidak menyertakan nilaiinsightTrafficSourceType
PROMOTED
sebagai nilai filter yang valid. -
YouTube Analytics API kini tunduk pada Kebijakan Penghentian Layanan yang dijelaskan dalam Persyaratan Layanan. Namun, dimensi non-inti dan metrik non-inti API tidak tunduk pada Kebijakan Penghentian Layanan. Halaman dimensi dan metrics telah diperbarui untuk mencantumkan dimensi inti dan metrik inti. Selain itu, definisi pada halaman tersebut telah diperbarui untuk mengidentifikasi dimensi dan metrik inti secara eksplisit.
-
API sekarang mendukung
EXTERNAL_APP
sebagai nilai untuk dimensiinsightPlaybackLocationType
. Sehubungan dengan pembaruan ini, mulai 10 September 2013, pemutaran tidak lagi dikategorikan sebagaiMOBILE
pemutaran, meskipun pemutaran di perangkat seluler yang dilakukan sebelum tanggal tersebut akan tetap dikategorikan dengan nilai tersebut.Dengan update ini, pemutaran di perangkat seluler kini diklasifikasikan sebagai pemutaran
WATCH
,EMBEDDED
, atauEXTERNAL_APP
, bergantung pada jenis aplikasi tempat pemutaran terjadi. -
API sekarang mendukung
PLAYLIST
sebagai nilai untuk dimensiinsightTrafficSourceType
. Nilai tersebut menunjukkan bahwa jumlah tontonan video dirujuk dari playlist. Sebelumnya, tampilan ini telah diklasifikasikan menggunakan kategoriYT_OTHER_PAGE
dimensi. -
API tersebut kini mendukung kemampuan untuk mengurutkan laporan menurut beberapa dimensi dan metrik. Contoh dokumen permintaan berisi contoh baru, Mengurutkan permintaan berdasarkan beberapa dimensi/metrik, yang menunjukkan fungsi ini. Permintaan mengambil data sumber traffic dan memiliki nilai parameter
sort
day,-views
. Hasil diurutkan secara kronologis, tetapi dalam hasil yang ditetapkan untuk setiap hari, baris pertama berisi data untuk sumber traffic yang menghasilkan penayangan terbanyak, baris kedua berisi data untuk sumber yang menghasilkan jumlah penayangan tertinggi berikutnya, dan seterusnya. -
API tersebut kini mendukung dua dimensi baru,
deviceType
danoperatingSystem
, yang dapat digunakan untuk mengambil data tentang perangkat yang digunakan penonton untuk menonton video Anda. API mendukung laporan yang menggunakan salah satu atau kedua dimensi tersebut.-
Laporan
deviceType
memungkinkan Anda mengambil jumlah penayangan dan estimasi waktu tonton untuk berbagai jenis perangkat, termasuk perangkat desktop, seluler, dan tablet. Anda juga dapat menggunakan filteroperatingSystem
untuk membatasi laporan jenis perangkat agar hanya berisi statistik untuk perangkat yang menjalankan sistem operasi tertentu, seperti Android atau iOS. -
Laporan
operatingSystem
memungkinkan Anda mengambil jumlah penayangan dan perkiraan waktu tonton untuk berbagai sistem operasi, seperti Android, iOS, Linux, dan lainnya. Anda juga dapat menggunakan filterdeviceType
untuk membatasi laporan sistem operasi agar hanya berisi statistik untuk jenis perangkat tertentu, seperti perangkat seluler atau tablet.
Laporan sistem operasi dan jenis perangkat baru tersedia untuk saluran dan pemilik konten.
-
-
Dokumen contoh permintaan telah diperbarui dengan menyertakan tiga laporan perangkat untuk channel dan tiga laporan perangkat untuk pemilik konten.
-
Dimensi
insightPlaybackLocationType
dapat menampilkan nilaiYT_OTHER
, yang mengidentifikasi tampilan yang tidak diklasifikasikan menggunakan salah satu nilai dimensi lainnya. -
Dokumen laporan pemilik konten telah diperbarui untuk mencerminkan bahwa Anda dapat mengurutkan laporan video teratas dalam urutan penghasilan menurun untuk mengidentifikasi video dengan penghasilan tertinggi. Laporan ini adalah laporan pertama yang tercantum di tabel kedua di bagian Laporan aktivitas pengguna dan penghasilan.
-
YouTube tidak lagi mengidentifikasi fitur dan layanan API eksperimental. Sebagai gantinya, kini kami menyediakan daftar YouTube API yang tunduk pada kebijakan penghentian layanan.
-
API tersebut kini mendukung kemampuan untuk mengambil metrik waktu tonton –
estimatedMinutesWatched
,averageViewDuration
, danaverageViewPercentage
– bersama dengan metrik lainnya, termasuk metrik penayangan, metrik engagement, metrik penghasilan, dan metrik performa iklan.Daftar laporan channel dan laporan pemilik konten yang tersedia telah diperbarui untuk mencerminkan perubahan ini. (Daftar tersebut sekarang lebih pendek karena metrik waktu tonton dapat diambil sebagai bagian dari laporan lain yang tercantum.)
Dokumen Contoh permintaan API juga telah diperbarui.
-
Laporan yang menggunakan dimensi
insightPlaybackLocationDetail
daninsightTrafficSourceDetail
telah ditingkatkan dengan cara berikut:-
Filter tersebut kini mendukung filter
country
opsional. -
Pemilik konten kini dapat mengambil laporan ini menggunakan salah satu kombinasi
filter
baru berikut. Perlu diketahui bahwa semua kombinasi ini juga mendukung filtercountry
opsional.-
Detail lokasi pemutaran
channel,insightPlaybackLocationType==EMBEDDED
show,insightPlaybackLocationType==EMBEDDED
claimedStatus,insightPlaybackLocationType==EMBEDDED
uploaderType,insightPlaybackLocationType==EMBEDDED
uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED
-
Detail sumber traffic
channel,insightTrafficSourceType
show,insightTrafficSourceType
claimedStatus,insightTrafficSourceType
uploaderType,insightTrafficSourceType
uploaderType,claimedStatus,insightTrafficSourceType
-
-
-
Dokumen Contoh permintaan API baru memberikan contoh yang menunjukkan cara mengambil berbagai jenis laporan menggunakan YouTube Analytics API. Setiap contoh akan menyertakan deskripsi singkat tentang laporan yang diambil oleh permintaan, lalu menampilkan dimensi, metrik, filter, dan parameter pengurutan untuk permintaan tersebut.
-
Dimensi
insightTrafficSourceType
kini mendukungSUBSCRIBER
sebagai nilai yang valid. Nilai ini mengidentifikasi jumlah tontonan video yang dirujuk dari feed di halaman beranda YouTube atau dari fitur subscription YouTube. Jika Anda memfilter berdasarkan sumber traffic ini, kolominsightTrafficSourceDetail
akan menentukan feed halaman beranda atau halaman lain tempat penayangan dirujuk. -
API tersebut sekarang mendukung dua metrik baru,
annotationClickThroughRate
danannotationCloseRate
, yang terkait dengan interaksi penonton dengan anotasi yang ditampilkan selama video Anda diputar. Daftar laporan channel dan laporan pemilik konten telah diperbarui untuk mengidentifikasi laporan yang mendukung metrik baru tersebut.annotationClickThroughRate
– Rasio anotasi yang diklik penonton terhadap jumlah total tayangan anotasi yang dapat diklik.annotationCloseRate
– Rasio anotasi yang ditutup pelihat terhadap jumlah total tayangan anotasi.
-
API tersebut kini mendukung metrik penghasilan dan performa iklan serta laporan performa iklan baru. Semua metrik dan laporan hanya dapat diakses oleh partner konten YouTube yang berpartisipasi dalam Program Partner YouTube.
-
Laporan yang baru didukung mendukung metrik performa iklan berbasis pemutaran dan metrik performa iklan berbasis tayangan. Lihat dokumentasi laporan pemilik konten untuk informasi selengkapnya tentang laporan performa iklan.
-
Metrik yang baru didukung tercantum di bawah ini. Daftar laporan pemilik konten telah diperbarui untuk mengidentifikasi laporan, termasuk dua laporan baru, yang mendukung metrik ini.
earnings
– Total estimasi penghasilan dari semua sumber iklan yang dijual Google.grossRevenue
– Estimasi pendapatan kotor dari partner Google atau DoubleClick.primaryAdGrossRevenue
– Estimasi pendapatan kotor, dijumlahkan dan diklasifikasikan berdasarkan jenis iklan utama untuk pemutaran video yang dicakup dalam laporan, dari partner Google atau DoubleClick.monetizedPlaybacks
– Jumlah pemutaran yang menampilkan setidaknya satu tayangan iklan.playbackBasedCpm
– Estimasi pendapatan kotor per seribu pemutaran.impressions
– Jumlah tayangan iklan terverifikasi yang ditayangkan.impressionBasedCpm
– Perkiraan pendapatan kotor per seribu tayangan iklan.
Catatan: Lihat definisi metrik untuk detail selengkapnya.
-
Setiap permintaan yang mengambil penghasilan atau metrik performa iklan harus mengirimkan token otorisasi yang memberikan akses menggunakan cakupan
https://www.googleapis.com/auth/yt-analytics-monetary.readonly
yang baru.
-
-
Dokumentasi API telah diatur ulang sehingga berbagai jenis laporan dijelaskan pada halaman terpisah. Oleh karena itu, kini ada halaman terpisah yang menjelaskan berbagai jenis laporan channel dan laporan pemilik konten.
-
Panduan referensi API kini memiliki bagian contoh, yang mencakup contoh kode yang menunjukkan cara memanggil API menggunakan library klien Java, JavaScript, Python, dan Ruby. Contoh kode JavaScript sama dengan yang dibahas secara mendetail dalam dokumentasi contoh aplikasi.
-
Panduan referensi API kini menampilkan APIs Explorer, yang memungkinkan Anda memanggil API, melihat permintaan API, dan mengambil data riil dalam respons.
-
API ini mendukung sejumlah laporan baru untuk channel dan pemilik konten, yang dijelaskan di bawah. Setiap laporan tersedia sebagai laporan channel atau laporan pemilik konten. Halaman Dimensi dan metrics juga telah diperbarui sebagaimana mestinya.
-
Laporan lokasi pemutaran menentukan jumlah penayangan video yang terjadi di berbagai jenis halaman atau aplikasi.
-
Laporan detail lokasi pemutaran mengidentifikasi pemutar tersemat yang menghasilkan penayangan terbanyak untuk video tertentu. Laporan ini memberikan tampilan yang lebih mendetail daripada laporan lokasi pemutaran dengan mengidentifikasi URL yang terkait dengan pemutar sematan teratas.
-
Laporan sumber traffic mengidentifikasi jumlah penayangan video yang berasal dari berbagai jenis perujuk.
-
Laporan detail sumber traffic mengidentifikasi perujuk yang menghasilkan penayangan terbanyak untuk video tertentu dan jenis sumber traffic tertentu. Misalnya, laporan ini dapat menunjukkan video terkait yang paling banyak mengirimkan traffic ke video tertentu. Laporan ini didukung untuk beberapa sumber traffic.
-
Laporan waktu tonton menampilkan jumlah waktu yang dihabiskan penonton untuk menonton konten Anda. Laporan tersebut dapat menggabungkan data untuk jangka waktu tertentu – hari, tujuh hari sebelumnya, 30 hari sebelumnya, dst. – atau negara. Jika laporan menggabungkan data menurut hari atau negara, laporan juga dapat menentukan durasi rata-rata setiap penayangan video serta persentase rata-rata setiap video yang ditonton pengguna.
-
-
YouTube Analytics API kini tersedia untuk semua developer. Anda dapat mengaktifkan API untuk project, tanpa harus meminta akses terlebih dahulu, dari panel Layanan di APIs console.
-
Bagian Memulai yang baru menguraikan prasyarat dan langkah dasar untuk membangun aplikasi yang menggunakan YouTube Analytics API.
-
Bagian baru memahami penggunaan kuota memberikan panduan untuk mengoptimalkan penggunaan kuota API. Server API menghitung biaya kueri untuk setiap permintaan, dan biaya tersebut dipotong dari kuota penggunaan API Anda. Karena berbagai jenis laporan dapat memiliki biaya kueri yang sangat berbeda, Anda harus merencanakan untuk menggunakan kuota secara efisien, dan aplikasi Anda hanya boleh meminta metrik dan data yang benar-benar dibutuhkan.
-
Bagian dimensi sementara telah diperbarui untuk menjelaskan bahwa dimensi tersebut menunjukkan bahwa laporan Analytics harus menggabungkan data berdasarkan jangka waktu. API ini kini mendukung dimensi sementara tambahan berikut:
7DayTotals
– Data dalam laporan akan digabungkan sehingga setiap baris berisi data selama periode tujuh hari.30DayTotals
– Data dalam laporan akan digabungkan sehingga setiap baris berisi data selama periode 30 hari.month
– Data dalam laporan akan digabungkan berdasarkan bulan kalender.
Demikian pula, bagian laporan yang tersedia telah diperbarui guna mencerminkan dukungan API untuk laporan yang menggunakan dimensi ini.
-
Bagian Dimensi entitas pelaporan telah diperbarui untuk diperhatikan bahwa permintaan API untuk mengambil laporan pemilik konten harus memfilter data menggunakan salah satu dimensi ini (
video
,channel
, ataushow
) atau kombinasi dimensiclaimedStatus
danuploaderType
yang didukung. -
API ini kini mendukung dua opsi pengurutan baru untuk laporan video teratas. Laporan ini, yang tersedia sebagai laporan channel atau laporan pemilik konten, berisi metrik (penayangan, komentar, suka, dsb.) di setiap negara dan memerinci metrik tersebut berdasarkan video. Sekarang Anda dapat mengurutkan laporan ini berdasarkan jumlah pengguna yang subscribe ke atau unsubscribe dari channel dari halaman tonton video.
-
Definisi metrics
subscribersGained
dansubscribersLost
telah diperbarui untuk menjelaskan bahwa channel dapat memperoleh atau kehilangan subscriber di beberapa tempat, termasuk halaman tonton video, halaman channel, dan panduan yang muncul di halaman beranda YouTube. Saat metrik ini muncul dalam laporan khusus video, metrik tersebut hanya menyertakan statistik dari halaman tonton video tertentu.
YouTube Reporting API mendukung tiga laporan layar akhir baru serta dimensi dan metrik baru untuk laporan tersebut. Laporan tersebut memberikan statistik tayangan dan klik-tayang untuk layar akhir yang ditampilkan setelah video berhenti diputar.
Pusat Bantuan YouTube berisi informasi yang lebih mendetail tentang menambahkan layar akhir ke video.
8 November 2016
Pembaruan ini berisi perubahan berikut pada YouTube Analytics API:
27 Oktober 2016
YouTube kini secara otomatis membuat serangkaian laporan pendapatan iklan yang dikelola sistem untuk pemilik konten yang memiliki akses ke laporan terkait di bagian Laporan pada Creator Studio YouTube. Laporan API terkelola sistem yang baru dirancang untuk memberikan akses terprogram ke data yang juga tersedia di laporan Creator Studio yang dapat didownload secara manual.
Ringkasan laporan yang dikelola sistem memberikan ringkasan singkat tentang laporan baru dan menjelaskan proses untuk mengambilnya melalui API. Proses ini sedikit berbeda dengan proses pengambilan laporan massal untuk YouTube Analytics karena partner tidak perlu menjadwalkan tugas untuk membuat laporan.
Properti id
resource reportType
telah diperbarui untuk menyertakan daftar laporan terkelola sistem yang dapat Anda akses melalui API:
27 September 2016
Catatan: Ini adalah pengumuman penghentian.
Metrik uniques
YouTube Analytics API tidak digunakan lagi. Ini bukanlah metrik inti dan akan didukung hingga 31 Oktober 2016.
15 September 2016
Pembaruan ini berisi perubahan YouTube Reporting API berikut:
19 Agustus 2016
Pembaruan ini berisi perubahan YouTube Reporting API berikut:
11 Agustus 2016
Update ini berisi perubahan berikut:
10 Agustus 2016
Update ini mencakup perubahan berikut:
18 Juli 2016
Update ini mencakup perubahan berikut:
28 Juni 2016
Dokumentasi YouTube Analytics API telah diperbarui guna mencerminkan dukungan untuk metrik kartu dalam berbagai laporan channel dan pemilik konten. Metrik yang baru didukung adalah:
Metrik didukung di jenis laporan berikut:
22 Juni 2016
Pembaruan ini berisi perubahan YouTube Reporting API berikut. Perubahan pertama berkaitan dengan API secara umum, dan perubahan lainnya hanya memengaruhi laporan pemilik konten:
19 Mei 2016
Pembaruan ini berisi perubahan YouTube Reporting API berikut:
12 April 2016
Pembaruan ini berisi perubahan berikut, yang semuanya hanya memengaruhi YouTube Reporting API:
28 Maret 2016
YouTube Reporting API dan YouTube Analytics API kini menampilkan statistik penayangan untuk beberapa layanan berbagi lainnya.
16 Maret 2016
Pembaruan ini berisi perubahan berikut, yang memengaruhi YouTube Reporting API dan YouTube Analytics API:
YouTube Reporting API
YouTube Analytics API
8 Februari 2016
Daftar metrik yang didukung untuk YouTube Analytics API telah diperbarui sehingga metrik kartu tidak lagi tercantum sebagai metrik yang didukung untuk API tersebut. (Tidak ada laporan API yang didokumentasikan untuk mendukung metrik kartu apa pun.)
Perlu diperhatikan bahwa Anda masih dapat mengambil metrik kartu menggunakan YouTube Reporting API, yang mendukung metrik tersebut untuk berbagai laporan channel dan pemilik konten.
6 Januari 2016
YouTube Reporting API dan YouTube Analytics API kini secara khusus mengidentifikasi penayangan yang terjadi melalui perangkat Chromecast.
21 Desember 2015
Dalam dokumentasi, nama metrik annotation_clickable_impressions
dan annotation_closable_impressions
telah diperbarui agar cocok dengan nama yang ditampilkan dalam laporan. Sebelumnya, nama-nama tersebut didokumentasikan sebagai clickable_annotation_impressions
dan closable_annotation_impressions
.
18 Desember 2015
Hukum Uni Eropa (EU) mewajibkan pengungkapan tertentu untuk diberikan kepada dan izin diperoleh dari pengguna akhir di EU. Oleh karena itu, bagi pengguna akhir di Uni Eropa, Anda harus mematuhi Kebijakan Izin Pengguna Uni Eropa. Kami telah menambahkan pemberitahuan tentang persyaratan ini dalam Persyaratan Layanan YouTube API.
15 Desember 2015
Pembaruan ini berisi perubahan berikut, yang semuanya memengaruhi YouTube Analytics API:
10 November 2015
Update ini berisi perubahan berikut:
29 Oktober 2015
Update ini berisi perubahan berikut:
8 Oktober 2015
Update ini berisi perubahan berikut:
24 September 2015
Update ini berisi perubahan berikut:
20 Agustus 2015
Update ini berisi perubahan berikut:
22 Juli 2015
Update ini berisi beberapa perubahan, yang semuanya hanya berlaku untuk pemilik konten:
1 Juni 2015
Update ini berisi perubahan berikut:
31 Maret 2015
Update ini berisi perubahan berikut:
16 Maret 2015
Update ini berisi perubahan berikut:
25 Februari 2015
Update ini berisi perubahan berikut:
13 Februari 2015
Update ini berisi perubahan berikut:
28 Agustus 2014
Update ini berisi perubahan berikut:
16 Juli 2014
Update ini berisi perubahan berikut:
31 Januari 2014
Update ini berisi perubahan berikut:
16 Januari 2014
Update ini berisi perubahan berikut:
6 Januari 2014
Update ini berisi perubahan berikut:
30 September 2013
Update ini berisi perubahan berikut:
16 Juli 2013
Update ini berisi perubahan berikut:
23 Mei 2013
Update ini berisi perubahan berikut:
10 Mei 2013
Update ini berisi perubahan berikut:
6 Mei 2013
Update ini berisi perubahan berikut:
3 Mei 2013
Update ini berisi perubahan berikut:
28 Maret 2013
Update ini berisi perubahan berikut:
21 Maret 2013
Update ini berisi perubahan berikut:
4 Februari 2013
Update ini berisi perubahan berikut:
14 November 2012
Update ini berisi perubahan berikut:
2 Oktober 2012
Update ini berisi perubahan berikut:
12 September 2012
Update ini berisi perubahan berikut: