Histori Revisi

Halaman ini mencantumkan perubahan API dan pembaruan dokumentasi untuk YouTube Reporting API dan YouTube Analytics API. Kedua API ini memungkinkan developer mengakses data YouTube Analytics, meskipun dengan cara yang berbeda. Berlangganan log perubahan ini. Langganan

24 Juni 2025

Seperti yang diumumkan pada 26 Maret 2025, Bulk Reports API akan diperbarui sebagai bagian dari perubahan jumlah penayangan video Shorts yang baru. Perubahan berikut telah dilakukan:

  • Versi laporan baru telah dibuat untuk setiap laporan yang menyertakan tampilan, yang merupakan sebagian besar laporan. Versi setiap laporan yang terpengaruh telah bertambah satu, seperti versi a2 menjadi versi a3.
  • Untuk Shorts, penayangan kini menghitung berapa kali video Shorts mulai diputar atau diputar ulang. Untuk Video, tidak ada perubahan.
  • Laporan yang diperbarui akan menyertakan kolom baru, engaged_views, yang akan mencerminkan metodologi penghitungan penayangan sebelumnya.

Perubahan ini berlaku mulai 30 Juni 2025, untuk Bulk Reports API. Pastikan untuk menyesuaikan pemrosesan laporan Anda.

Versi laporan sebelumnya akan tersedia hingga 30 September 2025. Setelah 30 September 2025, versi sebelumnya tidak akan digunakan lagi. Pastikan untuk bermigrasi ke versi terbaru.

Terakhir, pastikan untuk mengikuti praktik terbaik saat memproses laporan untuk menghindari perubahan pada laporan di masa mendatang yang merusak pipeline pemrosesan Anda.

Tabel berikut menunjukkan versi laporan baru untuk setiap jenis laporan:

Laporan Data Massal untuk YouTube Analytics

Laporan Channel - Laporan Video
Nama laporan Versi sebelumnya Versi terbaru
Aktivitas pengguna channel_basic_a2 channel_basic_a3
Aktivitas pengguna menurut provinsi channel_province_a2 channel_province_a3
Lokasi pemutaran channel_playback_location_a2 channel_playback_location_a3
Sumber traffic channel_traffic_source_a2 channel_traffic_source_a3
Jenis perangkat dan sistem operasi channel_device_os_a2 channel_device_os_a3
Subtitel channel_subtitles_a2 channel_subtitles_a3
Gabungan channel_combined_a2 channel_combined_a3
Laporan Channel - Laporan Playlist
Nama laporan Versi sebelumnya Versi terbaru
Aktivitas pengguna playlist_basic_a1 playlist_basic_a2
Aktivitas pengguna menurut provinsi playlist_province_a1 playlist_province_a2
Lokasi pemutaran playlist_playback_location_a1 playlist_playback_location_a2
Sumber traffic playlist_traffic_source_a1 playlist_traffic_source_a2
Jenis perangkat dan sistem operasi playlist_device_os_a1 playlist_device_os_a2
Gabungan playlist_combined_a1 playlist_combined_a2
Laporan Pemilik Konten - Laporan Video
Nama laporan Versi sebelumnya Versi terbaru
Aktivitas pengguna content_owner_basic_a3 content_owner_basic_a4
Aktivitas pengguna menurut provinsi content_owner_province_a2 content_owner_province_a3
Lokasi pemutaran content_owner_playback_location_a2 content_owner_playback_location_a3
Sumber traffic content_owner_traffic_source_a2 content_owner_traffic_source_a3
Jenis perangkat dan sistem operasi content_owner_device_os_a2 content_owner_device_os_a3
Subtitel content_owner_subtitles_a2 content_owner_subtitles_a3
Gabungan content_owner_combined_a2 content_owner_combined_a3
Laporan Pemilik Konten - Laporan Playlist
Nama laporan Versi sebelumnya Versi terbaru
Aktivitas pengguna content_owner_playlist_basic_a1 content_owner_playlist_basic_a2
Aktivitas pengguna menurut provinsi content_owner_playlist_province_a1 content_owner_playlist_province_a2
Lokasi pemutaran content_owner_playlist_playback_location_a1 content_owner_playlist_playback_location_a2
Sumber traffic content_owner_playlist_traffic_source_a1 content_owner_playlist_traffic_source_a2
Jenis perangkat dan sistem operasi content_owner_playlist_device_os_a1 content_owner_playlist_device_os_a2
Gabungan content_owner_playlist_combined_a1 content_owner_playlist_combined_a2
Laporan Pemilik Konten - Laporan Aset
Nama laporan Versi sebelumnya Versi terbaru
Aktivitas pengguna content_owner_asset_basic_a2 content_owner_asset_basic_a3
Aktivitas pengguna menurut provinsi content_owner_asset_province_a2 content_owner_asset_province_a3
Lokasi pemutaran video content_owner_asset_playback_location_a2 content_owner_asset_playback_location_a3
Sumber traffic content_owner_asset_traffic_source_a2 content_owner_asset_traffic_source_a3
Jenis perangkat dan sistem operasi content_owner_asset_device_os_a2 content_owner_asset_device_os_a3
Gabungan content_owner_asset_combined_a2 content_owner_asset_combined_a3

Laporan yang Dikelola Sistem - Keuangan (Non-Musik)

Laporan Pemilik Konten - Laporan Shorts (Non-Musik)
Nama laporan Versi sebelumnya Versi terbaru
Ringkasan pendapatan iklan global content_owner_shorts_global_ad_revenue_summary_a1 content_owner_shorts_global_ad_revenue_summary_a2
Ringkasan pendapatan iklan harian content_owner_shorts_day_ad_revenue_summary_a1 content_owner_shorts_day_ad_revenue_summary_a2
Ringkasan pendapatan iklan per negara content_owner_shorts_country_ad_revenue_summary_a1 content_owner_shorts_country_ad_revenue_summary_a2
Ringkasan pendapatan iklan content_owner_shorts_ad_revenue_summary_a1 content_owner_shorts_ad_revenue_summary_a2

Laporan yang Dikelola Sistem - Non-keuangan

Laporan Pemilik Konten - Laporan Klaim
Nama laporan Versi sebelumnya Versi terbaru
Klaim aktif content_owner_active_claims_a2 content_owner_active_claims_a3
Laporan Pemilik Konten - Laporan Metadata Video
Nama laporan Versi sebelumnya Versi terbaru
Metadata video content_owner_video_metadata_a3 content_owner_video_metadata_a4
Laporan Pemilik Konten - Laporan Aset
Nama laporan Versi sebelumnya Versi terbaru
Aset content_owner_asset_a2 content_owner_asset_a3
Konflik Aset content_owner_asset_conflict_a2 content_owner_asset_conflict_a3

24 April 2025

Seperti yang diumumkan pada 26 Maret 2025, Targeted Queries API akan diperbarui sebagai bagian dari perubahan penghitungan penayangan Shorts yang baru:

  • Untuk Shorts, views kini akan menghitung berapa kali video Shorts mulai diputar atau diputar ulang.
  • Metrik baru, engagedViews, akan mencerminkan metodologi penghitungan penayangan sebelumnya. engagedViews akan tersedia di semua laporan bersama dengan views.

Perubahan ini akan berlaku mulai 30 April 2025 untuk Targeted Queries API. Pastikan untuk menyesuaikan kueri Anda dengan tepat.

Periksa histori revisi ini untuk mempelajari perubahan apa dan kapan yang akan dilakukan pada Bulk Reports API.

22 April 2025

Seperti yang diumumkan pada 7 April 2024, dimensi isCurated telah dihentikan untuk laporan channel dan laporan playlist pemilik konten. Mulai 31 Desember 2024, dimensi ini tidak lagi didukung. Dimensi telah dihapus dari laporan dan dari dokumentasi.

26 Maret 2025

Update ini berisi perubahan berikut terkait YouTube Analytics API dan YouTube Reporting API:

Mulai 31 Maret 2025, YouTube akan mengubah cara penghitungan penayangan untuk Shorts. Sebelumnya, untuk Shorts, penayangan dihitung setelah video Shorts diputar selama beberapa detik. Sekarang, penayangan akan menghitung berapa kali video Shorts Anda mulai diputar atau diputar ulang, tanpa persyaratan waktu tonton minimum. Pelajari lebih lanjut

YouTube Analytics API (Kueri Bertarget) dan Reporting API (Laporan Massal) akan diperbarui dengan perubahan berikut:

  • Untuk Shorts, views menghitung berapa kali video Shorts mulai diputar atau diputar ulang.
  • Metrik baru, engagedViews, akan tersedia dan akan mencerminkan metode penghitungan penayangan sebelumnya.
  • Jika Anda memiliki channel atau Anda diberi otorisasi untuk mengakses data channel, Anda akan dapat membuat kueri tampilan yang diperbarui dan tampilan yang berinteraksi.

Kueri Bertarget akan diperbarui paling lambat 30 April, dan Laporan Massal akan diperbarui paling lambat 30 Juni. Sementara itu, penayangan akan didasarkan pada metodologi lama. Penayangan video Shorts dan channel tidak akan sama dengan Analytics di Studio.

Selain itu, penghentian yang sebelumnya diumumkan untuk laporan Klaim Harian (Versi 1.0) telah ditunda.

Periksa histori revisi ini untuk mengetahui kapan perubahan dilakukan pada API.

3 Maret 2025

Update ini berisi perubahan berikut terkait YouTube Reporting API:

Catatan: Ini adalah pengumuman penghentian penggunaan.

Laporan Klaim Harian (Versi 1.0) tidak digunakan lagi untuk partner. Aplikasi ini tidak akan lagi didukung pada atau setelah 30 April 2025. Definisi laporan tersebut telah diperbarui sebagaimana mestinya. Sebagai gantinya, gunakan laporan Klaim Harian terbaru.

15 November 2024

Catatan: Perubahan berikut berlaku mulai 18 November 2024.

Dokumentasi YouTube Analytics (Targeted Queries) API telah diperbarui untuk mencatat bahwa untuk laporan Sumber Traffic, metode reports.query API kini menampilkan error jika hasil perkalian # video yang dikueri X # hari dalam rentang tanggal melebihi 50.000. Misalnya, kueri yang mengambil data untuk 500 ID video dapat meminta data untuk maksimum 100 hari.

Perubahan ini memengaruhi laporan untuk channel dan pemilik konten.

Untuk mengurangi jumlah baris yang ditampilkan permintaan, pisahkan kueri Anda menjadi beberapa kueri yang menentukan lebih sedikit video atau menetapkan rentang tanggal yang lebih pendek. Sebagai aturan, laporan massal direkomendasikan untuk set data besar.

6 Mei 2024

YouTube Analytics API (Kueri Bertarget) mendukung tiga laporan baru untuk channel:

Selain itu, laporan Retensi Audiens telah ditingkatkan untuk mendukung tiga metrik baru:

7 April 2024

YouTube Analytics API (Kueri Bertarget) memiliki beberapa update 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 hampir informasi yang sama dengan entri dari 19 Januari 2024. Namun, perhatikan bahwa laporan playlist pemilik konten akan mendukung dimensi isCurated hingga 31 Desember 2024, sedangkan dimensi ini akan didukung untuk laporan playlist channel hingga 30 Juni 2024.

  • Catatan: Ini adalah pengumuman penghentian penggunaan.

    Dimensi isCurated tidak digunakan lagi untuk laporan playlist pemilik konten. Aplikasi ini tidak akan didukung lagi pada atau setelah 31 Desember 2024. Definisi dimensi tersebut telah diperbarui sebagaimana mestinya.

    Untuk mempertahankan kompatibilitas mundur saat Anda menghapus dimensi isCurated, Anda juga harus mengupdate kode untuk mengambil metrik playlistViews, bukan metrik views hanya untuk laporan playlist. Karena metrik views 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 menampilkan views dan playlistViews.

    Selain dimensi isCurated, fungsi API berikut tidak lagi didukung dalam laporan baru:

    • Filter lokasi, seperti continent dan subcontinent tidak didukung untuk laporan playlist channel baru.
    • Metrik redViews dan estimatedRedMinutesWatched 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 dan youtubeProduct 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.

  • 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 pengguna dan tayangan 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 engagement pengguna dalam konteks halaman playlist. Metrik ini mencakup data untuk juga akan mencakup penayangan dari video yang tidak dimiliki dalam playlist, tetapi hanya jika 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 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 metrik untuk definisi setiap metrik:

  • Perilaku metrik views kini bergantung pada apakah permintaan API yang mengambil laporan playlist menggunakan dimensi isCurated:

    • Jika permintaan menyertakan dimensi isCurated, metrik views adalah metrik dalam playlist yang menunjukkan jumlah penayangan video dalam konteks playlist pemilik konten.
    • Jika permintaan tidak menyertakan dimensi isCurated, metrik views adalah metrik video gabungan yang menentukan total jumlah video dalam playlist pemilik konten ditonton, terlepas dari apakah penayangan tersebut terjadi dalam konteks playlist. Total gabungan hanya mencakup penayangan video yang dimiliki oleh pemilik konten yang terkait dengan channel yang memiliki playlist.

      Dalam laporan ini, yang tidak menggunakan dimensi isCurated, metrik playlistViews menunjukkan jumlah video yang ditonton dalam konteks playlist. Metrik tersebut menghitung penayangan untuk semua video dalam playlist, terlepas dari channel mana yang memilikinya.

  • 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. Lihat bagian yang menentukan laporan playlist berbasis waktu untuk melihat contohnya.

19 Januari 2024

YouTube Analytics API (Kueri Bertarget) memiliki beberapa update terkait laporan playlist channel. Pembaruan ini mencakup dimensi yang tidak digunakan lagi serta beberapa metrik baru dan yang diperbarui:

  • Catatan: Ini adalah pengumuman penghentian penggunaan.

    Dimensi isCurated tidak digunakan lagi untuk laporan channel. Aplikasi ini tidak akan didukung lagi pada atau setelah 30 Juni 2024. Definisi dimensi tersebut telah diperbarui sebagaimana mestinya.

    Untuk mempertahankan kompatibilitas mundur saat Anda menghapus dimensi isCurated, Anda juga harus mengupdate kode untuk mengambil metrik playlistViews, bukan metrik views hanya untuk laporan playlist. Karena metrik views 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 menampilkan views dan playlistViews.

    Selain dimensi isCurated, fungsi API berikut tidak lagi didukung dalam laporan baru:

    • Filter lokasi, seperti continent dan subcontinent tidak didukung untuk laporan playlist channel baru.
    • Metrik redViews dan estimatedRedMinutesWatched 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 dan youtubeProduct 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.

  • Bagian laporan playlist dalam dokumentasi laporan saluran telah diperbarui untuk menjelaskan secara lebih menyeluruh jenis metrik yang didukung untuk laporan playlist:

    • Metrik video gabungan memberikan metrik aktivitas pengguna dan tayangan 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 engagement pengguna dalam konteks halaman playlist. Metrik ini mencakup data untuk juga akan mencakup penayangan dari video yang tidak dimiliki dalam playlist, tetapi hanya jika 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 dalam playlist 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 metrik untuk definisi setiap metrik:

  • Perilaku metrik views kini bergantung pada apakah permintaan API yang mengambil laporan playlist menggunakan dimensi isCurated:

    • Jika permintaan menyertakan dimensi isCurated, metrik views adalah metrik dalam playlist yang menunjukkan jumlah penayangan video dalam konteks playlist channel.
    • Jika permintaan tidak menyertakan dimensi isCurated, metrik views adalah metrik video gabungan yang menentukan jumlah total frekuensi video tersebut ditonton dalam playlist channel, terlepas dari apakah penayangan tersebut terjadi dalam konteks playlist. Total gabungan hanya mencakup penayangan video yang dimiliki oleh channel yang memiliki playlist.

      Dalam laporan ini, yang tidak menggunakan dimensi isCurated, metrik playlistViews menunjukkan jumlah video yang ditonton dalam konteks playlist. Metrik tersebut menghitung penayangan untuk semua video dalam playlist, terlepas dari channel mana yang memilikinya.

  • Untuk setiap laporan playlist, dokumentasi laporan channel kini menyertakan tabel yang menampilkan metrik yang didukung untuk laporan tersebut, bergantung pada apakah permintaan API menyertakan dimensi isCurated. Lihat bagian yang menentukan laporan playlist berbasis waktu untuk melihat contohnya.

4 Desember 2023

YouTube Analytics API (Kueri Bertarget) telah diupdate untuk menggabungkan dua insightTrafficSourceType nilai dimensi. Sebelumnya, dimensi ini 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). Selanjutnya, kedua jenis penayangan akan dikaitkan dengan nilai dimensi PLAYLIST.

15 Desember 2022

YouTube Analytics API (Kueri Bertarget) mendukung dua dimensi baru dan satu laporan baru:

  • Laporan baru memberikan aktivitas pengguna menurut kota. Laporan ini tersedia untuk channel dan pemilik konten. Laporan ini berisi dimensi city baru, yang mengidentifikasi perkiraan YouTube tentang kota tempat aktivitas pengguna terjadi.

  • Dimensi creatorContentType baru mengidentifikasi jenis konten YouTube yang terkait dengan metrik aktivitas pengguna dalam baris data. Nilai yang didukung adalah LIVE_STREAM, SHORTS, STORY, dan VIDEO_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 dan 30DayTotals telah dihapus dari dokumentasi. Penghentian penggunaan dimensi ini diumumkan pada Oktober 2019.

26 Agustus 2022

YouTube Analytics API (Kueri Bertarget) dan YouTube Reporting API (Laporan Massal) sama-sama mendukung nilai detail sumber traffic baru:

  • Di YouTube Analytics API (Kueri Bertarget), jika nilai dimensi insightTrafficSourceType adalah SUBSCRIBER, maka nilai insightTrafficSourceDetail dapat ditetapkan ke podcasts, yang menunjukkan bahwa traffic dirujuk dari halaman tujuan Podcast.
  • Di YouTube Reporting API (Laporan Massal), jika nilai dimensi traffic_source_type adalah 3, maka nilai traffic_source_detail dapat ditetapkan ke podcasts, 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. Hal ini mungkin merupakan perubahan yang tidak kompatibel dengan versi sebelumnya dalam penerapan API Anda. Sesuai dengan bagian Perubahan yang Tidak Kompatibel untuk Versi Lama dalam Persyaratan Layanan YouTube API, perubahan ini diumumkan enam bulan sebelum diberlakukan. 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 API (Kueri Bertarget), dimensi gender saat ini mendukung dua nilai: female dan male. Pada atau setelah 11 Agustus 2022, dimensi tersebut akan mendukung tiga nilai: female, male, dan user_specified.
  • Di YouTube Reporting API (Laporan Massal), dimensi gender saat ini mendukung tiga nilai: FEMALE, MALE, dan GENDER_OTHER. Pada atau setelah 11 Agustus 2022, kumpulan nilai yang didukung akan berubah menjadi FEMALE, MALE, dan USER_SPECIFIED.

9 Februari 2022

Dua metrik telah diperbarui untuk mengecualikan traffic klip berulang mulai 13 Desember 2021. Perubahan ini memengaruhi YouTube Analytics API (Kueri Bertarget) dan YouTube Reporting API (Laporan Massal).

2 Februari 2022

YouTube Reporting (Bulk Reports) API ini mendukung nilai dimensi sumber traffic baru yang menunjukkan bahwa penayangan berasal dari Pengalihan Langsung:

Untuk jenis sumber traffic ini, dimensi traffic_source_detail menentukan ID saluran dari mana penonton dirujuk.

23 September 2020

YouTube Analytics API (Kueri Bertarget) dan YouTube Reporting API (Laporan Massal) ini mendukung nilai dimensi sumber traffic baru yang menunjukkan bahwa penonton dirujuk dengan menggeser secara vertikal dalam pengalaman menonton YouTube Shorts:

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 YouTube Analytics API (Kueri Bertarget):

  • Ukuran maksimum grup pelaporan YouTube Analytics telah ditingkatkan dari 200 menjadi 500 entitas.
  • Parameter filters metode reports.query mengidentifikasi daftar filter yang harus diterapkan saat mengambil data YouTube Analytics. Parameter ini mendukung kemampuan untuk menentukan beberapa nilai untuk filter video, playlist, dan channel, dan jumlah maksimum ID yang dapat ditentukan untuk filter tersebut telah meningkat dari 200 menjadi 500 ID.

13 Februari 2020

Update ini berisi perubahan berikut terkait YouTube Analytics API (Kueri Bertarget) dan YouTube Reporting API (Laporan Massal). Anda dapat mempelajari lebih lanjut perubahan ini di Pusat Bantuan YouTube.

Di kedua API, kumpulan nilai detail sumber traffic yang mungkin 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, menjadi dua kategori:

  • uploaded_push - Penayangan berasal dari notifikasi push yang dikirim ke subscriber saat video diupload
  • uploaded_other - Penayangan berasal dari notifikasi non-push, seperti notifikasi email atau Kotak Masuk, yang dikirim kepada subscriber saat video diupload.

Nilai ini ditampilkan untuk rentang waktu yang dimulai pada 13-01-2020 (13 Januari 2020).

Selain itu, sebagai pengingat, nilai ini tidak merepresentasikan 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

Update ini berisi perubahan berikut terkait YouTube Analytics API (Kueri Bertarget):

  • Catatan: Ini adalah pengumuman penghentian penggunaan.

    YouTube menghapus dukungan untuk dimensi 7DayTotals dan 30DayTotals. Anda tetap dapat mengambil data menggunakan dimensi tersebut hingga 15 April 2020. Pada atau setelah tanggal tersebut, upaya untuk mengambil laporan menggunakan dimensi 7DayTotals atau 30DayTotals akan menampilkan error.

    Perhatikan bahwa pengguna dapat mereproduksi beberapa data untuk dimensi ini dengan membuat kueri menggunakan dimensi day dan menggabungkan atau memperoleh data selama periode tujuh atau 30 hari. Contoh:

    • Jumlah penayangan untuk jangka waktu tujuh hari dapat dihitung dengan menggabungkan jumlah penayangan dari setiap hari dalam jangka waktu tersebut.
    • viewerPercentage untuk jangka waktu tujuh hari dapat dihitung dengan mengalikan jumlah penayangan yang terjadi setiap hari dengan viewerPercentage 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 untuk periode tersebut guna mendapatkan viewerPercentage untuk seluruh periode.
    • Jumlah penonton unik untuk periode tujuh hari tidak dapat dihitung karena penonton yang sama dapat dihitung sebagai penonton unik pada hari yang berbeda. Namun, Anda mungkin dapat menggunakan dimensi month, bukan dimensi 30DayTotals, untuk mengekstrapolasi data tentang jumlah penonton unik selama periode 30 hari. Perhatikan bahwa dimensi month mengacu pada bulan kalender, sedangkan dimensi 30DayTotals menghitung periode 30 hari berdasarkan tanggal mulai dan akhir yang ditentukan.

27 Juni 2019

Update ini berisi perubahan berikut terkait YouTube Analytics API (Kueri Bertarget):

  • Karena API versi 1 kini sepenuhnya tidak digunakan lagi, dokumentasi telah diupdate untuk menghapus referensi ke versi tersebut, termasuk pemberitahuan penghentian penggunaan dan panduan migrasi yang menjelaskan cara mengupdate ke versi 2.

1 November 2018

Update ini berisi perubahan berikut terkait YouTube Analytics API (Kueri Bertarget):

  • API Versi 1 kini tidak digunakan lagi. Jika Anda belum melakukannya, perbarui klien API Anda untuk menggunakan API versi 2 sesegera mungkin guna meminimalkan gangguan layanan. Lihat panduan migrasi untuk mengetahui detail selengkapnya.

    Perhatikan bahwa jadwal penghentian ini awalnya diumumkan pada 26 April 2018.

17 September 2018

Update ini berisi perubahan berikut terkait YouTube Analytics API (Kueri Bertarget):

  • Bagian anonimisasi data baru dalam dokumen ringkasan Model Data menjelaskan bahwa beberapa data YouTube Analytics bersifat terbatas jika 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:

    1. video atau channel memiliki traffic terbatas selama jangka waktu tertentu,

      atau

    2. Anda telah memilih filter atau dimensi, seperti sumber traffic atau negara, yang nilainya tidak memenuhi batas tertentu.

    Bagian baru ini juga mencakup pembahasan 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 dan estimatedRedMinutesWatched tidak lagi didukung untuk laporan lokasi pemutaran, sumber traffic, dan jenis perangkat/sistem operasi.

18 Juni 2018

Update ini berisi perubahan berikut pada YouTube Analytics API (Kueri Bertarget):

  • Persyaratan cakupan untuk metode berikut telah berubah:
    • Permintaan ke metode reports.query harus memiliki akses ke cakupan https://www.googleapis.com/auth/youtube.readonly.
    • Permintaan ke metode groupItems.list harus memiliki akses ke salah satu:
      • cakupan https://www.googleapis.com/auth/youtube
        atau
      • cakupan https://www.googleapis.com/auth/youtube.readonly
        dan
        cakupan https://www.googleapis.com/auth/yt-analytics.readonly

      Opsi pertama menggunakan satu cakupan, yang kebetulan merupakan cakupan baca-tulis, sedangkan opsi kedua menggunakan dua cakupan hanya baca.

23 Mei 2018

Update ini berisi perubahan berikut pada YouTube Analytics API (Kueri Bertarget):

  • Ringkasan API berisi bagian baru, metrik gabungan dan item yang dihapus, yang menjelaskan cara respons API menangani data yang terkait dengan resource yang dihapus, seperti video, playlist, atau channel.
  • Bagian praktik terbaik di Ringkasan API telah diperbarui untuk mengingatkan Anda bahwa Anda dapat menggunakan YouTube Data API untuk mengambil metadata tambahan untuk resource yang diidentifikasi dalam respons YouTube Analytics API. Seperti yang tercantum dalam Kebijakan Developer untuk Layanan YouTube API (bagian III.E.4.b hingga III.E.4.d), klien API harus menghapus atau memuat ulang metadata resource yang disimpan dari API tersebut setelah 30 hari.

22 Mei 2018

Update ini berisi perubahan berikut terkait YouTube Reporting API (Laporan Massal):

  • Perubahan berikut saat ini dijadwalkan akan berlaku pada Juli 2018, dan kebijakan baru ini berlaku secara global untuk semua laporan dan tugas 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 memperjelas, saat perubahan kebijakan ini berlaku, laporan data historis yang berusia lebih dari 30 hari juga tidak akan dapat diakses lagi melalui API. Semua laporan lainnya yang sudah lebih dari 60 hari juga tidak akan dapat diakses lagi. Oleh karena itu, dokumentasi kini menyatakan bahwa laporan yang dibuat sebelum perubahan kebijakan akan tersedia hingga 180 hari.

    • Setelah perubahan, saat Anda menjadwalkan tugas pelaporan, YouTube akan membuat laporan mulai dari hari tersebut dan mencakup periode 30 hari sebelum waktu tugas dijadwalkan. Sebelum perubahan ini, saat Anda menjadwalkan tugas pelaporan, YouTube akan membuat laporan yang mencakup periode 180 hari sebelum waktu tugas dijadwalkan.

  • Bagian praktik terbaik telah diperbarui untuk mengingatkan Anda bahwa Anda dapat menggunakan YouTube Data API untuk mengambil metadata tambahan untuk aset yang diidentifikasi dalam laporan. Seperti yang tercantum dalam Kebijakan Developer untuk Layanan YouTube API (bagian III.E.4.b hingga III.E.4.d), klien API harus menghapus atau memuat ulang metadata resource yang disimpan dari API tersebut setelah 30 hari.

  • Bagian Karakteristik laporan telah diperbarui untuk mencatat bahwa meskipun data laporan tidak difilter, laporan yang berisi data untuk jangka waktu pada atau setelah 1 Juni 2018, tidak akan berisi referensi ke aset YouTube yang dihapus setidaknya 30 hari sebelum tanggal laporan dibuat.

  • Bagian data historis dalam ringkasan API telah diperbarui untuk mencatat bahwa saat Anda menjadwalkan tugas pelaporan baru, laporan historis biasanya diposting dalam beberapa hari. Sebelumnya, dokumentasi menyatakan bahwa laporan tersebut dapat tersedia hingga 30 hari.

  • Bagian data pengisian ulang dalam ringkasan API telah diperbarui untuk lebih jelas mendefinisikan data pengisian ulang sebagai set data yang menggantikan set yang sebelumnya dikirimkan.

26 April 2018

YouTube Analytics (Kueri Bertarget) API 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 perlu memperbarui kode untuk mencerminkan perubahan yang tercantum di bawah. Semua perubahan ini dijelaskan secara mendetail dalam panduan migrasi baru.

    • Versi API telah berubah dari v1 menjadi v2.
    • URL dasar untuk permintaan API telah berubah dari https://www.googleapis.com/youtube/analytics/v1 menjadi https://youtubeanalytics.googleapis.com/v2.
    • Beberapa parameter untuk metode reports.query telah diperbarui namanya. Secara khusus, nama parameter yang berisi tanda hubung, seperti end-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 Anda mengirim permintaan batch di API v2, Anda harus menggunakan endpoint https://youtubeanalytics.googleapis.com/v2.

    Selain itu, beberapa fitur v1 tidak didukung di API v2:

    • Metode reports.query tidak lagi mendukung parameter permintaan alt, quotaUser, dan userIp.
    • API v2 tidak menyediakan endpoint batch yang mendukung batch yang terdiri dari permintaan ke API yang berbeda. (Batch dapat terdiri dari permintaan ke metode yang berbeda dari API yang sama.) Penghentian ini tidak khusus untuk YouTube Analytics API karena Google 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.

  • Catatan: Ini adalah pengumuman penghentian penggunaan.

    API versi 1 (v1) kini tidak digunakan lagi dan akan didukung hingga 31 Oktober 2018. Semua permintaan ke v1 API akan berhenti berfungsi setelah tanggal tersebut. Oleh karena itu, pastikan untuk mengupgrade ke API v2 paling lambat 31 Oktober 2018, untuk menghindari gangguan pada kemampuan Anda mengakses data YouTube Analytics melalui API.

21 Februari 2018

Update ini berisi perubahan berikut pada YouTube Analytics API (Kueri Bertarget):

  • 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 terjadinya penayangan, kini mendukung nilai berikut:
      • 25: KaiOS

  • YouTube Analytics API (Kueri Bertarget)

20 Desember 2017

Update ini berisi 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. Selain itu, meskipun aplikasi Anda akan memerlukan waktu CPU tambahan untuk mengekstrak respons API, manfaat penggunaan lebih sedikit resource jaringan biasanya lebih besar daripada biaya tersebut.

    Untuk menerima respons yang dienkode gzip, setel header permintaan HTTP Accept-Encoding ke gzip seperti yang ditunjukkan dalam contoh berikut:

    Accept-Encoding: gzip

    Fungsi ini dijelaskan dalam ringkasan API dan dalam definisi properti downloadUrl resource report.

  • Dokumentasi dimensi age group dan gender telah diperbaiki untuk 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 kata age_group dan angka dalam kelompok usia, serta menggunakan garis bawah, bukan tanda hubung.AGE Oleh karena itu, nilai seperti age13-17 dan age18-24 telah dikoreksi menjadi AGE_13_17 dan AGE_18_24.
    • Nilai untuk dimensi gender menggunakan huruf besar. Dengan demikian, nilai female, male, dan gender_other telah dikoreksi menjadi FEMALE, MALE, dan GENDER_OTHER.

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 menyediakan data yang sama.)

Karena metrik earnings adalah metrik inti, metrik ini didukung selama satu tahun sejak tanggal pengumuman. Namun, setelah periode satu tahun 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, segera lakukan update.

Dokumentasi API telah diperbarui untuk menghapus referensi yang tersisa ke metrik earnings.

6 Juli 2017

Update ini berisi perubahan berikut:

  • YouTube Analytics API (Kueri Bertarget)

    • Dokumentasi API telah diperbarui untuk mencerminkan fakta bahwa respons API berisi data hingga hari terakhir dalam rentang tanggal yang diminta dan semua metrik yang dikueri tersedia.

      Misalnya, jika permintaan menentukan tanggal akhir 5 Juli 2017, dan nilai untuk semua metrik yang diminta hanya tersedia hingga 3 Juli 2017, maka tanggal tersebut akan menjadi tanggal terakhir yang datanya disertakan dalam respons. (Hal ini berlaku meskipun data untuk beberapa metrik yang diminta tersedia untuk 4 Juli 2017.)

    • Dimensi adType kini mendukung nilai reservedBumperInstream, yang merujuk pada iklan video yang tidak dapat dilewati, berdurasi maksimal 6 detik, dan diputar sebelum video dapat ditonton. Format iklan ini identik dengan iklan auctionBumperInstream, tetapi jenis ini merujuk pada iklan yang dijual berdasarkan pemesanan, bukan lelang.

  • YouTube Reporting API (Laporan Massal)

    • Dimensi ad_type kini mendukung nilai 20, yang merujuk pada iklan bumper yang dijual berdasarkan reservasi. Iklan bumper adalah iklan video yang tidak dapat dilewati, berdurasi maksimal 6 detik, dan diputar sebelum video dapat ditonton. Perhatikan bahwa nilai 19 untuk dimensi ini juga merujuk pada iklan bumper yang dijual berdasarkan lelang, bukan berdasarkan pemesanan.

    • 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. Oleh karena itu, beberapa laporan dapat diakses hingga 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. Oleh karena itu, beberapa laporan dapat diakses hingga 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 membagikan video, kini mendukung nilai berikut:
      • 85: YouTube Music
      • 86: YouTube Gaming
      • 87: YouTube Kids
      • 88: YouTube TV

      Selain itu, nama yang digunakan untuk mengidentifikasi nilai 52 telah diperbarui dalam dokumentasi menjadi Kakao (Kakao Talk) agar lebih jelas perbedaannya dengan nilai 73 (Kakao Story). Perubahan ini tidak mencerminkan perubahan apa pun pada perilaku API atau klasifikasi video yang dibagikan ke layanan ini.

  • YouTube Analytics API (Kueri Bertarget)

    • Dimensi sharingService kini mendukung nilai berikut:
      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

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:

17 Maret 2017

Update ini berisi perubahan berikut:

  • YouTube Analytics API mendukung metrik redViews dan estimatedRedMinutesWatched, yang keduanya terkait dengan penayangan YouTube Red. Sebenarnya, API ini telah mendukung metrik tersebut selama beberapa waktu, dan YouTube Reporting API telah 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 dihabiskan pelanggan YouTube Red untuk menonton video.

    Dokumentasi laporan channel dan laporan pemilik konten telah diperbarui untuk menunjukkan laporan mana yang mendukung dua metrik baru. Metrik ini didukung dalam laporan apa pun yang sudah mendukung metrik views dan estimatedMinutesWatched.

3 Maret 2017

Update ini berisi perubahan berikut:

  • YouTube Reporting API (Laporan Massal)

    • Definisi dimensi date telah diperbaiki untuk mencatat bahwa nilai dimensi mengacu pada periode yang dimulai pukul 00.00 waktu Pasifik dan berakhir pukul 23.59 waktu Pasifik pada hari, bulan, dan tahun yang ditentukan. Bergantung pada waktu dalam setahun, waktu Pasifik adalah UTC-7 atau UTC-8.

      Meskipun tanggal biasanya mewakili periode 24 jam, tanggal saat jam dimajukan mewakili periode 23 jam, dan tanggal saat jam dimundurkan mewakili periode 25 jam. (Sebelumnya, dokumentasi menyatakan bahwa setiap tanggal mewakili periode 24 jam yang unik dan bahwa waktu Pasifik selalu UTC-8.)

      Perhatikan bahwa koreksi ini tidak merepresentasikan perubahan pada perilaku API yang sebenarnya.

    • Dimensi operating_system, yang mengidentifikasi sistem software perangkat tempat penayangan terjadi, kini mendukung nilai berikut:
      • 22: Tizen
      • 23: Firefox
      • 24: RealMedia

    • Semua tugas pelaporan untuk jenis laporan content_owner_basic_a1 telah dihapus. Jenis laporan tersebut telah sepenuhnya dihentikan sejak 19 Agustus 2016, tetapi laporan content_owner_basic_a1 yang dibuat sebelumnya masih tersedia selama 180 hari sejak dibuat. Oleh karena itu, beberapa laporan dapat diakses hingga 19 Februari 2017. Namun, karena laporan tidak lagi tersedia, tugas yang terkait dengan laporan juga tidak diperlukan.

  • YouTube Analytics API (Kueri Bertarget)

    • Deskripsi dimensi yang terkait dengan time periods telah dikoreksi untuk mencatat bahwa nilai dimensi merujuk pada periode yang dimulai pukul 00.00 Waktu Pasifik dan berakhir pukul 23.59 Waktu Pasifik pada hari, bulan, dan tahun yang ditentukan. Bergantung pada waktu dalam setahun, waktu Pasifik adalah UTC-7 atau UTC-8.

      Meskipun tanggal biasanya mewakili periode 24 jam, tanggal saat jam dimajukan mewakili periode 23 jam, dan tanggal saat jam dimundurkan 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 bahwa koreksi ini tidak merepresentasikan perubahan pada perilaku API yang sebenarnya.

    • Dokumentasi laporan saluran telah diperbarui untuk mencatat 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 channel.

    • Dimensi operatingSystem mendukung tiga nilai dimensi baru:
      • FIREFOX
      • REALMEDIA
      • TIZEN

8 Februari 2017

YouTube Analytics API kini mendukung parameter include-historical-channel-data opsional. Perhatikan bahwa parameter ini hanya relevan saat mengambil laporan pemilik konten.

Parameter ini memungkinkan pemilik konten menunjukkan bahwa respons API harus menyertakan data waktu tonton dan penayangan channel dari jangka waktu sebelum channel ditautkan ke pemilik konten. Nilai parameter default adalah false, yang berarti bahwa, secara default, respons API hanya menyertakan data waktu tonton dan penayangan dari saat channel ditautkan ke pemilik konten.

Aturan ini juga berlaku jika permintaan API mengambil data untuk beberapa saluran:

  • Jika nilai parameter adalah false, data waktu tonton dan penayangan yang ditampilkan untuk channel tertentu didasarkan pada tanggal 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 parameter adalah false, respons API akan berisi data waktu tonton dan penayangan berdasarkan tanggal penautan untuk setiap saluran terkait.
  • Jika nilai parameter adalah true, respons akan menampilkan data waktu tonton dan penayangan untuk semua channel berdasarkan tanggal mulai dan berakhir yang ditentukan dalam permintaan API.

15 Desember 2016

Laporan YouTube Reporting API berikut tidak lagi didukung dan telah dihapus dari dokumentasi. Versi terbaru setiap laporan tersedia. (Pengumuman penghentian penggunaan untuk laporan ini dilakukan pada 15 September 2016.)

Daftar jenis laporan saat ini dalam dokumentasi referensi API juga telah diperbarui.

11 November 2016

Update ini berisi perubahan berikut:

YouTube Reporting API mendukung tiga laporan layar akhir baru serta dimensi dan metrik baru untuk laporan tersebut. Laporan ini memberikan statistik tayangan dan rasio klik-tayang untuk layar akhir yang ditampilkan setelah video berhenti diputar.

8 November 2016

Update ini berisi perubahan berikut pada YouTube Analytics API:

  • 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 menunjukkan 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

27 Oktober 2016

YouTube kini otomatis membuat serangkaian laporan pendapatan iklan yang dikelola sistem untuk pemilik konten yang memiliki akses ke laporan terkait di bagian Laporan di Creator Studio YouTube. Laporan API yang dikelola sistem baru dirancang untuk memberikan akses terprogram ke data yang juga tersedia dalam laporan Creator Studio yang dapat didownload secara manual.

Ringkasan laporan yang dikelola sistem memberikan ringkasan singkat tentang laporan baru dan menjelaskan proses pengambilan laporan tersebut melalui API. Proses ini sedikit berbeda dengan proses untuk mengambil laporan massal untuk YouTube Analytics karena partner tidak perlu menjadwalkan tugas untuk membuat laporan.

Properti id resource reportType telah diperbarui untuk menyertakan daftar laporan yang dikelola sistem yang dapat Anda akses melalui API:

  • Pendapatan iklan bulanan di seluruh dunia per video
  • Pendapatan iklan harian per video, per negara
  • Pendapatan iklan bulanan di seluruh dunia per aset
  • Pendapatan iklan harian per aset, per negara
  • Klaim (laporan ini tidak berisi data pendapatan)

27 September 2016

Catatan: Ini adalah pengumuman penghentian penggunaan.

Metrik uniques YouTube Analytics API telah dihentikan. Metrik ini bukan metrik inti dan akan didukung hingga 31 Oktober 2016.

15 September 2016

Update ini berisi perubahan YouTube Reporting API berikut:

19 Agustus 2016

Update ini berisi perubahan YouTube Reporting API berikut:

  • Laporan content_owner_basic_a1 telah sepenuhnya tidak digunakan lagi dan dihapus dari dokumentasi. YouTube tidak akan lagi membuat laporan baru jenis tersebut, meskipun laporan yang sudah dibuat akan tetap tersedia selama 180 hari sejak dibuat.

    Pengganti laporan content_owner_basic_a1 adalah laporan content_owner_basic_a2 seperti yang dijelaskan dalam entri histori revisi untuk 19 Mei 2016.

11 Agustus 2016

Update ini berisi perubahan berikut:

  • Persyaratan Layanan untuk Layanan YouTube API yang baru dipublikasikan ("Persyaratan yang Diperbarui"), yang dibahas secara mendetail di Blog Engineering dan Developer YouTube, memberikan serangkaian pembaruan yang kaya pada Persyaratan Layanan saat ini. Selain Persyaratan yang Diperbarui, yang akan berlaku mulai 10 Februari 2017, pembaruan ini mencakup beberapa dokumen pendukung untuk membantu menjelaskan kebijakan yang harus dipatuhi developer.

    Kumpulan lengkap dokumen baru dijelaskan dalam histori revisi untuk Persyaratan yang Diperbarui. Selain itu, perubahan mendatang pada Persyaratan yang Diperbarui atau pada dokumen pendukung tersebut juga akan dijelaskan dalam histori revisi tersebut. Anda dapat berlangganan feed RSS yang mencantumkan perubahan dalam histori revisi tersebut dari link dalam dokumen tersebut.

10 Agustus 2016

Update ini mencakup perubahan berikut:

  • YouTube Analytics API (Kueri Bertarget)

    • Catatan: Ini adalah pengumuman penghentian penggunaan.

      Metrik dalam tabel berikut tidak digunakan lagi. Pada saat yang sama, metrik baru yang merujuk pada data yang sama diperkenalkan. Akibatnya, metrik lama akan diganti namanya, meskipun YouTube Analytics API akan mendukung kedua nama metrik 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 adalah metrik inti, sehingga akan didukung selama satu tahun sejak tanggal pengumuman ini. Metrik lainnya, yang bukan metrik inti, akan didukung selama tiga bulan, hingga 4 November 2016.

      Misalnya, hingga 4 November 2016, permintaan API dapat menentukan metrik impressionBasedCpm, metrik cpm, atau keduanya. Namun, setelah tanggal tersebut, hanya metrik cpm yang akan didukung.

    • Dimensi insightTrafficSourceType mendukung dua nilai dimensi baru:
      • CAMPAIGN_CARD: Sumber traffic ini hanya didukung untuk laporan pemilik konten. Hal ini menunjukkan bahwa penayangan berasal dari video yang diklaim dan diupload pengguna yang digunakan oleh pemilik konten untuk mempromosikan konten yang 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, dimensi insightTrafficSourceDetail mengidentifikasi video dari mana penonton dirujuk.

    • Dimensi adType kini mendukung nilai auctionBumperInstream, yang merujuk pada iklan video yang tidak dapat dilewati, berdurasi maksimal 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. Hal ini menunjukkan bahwa penayangan berasal dari video yang diklaim dan diupload pengguna yang digunakan oleh pemilik konten untuk mempromosikan konten yang 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 dari mana penonton dirujuk.

    • Daftar metrik inti API telah diperbaiki untuk mencantumkan estimated_partner_revenue sebagai metrik inti dan menghapus earnings dari daftar tersebut. (Metrik earnings tidak pernah didukung di YouTube Reporting API.)

    • Dimensi ad_type kini mendukung nilai 19 yang merujuk ke iklan bumper, yaitu iklan video yang tidak dapat dilewati dengan durasi maksimal 6 detik yang diputar sebelum video dapat ditonton.

18 Juli 2016

Update ini mencakup perubahan berikut:

  • YouTube Analytics API (Kueri Bertarget)

    • Daftar metrik yang didukung untuk laporan saluran 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 ini 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 menurut negara bagian
      • Video teratas untuk penonton yang berlangganan atau berhenti berlangganan

    • Daftar filter telah diperbaiki untuk laporan retensi audiens channel dan laporan retensi audiens pemilik konten untuk menunjukkan bahwa filter video diperlukan dan filter group tidak didukung.

      Sebelumnya, dokumentasi untuk kedua laporan tersebut secara keliru menyatakan bahwa laporan dapat diambil menggunakan salah satu dari dua filter tersebut atau tanpa menggunakan filter.

  • YouTube Reporting API (Laporan Massal)

    • Di Ringkasan API, bagian yang menjelaskan cara mengambil URL download laporan telah diperbaiki untuk menyatakan bahwa YouTube memang membuat laporan yang dapat didownload untuk hari-hari saat tidak ada data yang tersedia. Laporan tersebut berisi baris header, tetapi tidak berisi data tambahan. Informasi ini telah diperbarui di bagian Karakteristik laporan dalam dokumen yang sama pada 12 April 2016.
    • Daftar dimensi dalam laporan content_owner_asset_cards_a1 telah diperbaiki untuk mencerminkan bahwa laporan menggunakan dimensi card_id. Sebelumnya, dokumentasi mencantumkan nama dimensi sebagai card_title secara keliru.

28 Juni 2016

Dokumentasi YouTube Analytics API telah diperbarui untuk mencerminkan dukungan untuk metrik kartu dalam banyak laporan channel dan pemilik konten. Metrik yang baru didukung adalah:

Metrik ini didukung dalam jenis laporan berikut:

22 Juni 2016

Update ini berisi perubahan YouTube Reporting API berikut. Perubahan pertama berkaitan dengan API secara umum, dan perubahan lainnya hanya memengaruhi laporan pemilik konten:

  • Bagian Karakteristik laporan di ringkasan API telah diperbarui untuk mengklarifikasi bahwa laporan tersedia melalui API selama 180 hari sejak dibuat.

    Sebelumnya, dokumentasi menyatakan bahwa laporan tersedia selama jangka waktu hingga 180 hari sebelum tanggal permintaan API dikirim. Meskipun secara teknis juga benar, teks aslinya paling-paling cukup membingungkan.

  • API ini mendukung versi baru dari tiga laporan. Dua laporan tersebut juga berisi metrik baru dan yang diganti namanya:

    • Laporan content_owner_ad_rates_a1 adalah versi baru dari laporan content_owner_ad_performance_a1. Laporan yang baru diganti namanya ini identik dengan versi sebelumnya.

    • Dua laporan yang memiliki versi baru telah diganti namanya:

      • Versi baru laporan content_owner_estimated_earnings_a1 diberi nama content_owner_estimated_revenue_a1.
      • Versi baru laporan content_owner_asset_estimated_earnings_a1 diberi nama content_owner_asset_estimated_revenue_a1.

      Kedua laporan yang baru diganti namanya ini berbeda dari laporan sebelumnya dalam hal berikut:

    Perhatikan bahwa jika Anda sudah memiliki tugas untuk membuat laporan versi lama ini, Anda harus membuat tugas baru untuk laporan yang namanya diubah. Sehubungan dengan rilis versi laporan baru, laporan content_owner_ad_performance_a1, content_owner_estimated_earnings_a1, dan content_owner_asset_estimated_earnings_a1 tidak digunakan lagi.

    Jika Anda memiliki tugas untuk laporan tersebut, Anda tidak dapat mengharapkan YouTube membuat laporan baru untuk tugas tersebut setelah 22 September 2016. Laporan yang dibuat akan tetap tersedia selama 180 hari sejak dibuat.

  • Definisi properti id resource reportType telah diperbarui untuk mencerminkan kumpulan laporan yang tersedia saat ini.

  • Nama dua metrik telah diperbaiki dalam dokumentasi agar sesuai dengan nama yang muncul dalam laporan. Ini murni perbaikan dokumentasi dan tidak mencerminkan perubahan pada konten laporan yang sebenarnya:

    • Nama metrik estimated_partner_adsense_revenue telah diperbarui menjadi estimated_partner_ad_sense_revenue. Namun, perhatikan bahwa metrik ini hanya muncul dalam dua laporan yang dihentikan penggunaannya dengan pembaruan ini. Seperti yang dijelaskan di atas, metrik ini telah diganti namanya menjadi estimated_partner_ad_auction_revenue dalam versi terbaru laporan tersebut.
    • Nama metrik estimated_partner_doubleclick_revenue telah diperbarui menjadi estimated_partner_double_click_revenue. Sekali lagi, perhatikan bahwa metrik ini hanya muncul dalam dua laporan yang dihentikan dengan pembaruan ini. Seperti yang dijelaskan di atas, metrik ini telah diganti namanya menjadi estimated_partner_ad_reserved_revenue dalam versi terbaru laporan tersebut.

  • Dokumentasi dimensi untuk Reporting API telah diperbarui sehingga tidak lagi mencantumkan properti elapsed_video_time_percentage dan audience_retention_type. Dimensi ini saat ini tidak didukung oleh laporan apa pun yang tersedia melalui API.

19 Mei 2016

Update ini berisi perubahan YouTube Reporting API berikut:

  • API ini mendukung versi baru laporan aktivitas pengguna untuk pemilik konten. ID jenis laporan untuk laporan baru adalah content_owner_basic_a2. Tidak seperti versi laporan sebelumnya, content_owner_basic_a1, versi baru mendukung metrik likes dan dislikes.

    Jika Anda sudah memiliki tugas untuk membuat laporan content_owner_basic_a1, Anda tetap perlu membuat tugas baru untuk laporan content_owner_basic_a2. YouTube tidak otomatis memigrasikan pemilik konten ke versi laporan baru atau otomatis membuat tugas untuk menghasilkan versi laporan baru. Dalam beberapa penerapan, munculnya tugas baru yang tidak terduga dapat menjadi perubahan yang merusak.

    Sehubungan dengan rilis laporan baru, laporan content_owner_basic_a1 telah tidak digunakan lagi. Jika Anda memiliki tugas untuk laporan tersebut, Anda tidak boleh mengharapkan YouTube membuat laporan baru untuk tugas tersebut setelah 19 Agustus 2016. Laporan yang dibuat akan tetap tersedia selama 180 hari sejak dibuat.

  • Resource reportType, job, dan report semuanya mendukung properti baru yang mengidentifikasi apakah resource terkait merepresentasikan jenis laporan yang tidak digunakan lagi:

    • Properti deprecateTime resource reportType menentukan tanggal dan waktu jenis laporan akan dihentikan. Properti ini hanya memiliki nilai untuk laporan yang telah diumumkan sebagai tidak digunakan lagi, dan nilai tersebut menunjukkan tanggal saat YouTube akan berhenti membuat laporan jenis tersebut.

      Setelah jenis laporan dinyatakan tidak digunakan lagi, YouTube akan membuat laporan jenis tersebut selama tiga bulan lagi. Misalnya, pembaruan pada 19 Mei 2016 ini mengumumkan penghentian penggunaan 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 resource job menentukan tanggal dan waktu tugas berakhir atau akan berakhir. Properti ini memiliki nilai jika jenis laporan yang terkait dengan tugas telah dihentikan atau jika laporan yang dibuat untuk tugas belum didownload dalam jangka waktu yang lama. Tanggal ini menandai waktu setelah YouTube tidak lagi membuat laporan baru untuk tugas tersebut.

    • Properti jobExpireTime resource report menentukan tanggal dan waktu saat tugas yang terkait dengan laporan berakhir atau akan berakhir. Properti ini berisi nilai yang sama dengan properti expireTime di resource job, seperti yang dijelaskan dalam item sebelumnya dalam daftar ini.

  • Metode jobs.create kini menampilkan kode respons HTTP 400 (Bad Request) jika Anda mencoba membuat tugas untuk laporan yang tidak digunakan lagi. Selain itu, dokumentasi metode kini mencantumkan beberapa alasan lain yang menyebabkan permintaan API gagal.

12 April 2016

Update ini berisi perubahan berikut, yang semuanya hanya memengaruhi YouTube Reporting API:

  • YouTube kini membuat data yang mencakup periode 180 hari sebelum tugas pelaporan pertama kali dijadwalkan. Sebelumnya, Reporting API tidak memberikan data historis apa pun. Perubahan ini memengaruhi semua tugas, termasuk tugas yang dibuat sebelum pengumuman ini.

    Laporan historis diposting segera setelah tersedia, meskipun diperlukan waktu sekitar satu bulan agar semua data historis diposting untuk suatu tugas. Jadi, sebulan setelah menjadwalkan tugas pelaporan, Anda akan memiliki akses ke data sekitar tujuh bulan. (Semua data historis untuk tugas yang dibuat sebelum pengumuman ini harus diposting dalam waktu satu bulan setelah pengumuman.)

    Perhatikan bahwa data historis hanya tersedia mulai 1 Juli 2015. Akibatnya, tugas 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 pada ringkasan YouTube Reporting API telah diperbarui dengan perubahan berikut:

    • Dokumentasi kini menyatakan bahwa laporan tersedia selama 180 hari setelah dibuat dan, oleh karena itu, tersedia untuk didownload oleh klien API. Sebelumnya, dokumentasi menyatakan bahwa laporan tersedia untuk jangka waktu hingga enam bulan sebelum tanggal permintaan API dikirim.

    • Dokumentasi telah diperbarui untuk mencerminkan fakta bahwa API kini membuat laporan yang dapat didownload untuk hari-hari saat tidak ada data yang tersedia. Laporan tersebut akan berisi baris header, 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 Creator Studio YouTube. Dengan demikian, fungsi API baru akan memberikan akses terprogram ke data tersebut.

    Perubahan API berikut diumumkan sekarang sebagai persiapan peluncuran laporan yang dikelola sistem:

    • Properti systemManaged baru resource job menunjukkan apakah resource tersebut menjelaskan tugas yang menghasilkan laporan yang dikelola sistem. YouTube otomatis membuat laporan yang dikelola sistem untuk pemilik konten YouTube, dan pemilik konten tidak dapat mengubah atau menghapus tugas yang membuat laporan tersebut.

    • Parameter includeSystemManaged baru metode jobs.list menunjukkan apakah respons API harus menyertakan tugas untuk laporan yang dikelola sistem. Nilai default parameter adalah false.

    • Parameter startTimeAtOrAfter baru metode jobs.reports.list menunjukkan bahwa respons API hanya boleh berisi laporan jika data paling awal dalam laporan tersebut berada pada atau setelah tanggal yang ditentukan. Demikian pula, parameter startTimeBefore menunjukkan bahwa respons API hanya boleh berisi laporan jika data paling awal dalam laporan adalah 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 resource reportType menunjukkan apakah resource menjelaskan laporan yang dikelola sistem.

    • Parameter includeSystemManaged baru pada metode reportTypes.list menunjukkan apakah respons API harus menyertakan laporan yang dikelola sistem. Nilai default parameter adalah false.

28 Maret 2016

YouTube Reporting API dan YouTube Analytics API kini menampilkan statistik penayangan untuk beberapa layanan berbagi tambahan.

  • Di YouTube Reporting API, dimensi sharing_service mendukung nilai baru berikut:
    • 82: Dialog aktivitas sistem iOS
    • 83: Google Inbox
    • 84: Android Messenger
  • Di YouTube Analytics API, dimensi sharingService mendukung nilai baru berikut:
    • ANDROID_MESSENGER: Android Messenger
    • INBOX: Google Inbox
    • IOS_SYSTEM_ACTIVITY_DIALOG: Dialog aktivitas sistem iOS

16 Maret 2016

Update ini berisi perubahan berikut, yang memengaruhi YouTube Reporting API dan YouTube Analytics API:

YouTube Reporting API

  • 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 langganan pengguna, atau di fitur penjelajahan YouTube lainnya.
    • 8: Data ini berkaitan dengan penayangan yang terjadi langsung di halaman hasil penelusuran YouTube.
  • Dimensi traffic_source_type kini mendukung 18 sebagai nilai dimensi. Nilai ini menunjukkan bahwa penayangan video berasal dari halaman yang mencantumkan semua video dalam playlist. Sumber ini berbeda dengan jenis sumber 14, yang menunjukkan bahwa penayangan terjadi saat video diputar sebagai bagian dari playlist.

YouTube Analytics API

  • Dimensi insightPlaybackLocationType mendukung dua nilai dimensi baru:
    • BROWSE: Data ini berkaitan dengan penayangan yang terjadi di halaman beranda atau layar utama YouTube, di feed langganan pengguna, atau di fitur penjelajahan YouTube lainnya.
    • SEARCH: Data ini berkaitan dengan penayangan yang terjadi langsung di halaman hasil penelusuran YouTube.
  • Dimensi insightTrafficSourceType kini mendukung YT_PLAYLIST_PAGE sebagai nilai dimensi. Nilai ini menunjukkan bahwa penayangan video berasal dari halaman yang mencantumkan semua video dalam playlist. Sumber ini berbeda dengan jenis sumber PLAYLIST, yang menunjukkan bahwa penayangan terjadi saat video diputar sebagai bagian dari playlist.

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 tersebut yang didokumentasikan sebagai mendukung metrik kartu apa pun.)

Perhatikan bahwa Anda masih dapat mengambil metrik kartu menggunakan YouTube Reporting API, yang mendukung metrik tersebut untuk banyak 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.

  • Di YouTube Reporting API, dimensi operating_system menggunakan nilai 21 untuk mengidentifikasi penayangan yang terjadi melalui Chromecast.
  • Di YouTube Analytics API, dimensi operatingSystem menggunakan nilai CHROMECAST untuk mengidentifikasi penayangan yang terjadi melalui Chromecast.

21 Desember 2015

Dalam dokumentasi, nama metrik annotation_clickable_impressions dan annotation_closable_impressions telah diperbarui agar sesuai 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 harus diberikan kepada dan izin diperoleh dari pengguna akhir di Uni Eropa. Oleh karena itu, untuk 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 kami.

15 Desember 2015

Update ini berisi perubahan berikut, yang semuanya memengaruhi YouTube Analytics API:

  • YouTube Analytics API kini mendukung tiga dimensi detail pemutaran baru, yang dapat digunakan dalam berbagai laporan pemilik channel dan konten:

    • liveOrOnDemand: Dimensi ini menunjukkan apakah data dalam laporan menjelaskan aktivitas pengguna yang terjadi selama siaran langsung.
    • subscribedStatus: Dimensi ini menunjukkan apakah metrik aktivitas pengguna dalam data terkait dengan penonton yang berlangganan channel video atau playlist.
    • youtubeProduct: Dimensi ini mengidentifikasi properti YouTube tempat aktivitas pengguna terjadi. Nilai yang mungkin 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 lain telah diperbarui untuk mencatat bahwa satu atau beberapa dimensi ini dapat secara opsional digunakan sebagai dimensi dan/atau filter dalam laporan tersebut.

  • Format tabel yang menjelaskan laporan telah diubah agar Anda lebih mudah mengidentifikasi kombinasi dimensi, metrik, dan filter yang valid yang dapat digunakan untuk mengambil setiap laporan. Tabel di bawah, yang menjelaskan laporan "Jenis Perangkat" untuk channel, menunjukkan format baru:

    Daftar Isi
    Dimensi:
    Wajib deviceType
    Gunakan 0 atau lebih day, liveOrOnDemand, subscribedStatus, youtubeProduct
    Metrik:
    Gunakan 1 atau lebih views, estimatedMinutesWatched
    Filter:
    Gunakan 0 atau 1 country, province, continent, subContinent
    Gunakan 0 atau 1 video, grup
    Gunakan 0 atau lebih operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

    Terminologi yang menjelaskan kolom wajib dan opsional dijelaskan dalam dokumentasi untuk laporan channel dan pemilik konten.

  • YouTube Analytics API kini secara otomatis menghilangkan entitas yang datanya tidak dapat diambil oleh pengguna API dari filter yang mendukung beberapa nilai (video, playlist, dan channel). Sebelumnya, server API hanya akan menampilkan error jika pengguna API tidak dapat mengakses data untuk setidaknya salah satu item yang ditentukan.

    Misalnya, pengguna mengirimkan permintaan API yang mencantumkan 20 ID video dalam filter video. Pengguna memiliki 18 video. Namun, satu ID video mengidentifikasi video yang dimiliki oleh channel lain, dan ID lainnya mengidentifikasi video yang telah dihapus dan oleh karena itu, tidak ada lagi. Dalam hal ini, alih-alih menampilkan error, server API kini 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 yang kosong, API kini menampilkan set data kosong, bukan error.

  • Metode groupItems.insert YouTube Analytics API kini menampilkan error tidak sah (kode respons HTTP 403) jika Anda mencoba menambahkan entitas ke grup, tetapi Anda tidak memiliki akses ke entitas tersebut. Sebelumnya, API akan mengizinkan Anda menambahkan entitas ke grup, tetapi kemudian menampilkan error 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 berisi semua grup yang tersedia, parameter nextPageToken respons akan menentukan token yang dapat digunakan untuk mengambil halaman hasil berikutnya. Setel parameter pageToken metode ke nilai tersebut untuk mengambil hasil tambahan.

10 November 2015

Update ini berisi perubahan berikut:

29 Oktober 2015

Update ini berisi perubahan berikut:

  • Dokumentasi untuk dimensi date YouTube Reporting API telah diperbaiki untuk mencerminkan bahwa tanggal merujuk pada periode 24 jam yang dimulai pada pukul 00.00 Waktu Pasifik (UTC-8). Sebelumnya, dokumentasi menyatakan bahwa tanggal dimulai pada pukul 00.00 (GMT).

    Selain itu, dokumentasi YouTube Analytics API telah diperbarui untuk mencatat bahwa semua dimensi terkait tanggal (day, 7DayTotals, 30DayTotals, dan month) merujuk pada tanggal yang dimulai pukul 00.00 waktu Pasifik (UTC-8).

  • Metode jobs.reports.list() YouTube Reporting API kini mendukung parameter kueri createdAfter. 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, bukan tanggal yang terkait dengan data yang ditampilkan.

    Nilai parameter adalah stempel waktu dalam format RFC3339 UTC "Zulu", 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 memproses laporan yang sama berulang kali.

  • Definisi properti createTime resource job dan properti startTime, endTime, dan createTime resource report telah dikoreksi untuk mencatat bahwa nilai properti akurat hingga mikrodetik, bukan nanodetik. Selain itu, semua definisi kini secara akurat mencerminkan bahwa nilai properti adalah stempel waktu.

8 Oktober 2015

Update ini berisi perubahan berikut:

  • Dokumentasi untuk dimensi sharingService YouTube Analytics API telah diperbarui untuk menyertakan daftar kemungkinan nilai dimensi. Daftar ini mencakup sejumlah layanan yang baru didukung.

    Definisi dimensi sharing_service YouTube Reporting API juga telah diupdate untuk mencantumkan nilai yang baru didukung. Nilai enum yang lebih besar dari 59 adalah nilai baru dalam daftar.

24 September 2015

Update ini berisi perubahan berikut:

  • YouTube Reporting API yang baru mengambil laporan data massal yang berisi data YouTube Analytics untuk sebuah channel atau pemilik konten. API ini dirancang untuk aplikasi yang dapat mengimpor set data besar dan yang menyediakan alat untuk memfilter, mengurutkan, dan menggali data tersebut.

    Setiap laporan YouTube Reporting API berisi serangkaian dimensi dan metrik standar. (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 bagi masing-masing 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 tugas, YouTube akan membuat 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 kedua API menyediakan akses ke set data yang serupa, dokumentasi untuk kedua API ini dipublikasikan sebagai satu set dokumentasi.

    • Tab Panduan dalam set dokumentasi berisi informasi umum untuk kedua API, termasuk petunjuk untuk mengizinkan permintaan API.
    • Tab Laporan massal berisi dokumentasi referensi dan konten lain khusus untuk YouTube Reporting API.
    • Tab Kueri bertarget berisi dokumentasi referensi dan konten lain khusus untuk YouTube Analytics API.
    • Tab Contoh mencantumkan contoh kode yang tersedia untuk salah satu dari dua API.
    • Tab Tools mencantumkan resource tambahan yang tersedia untuk membantu developer menerapkan salah satu dari dua API.

20 Agustus 2015

Update ini berisi perubahan berikut:

  • Dokumentasi API telah disusun ulang agar API lebih mudah dipahami. Oleh karena itu, perubahan ini tidak menjelaskan fitur baru:

    • Dokumentasi kini berisi satu halaman yang mencantumkan semua laporan channel yang tersedia dan halaman lain 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 yang baru berupaya memberikan pengantar yang lebih jelas tentang cara kerja API. Secara khusus, dokumen ini mencoba 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 didesain untuk membantu Anda mengidentifikasi informasi yang perlu dikirimkan dengan lebih mudah untuk mengambil laporan.

22 Juli 2015

Update ini berisi beberapa perubahan, yang semuanya hanya berlaku untuk pemilik konten:

  • Metrik adEarnings baru mencakup total estimasi penghasilan (pendapatan bersih) dari semua sumber iklan yang dijual Google. Ini bukan metrik inti. API ini mendukung metrik adEarnings untuk laporan apa pun yang sudah mendukung metrik earnings.

    Selain itu, definisi metrik earnings telah diperbaiki untuk mencerminkan fakta bahwa nilainya mencakup total estimasi penghasilan dari semua sumber iklan yang dijual oleh Google serta dari sumber non-iklan. Sebelumnya, definisi tersebut keliru menunjukkan bahwa metrik hanya menyertakan penghasilan dari sumber iklan.

  • Metrik primaryAdGrossRevenue tidak digunakan lagi. Sebagai gantinya, gunakan metrik grossRevenue untuk mengambil data pendapatan.

  • Selain metrik primaryAdGrossRevenue yang tidak digunakan lagi, laporan performa iklan tidak lagi mendukung metrik monetizedPlaybacks dan playbackBasedCpm. Namun, beberapa laporan video masih mendukung metrik tersebut.

1 Juni 2015

Update ini berisi perubahan berikut:

  • API kini mendukung dua metrik baru untuk laporan video, videosAddedToPlaylists dan videosRemovedFromPlaylists. Daftar laporan video untuk channel dan pemilik konten telah diperbarui untuk mengidentifikasi laporan yang mendukung metrik baru.

    • videosAddedToPlaylists – Jumlah video dalam cakupan kueri yang ditambahkan ke playlist YouTube mana pun. Video tersebut mungkin telah ditambahkan ke playlist pemilik video atau ke playlist channel lain.
    • videosRemovedFromPlaylists – Jumlah video dalam cakupan kueri yang dihapus dari playlist YouTube mana pun. Video tersebut mungkin telah dihapus dari playlist pemilik video atau dari playlist channel lain.

    Kedua metrik mencakup playlist default seperti playlist "Tonton Nanti". Namun, playlist yang video ditambahkan secara otomatis, seperti playlist upload channel atau histori tontonan pengguna, tidak dihitung. Perhatikan juga bahwa metrik ini mencerminkan jumlah absolut penambahan dan penghapusan. Jadi, jika pengguna menambahkan video ke playlist, lalu menghapusnya, dan kemudian menambahkannya lagi, metrik menunjukkan bahwa video tersebut ditambahkan ke dua playlist dan dihapus dari satu playlist.

    Data untuk metrik ini tersedia mulai 1 Oktober 2014.

31 Maret 2015

Update ini berisi perubahan berikut:

16 Maret 2015

Update ini berisi perubahan berikut:

  • Parameter currency baru memungkinkan Anda mengambil metrik penghasilan dalam mata uang selain dolar Amerika Serikat (USD). Jika parameter ini ditetapkan, API akan mengonversi nilai untuk metrik earnings, grossRevenue, playbackBasedCpm, dan impressionBasedCpm 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.

25 Februari 2015

Update ini berisi perubahan berikut:

  • API kini mendukung kemampuan untuk membuat dan mengelola grup YouTube Analytics serta kemampuan untuk mengambil data laporan untuk grup tersebut.

    • Membuat dan mengelola grup

      Pembaruan ini memperkenalkan resource group dan groupItem untuk membuat dan mengelola grup.

      • Resource group merepresentasikan grup Analytics, yaitu kumpulan kustom hingga 200 channel, video, playlist, atau aset. API mendukung metode list, insert, update, dan delete untuk resource ini.
      • Resource groupItem mewakili item dalam grup Analytics. API mendukung metode list, insert, dan delete untuk resource ini.

      Jadi, misalnya, Anda dapat membuat grup menggunakan metode groups.insert, lalu menambahkan item ke grup tersebut menggunakan metode groupItems.insert.

    • Mengambil data laporan untuk grup

      Dokumentasi dimensi telah diperbarui untuk menyertakan dimensi group, yang dapat digunakan sebagai filter untuk banyak laporan channel dan laporan pemilik konten. Saat Anda menggunakan filter group, API akan menampilkan data untuk semua item dalam grup tersebut. Perhatikan bahwa saat ini API tidak mendukung kemampuan untuk membuat laporan untuk grup aset.

    Lihat Pusat Bantuan YouTube untuk mengetahui informasi selengkapnya tentang grup YouTube Analytics.

13 Februari 2015

Update ini berisi perubahan berikut:

  • API tidak lagi mendukung dimensi show.

28 Agustus 2014

Update ini berisi perubahan berikut:

  • API kini mendukung kemampuan untuk menentukan beberapa nilai untuk dimensi video, playlist, channel, dan show saat dimensi tersebut digunakan sebagai filter. Untuk menentukan beberapa nilai, tetapkan nilai parameter filters ke daftar ID video, playlist, channel, atau acara yang dipisahkan koma yang respons API-nya harus difilter. Nilai parameter dapat menentukan hingga 200 ID.

    Jika 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 mengetahui detail lengkap tentang fungsi ini.

16 Juli 2014

Update ini berisi perubahan berikut:

  • Saat mengambil laporan saluran, Anda kini dapat mengambil data untuk saluran pengguna terautentikasi dengan menyetel nilai parameter ids ke channel==MINE. (Anda juga tetap dapat menyetel parameter ids ke channel==CHANNEL_ID untuk mengambil data untuk saluran yang ditentukan.)

  • API kini mendukung laporan playlist, yang berisi statistik terkait penayangan video yang terjadi dalam konteks playlist. Laporan playlist tersedia untuk channel dan pemilik konten.

    Semua laporan playlist mendukung metrik views dan estimatedMinutesWatched, dan beberapa juga mendukung metrik averageViewDuration.

    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: Perkiraan rata-rata durasi, 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 disetel ke 1 (isCurated==1).

  • API ini kini mendukung laporan retensi audiens. Laporan ini mengukur kemampuan video dalam mempertahankan penontonnya. Dimensi elapsedVideoTimeRatio baru dalam laporan 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 frekuensi sebagian video ditonton dengan total jumlah penayangan video.

      Perhatikan bahwa sebagian video dapat ditonton lebih dari sekali (atau tidak ditonton sama sekali) dalam penayangan video tertentu. Misalnya, jika pengguna memutar ulang dan menonton bagian video yang sama beberapa kali, 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 durasinya sama. Nilai 0 menunjukkan bahwa video mempertahankan penonton lebih buruk daripada video lain yang durasinya sama, sedangkan nilai 1 menunjukkan bahwa video mempertahankan penonton lebih baik daripada video lain yang durasinya sama. Nilai median 0,5 menunjukkan bahwa setengah dari video dengan durasi yang sama mempertahankan penonton lebih baik, sementara setengahnya mempertahankan penonton 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 video yang disarankan.)

  • API ini mendukung beberapa metrik baru yang terkait dengan anotasi. Metrik yang tercantum di bawah dapat diambil dengan laporan apa pun yang sebelumnya mendukung metrik annotationClickThroughRate dan annotationCloseRate.

    Semua metrik baru adalah metrik inti dan tunduk pada Kebijakan Penghentian Penggunaan. Namun, perhatikan bahwa data tersedia untuk metrik baru mulai 16 Juli 2013. (Data untuk metrik annotationClickThroughRate dan annotationCloseRate tersedia mulai 10 Juni 2012.)

  • GOOGLE_SEARCH tidak lagi dilaporkan sebagai nilai terpisah untuk dimensi insightTrafficSourceType. Sebagai gantinya, rujukan dari hasil penelusuran Google kini diatribusikan ke jenis sumber traffic EXT_URL. Akibatnya, Anda juga tidak dapat lagi mengambil laporan insightTrafficSourceDetail yang menyetel filter insightTrafficSourceType ke GOOGLE_SEARCH.

31 Januari 2014

Update ini berisi perubahan berikut:

16 Januari 2014

Update ini berisi perubahan berikut:

  • Dokumen permintaan contoh telah didesain ulang untuk mengelompokkan contoh dalam kategori, menggunakan format tab yang serupa dengan yang baru-baru ini dirilis untuk laporan pemilik konten dan channel. Dengan desain baru, contoh dikelompokkan ke dalam kategori berikut:

    • Statistik dasar
    • Berdasarkan waktu
    • Geografis
    • Lokasi pemutaran
    • Sumber traffic
    • Perangkat/OS
    • Demografi
    • Sosial
    • Penghasilan/Iklan (khusus untuk laporan pemilik konten)

  • Dokumen permintaan contoh kini menyertakan contoh baru untuk mengambil data khusus provinsi dalam laporan channel atau laporan pemilik konten.

    • Metrik khusus provinsi untuk negara bagian Amerika Serikat dan Washington D.C.: Laporan ini mengambil perincian jumlah penayangan dan statistik lainnya untuk video channel berdasarkan provinsi. Data mencakup negara bagian AS dan Washington D.C. Contoh ini menggunakan dimensi province, dan juga menggunakan parameter filters 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 pemilik konten. Contoh ini menggunakan parameter filters untuk memastikan respons hanya menyertakan data untuk provinsi tertentu.

  • Definisi dimensi province telah diperbarui untuk mencatat bahwa jika province disertakan dalam nilai parameter dimensions, permintaan juga harus membatasi data ke Amerika Serikat dengan menyertakan country==US dalam nilai parameter filters.

6 Januari 2014

Update ini berisi perubahan berikut:

  • Dokumen yang mencantumkan laporan channel dan pemilik konten yang didukung telah didesain ulang. Daripada memberikan tabel yang mencantumkan semua kemungkinan laporan, setiap dokumen mengelompokkan laporan ke dalam kategori:

    • Statistik dasar
    • Berdasarkan 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 kini mendukung tiga dimensi geografis baru: province, continent, dan subContinent.

    • Dimensi province memungkinkan Anda mengambil statistik untuk negara bagian AS dan untuk Distrik Kolombia. API ini mendukung dua penggunaan untuk dimensi ini:

      • API ini mendukung dua laporan yang mengelompokkan statistik berdasarkan negara bagian. Kedua laporan tersedia untuk channel dan pemilik konten.

        • Laporan statistik inti memberikan beberapa statistik, termasuk jumlah penayangan dan perkiraan menit ditonton.
        • Laporan berbasis waktu memberikan statistik yang sama, tetapi menggabungkan data harian, 7 hari, 30 hari, atau bulanan.

      • Anda dapat menggunakan parameter kueri filters untuk membatasi laporan agar hanya berisi statistik untuk negara bagian tertentu. Beberapa laporan mendukung jenis pemfilteran ini, termasuk laporan geografis, laporan lokasi pemutaran, laporan sumber traffic, laporan perangkat, laporan sistem operasi, laporan demografi, 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 sub-wilayah 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 filter subContinent. (Sebenarnya, API akan menampilkan error jika permintaan menggunakan kedua dimensi.)

  • Dokumentasi telah diperbaiki sehingga dimensi insightTrafficSourceDetail tidak menyertakan nilai insightTrafficSourceType PROMOTED sebagai nilai filter yang valid.

30 September 2013

Update ini berisi perubahan berikut:

  • 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 Penggunaan. Halaman dimensi dan metrik telah diupdate untuk mencantumkan dimensi inti dan metrik inti. Selain itu, definisi di halaman tersebut telah diperbarui untuk mengidentifikasi dimensi dan metrik inti secara eksplisit.

  • API kini mendukung EXTERNAL_APP sebagai nilai untuk dimensi insightPlaybackLocationType. Sehubungan dengan pembaruan ini, mulai 10 September 2013, pemutaran tidak lagi dikategorikan sebagai pemutaran MOBILE, meskipun pemutaran seluler yang terjadi sebelum tanggal tersebut akan tetap dikategorikan dengan nilai tersebut.

    Dengan pembaruan ini, pemutaran di perangkat seluler kini diklasifikasikan sebagai pemutaran WATCH, EMBEDDED, atau EXTERNAL_APP, bergantung pada jenis aplikasi tempat pemutaran terjadi.

  • API kini mendukung PLAYLIST sebagai nilai untuk dimensi insightTrafficSourceType. Nilai ini menunjukkan bahwa penayangan video dirujuk dari playlist. Sebelumnya, tampilan ini akan diklasifikasikan menggunakan kategori YT_OTHER_PAGE dimensi.

16 Juli 2013

Update ini berisi perubahan berikut:

  • API kini mendukung kemampuan untuk mengurutkan laporan menurut beberapa dimensi dan metrik. Dokumen permintaan sampel berisi contoh baru, Mengurutkan permintaan menurut beberapa dimensi/metrik, yang menunjukkan fungsi ini. Permintaan mengambil data sumber traffic dan memiliki nilai parameter sort sebesar day,-views. Hasil diurutkan secara kronologis, tetapi dalam set hasil 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 kini mendukung dua dimensi baru, deviceType dan operatingSystem, yang dapat digunakan untuk mengambil data tentang perangkat tempat penonton menonton video Anda. API ini mendukung laporan yang menggunakan salah satu atau kedua dimensi tersebut.

    • Laporan deviceType memungkinkan Anda mengambil jumlah penayangan dan perkiraan waktu tonton untuk berbagai jenis perangkat, termasuk perangkat desktop, seluler, dan tablet. Anda juga dapat menggunakan filter operatingSystem 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 filter deviceType untuk membatasi laporan sistem operasi agar hanya berisi statistik untuk jenis perangkat tertentu, seperti perangkat seluler atau tablet.

    Laporan jenis perangkat dan sistem operasi baru tersedia untuk channel dan pemilik konten.

  • Dokumen permintaan contoh telah diperbarui untuk menyertakan tiga laporan perangkat untuk channel dan tiga laporan perangkat untuk pemilik konten.

  • Dimensi insightPlaybackLocationType dapat menampilkan nilai YT_OTHER, yang mengidentifikasi tampilan yang tidak diklasifikasikan menggunakan salah satu nilai dimensi lainnya.

23 Mei 2013

Update ini berisi perubahan berikut:

  • Dokumen laporan pemilik konten telah diperbarui untuk menunjukkan bahwa Anda dapat mengurutkan laporan video teratas dalam urutan menurun berdasarkan penghasilan untuk mengidentifikasi video dengan penghasilan tertinggi. Laporan ini adalah laporan pertama yang tercantum dalam tabel kedua di bagian Laporan aktivitas pengguna dan penghasilan.

10 Mei 2013

Update ini berisi perubahan berikut:

6 Mei 2013

Update ini berisi perubahan berikut:

  • API kini mendukung kemampuan untuk mengambil metrik waktu tonton – estimatedMinutesWatched, averageViewDuration, dan averageViewPercentage – 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. (Daftarnya kini 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 dan insightTrafficSourceDetail telah ditingkatkan dengan cara berikut:

    • Sekarang, filter ini mendukung filter country opsional.

    • Pemilik konten kini dapat mengambil laporan ini menggunakan kombinasi filter baru berikut. Perhatikan bahwa semua kombinasi ini juga mendukung filter country 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

3 Mei 2013

Update ini berisi perubahan berikut:

  • Dokumen Contoh permintaan API baru memberikan contoh yang menunjukkan cara mengambil berbagai jenis laporan menggunakan YouTube Analytics API. Setiap contoh mencakup deskripsi singkat laporan yang diambil permintaan, lalu menampilkan dimensi, metrik, filter, dan parameter pengurutan untuk permintaan.

  • Dimensi insightTrafficSourceType kini mendukung SUBSCRIBER sebagai nilai yang valid. Nilai ini mengidentifikasi penayangan video yang dirujuk dari feed di halaman beranda YouTube atau dari fitur langganan YouTube. Jika Anda memfilter berdasarkan sumber traffic ini, kolom insightTrafficSourceDetail akan menentukan feed beranda atau halaman lain tempat penayangan dirujuk.

28 Maret 2013

Update ini berisi perubahan berikut:

21 Maret 2013

Update ini berisi perubahan berikut:

  • API kini mendukung metrik penghasilan dan performa iklan serta laporan performa iklan baru. Metrik dan laporan hanya dapat diakses oleh partner konten YouTube yang berpartisipasi dalam Program Partner YouTube.

    • Laporan yang baru didukung ini mendukung metrik performa iklan berbasis pemutaran dan metrik performa iklan berbasis tayangan. Lihat dokumentasi laporan pemilik konten untuk mengetahui informasi selengkapnya tentang laporan performa iklan.

    • Metrik yang baru didukung tercantum di bawah. 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 – Perkiraan pendapatan kotor, yang dijumlahkan dan diklasifikasikan berdasarkan jenis iklan utama untuk pemutaran video yang tercakup 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 – Estimasi pendapatan kotor per seribu tayangan iklan.

      Catatan: Lihat definisi metrik untuk mengetahui detail selengkapnya.

    • Setiap permintaan yang mengambil metrik penghasilan atau performa iklan harus mengirimkan token otorisasi yang memberikan akses menggunakan cakupan https://www.googleapis.com/auth/yt-analytics-monetary.readonly baru.

  • Dokumentasi API telah diatur ulang sehingga berbagai jenis laporan dijelaskan di halaman terpisah. Oleh karena itu, kini ada halaman terpisah yang menjelaskan berbagai jenis laporan channel dan laporan pemilik konten.

4 Februari 2013

Update ini berisi perubahan berikut:

  • Panduan referensi API kini memiliki bagian examples, yang mencakup contoh kode yang menunjukkan cara memanggil API menggunakan library klien Java, JavaScript, Python, dan Ruby. Contoh kode JavaScript adalah contoh yang sama yang dibahas secara mendetail dalam dokumentasi aplikasi contoh.

14 November 2012

Update ini berisi perubahan berikut:

  • Panduan referensi API kini menampilkan APIs Explorer, yang memungkinkan Anda memanggil API, melihat permintaan API, dan mengambil data sebenarnya 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 metrik juga telah diperbarui.

    • Laporan lokasi pemutaran menentukan jumlah penayangan video yang terjadi di berbagai jenis halaman atau aplikasi.

    • Laporan detail lokasi pemutaran mengidentifikasi pemutar sematan yang menghasilkan penayangan terbanyak untuk video tertentu. Laporan ini memberikan tampilan yang lebih terperinci 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 mengirimkan traffic terbanyak ke video tertentu. Laporan ini didukung untuk beberapa sumber traffic.

    • Laporan waktu tonton memberikan jumlah waktu yang dihabiskan penonton untuk menonton konten Anda. Laporan dapat menggabungkan data untuk jangka waktu tertentu – hari ini, tujuh hari sebelumnya, 30 hari sebelumnya, dll. – 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.

2 Oktober 2012

Update ini berisi perubahan berikut:

  • YouTube Analytics API kini tersedia untuk semua developer. Anda dapat mengaktifkan API untuk project Anda, tanpa harus meminta akses terlebih dahulu, dari panel Services di APIs console.

  • Bagian Mulai yang baru menguraikan prasyarat dan langkah-langkah dasar untuk membangun aplikasi yang menggunakan YouTube Analytics API.

12 September 2012

Update ini berisi perubahan berikut:

  • Bagian memahami penggunaan kuota yang baru memberikan panduan untuk mengoptimalkan penggunaan kuota API Anda. Server API menghitung biaya kueri untuk setiap permintaan, dan biaya tersebut dikurangi dari kuota penggunaan API Anda. Karena berbagai jenis laporan mungkin memiliki biaya kueri yang sangat berbeda, Anda harus berencana menggunakan kuota secara efisien, dan aplikasi Anda hanya boleh meminta metrik dan data yang benar-benar diperlukan.

  • Bagian dimensi temporal telah diperbarui untuk menjelaskan bahwa dimensi tersebut menunjukkan bahwa laporan Analytics harus menggabungkan data berdasarkan jangka waktu. API kini mendukung dimensi temporal tambahan berikut:

    • 7DayTotals – Data dalam laporan akan diagregasikan sehingga setiap baris berisi data untuk periode tujuh hari.
    • 30DayTotals – Data dalam laporan akan digabungkan sehingga setiap baris berisi data untuk periode 30 hari.
    • month – Data dalam laporan akan diagregasikan menurut bulan kalender.

    Demikian pula, bagian laporan yang tersedia telah diperbarui untuk mencerminkan dukungan API untuk laporan yang menggunakan dimensi ini.

  • Bagian dimensi entitas pelaporan telah diperbarui untuk mencatat bahwa permintaan API untuk mengambil laporan pemilik konten harus memfilter data menggunakan salah satu dimensi ini (video, channel, atau show) atau kombinasi dimensi claimedStatus dan uploaderType yang didukung.

  • API 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, dll.) berdasarkan per negara dan mengelompokkan metrik tersebut menurut video. Sekarang Anda dapat mengurutkan laporan ini berdasarkan jumlah pengguna yang subscribe atau berhenti subscribe dari channel dari halaman tonton video.

  • Definisi metrik subscribersGained dan subscribersLost 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. Jika muncul dalam laporan khusus video, metrik ini hanya mencakup statistik dari halaman tonton video yang ditentukan.