YouTube Content ID API - Histori Revisi

Catatan: YouTube Content ID API ditujukan untuk digunakan oleh partner konten YouTube dan tidak dapat diakses oleh semua developer atau semua pengguna YouTube. Jika Anda tidak melihat YouTube Content ID API sebagai salah satu layanan yang tercantum di Konsol Google API, lihat Pusat Bantuan YouTube untuk mempelajari Program Partner YouTube lebih lanjut.

Halaman ini mencantumkan perubahan dan pembaruan dokumentasi YouTube Content ID API.

26 Maret 2025

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

Paling lambat 30 Juni 2025, Content ID API akan diperbarui dengan cara berikut sesuai dengan perubahan ini:

  • Urutan pengurutan claimSearch.list.sort akan diperbarui:
    • DAILY_ENGAGED_VIEWS akan ditambahkan untuk jumlah penayangan harian berdasarkan metodologi penghitungan penayangan sebelumnya.
    • LIFETIME_ENGAGED_VIEWS akan ditambahkan ke jumlah penayangan sepanjang waktu berdasarkan metodologi penghitungan penayangan sebelumnya.
  • Urutan pengurutan assetSearch.list.sort akan diperbarui:
    • DAILY_ENGAGED_VIEWS akan ditambahkan untuk jumlah penayangan harian berdasarkan metodologi penghitungan penayangan sebelumnya.

Paling lambat 30 September 2025, Content ID API akan diperbarui dengan cara berikut sesuai dengan perubahan ini:

  • Urutan pengurutan assetSearch.list.sort VIEWS tidak akan digunakan lagi.
  • Urutan pengurutan claimSearch.list.sort VIEW_COUNT tidak akan digunakan lagi.
  • claimSearch.claimSnippet.videoViews akan diperbarui untuk mencerminkan metodologi penghitungan penayangan yang diperbarui untuk penayangan Shorts.
  • claimSearch.claimSnippet.engagedViews akan ditambahkan untuk jumlah penayangan berdasarkan metodologi penghitungan penayangan sebelumnya

14 Januari 2025

Kolom autoGeneratedBreaks[] resource videoAdvertisingOption telah diperbarui karena sekarang kami mengizinkan ad_breaks dan autoGeneratedBreaks disediakan secara bersamaan. Jika autoGeneratedBreaks disetel ke true pada video dengan adBreaks yang ditentukan, sistem kami akan mengidentifikasi posisi penayangan iklan selain slot iklan yang Anda tempatkan secara manual. Lihat artikel dukungan untuk mengetahui detail selengkapnya.

10 November 2023

Kolom adFormats[] resource videoAdvertisingOption telah diperbarui sehingga third_party adalah satu-satunya nilai yang valid untuk kolom tersebut. Format iklan berikut tidak lagi didukung: instream_trueview, instream_standard, display, preroll, postroll. Lihat artikel dukungan untuk mengetahui detail selengkapnya.

1 Juni 2023

Catatan: Ini adalah pengumuman penghentian penggunaan.

Update ini mencakup perubahan berikut:

20 Desember 2022

Definisi parameter kueri ownershipRestriction metode assetSearch.list telah diperbarui untuk memperjelas bahwa jika nilai parameter tersebut adalah none, nilai parameter metadataSearchFields juga harus menggunakan setidaknya satu filter ID. Perubahan dokumentasi ini tidak mencerminkan perubahan pada perilaku API.

9 November 2022

Dokumentasi untuk metode asset.get dan asset.list telah diperbarui untuk menjelaskan cara beberapa nilai didukung untuk:

28 September 2022

Informasi lisensi telah ditambahkan ke asset resource.

18 Juli 2022

Dokumentasi untuk inactiveReasons metode claimSearch.list telah diperbarui untuk mencerminkan peningkatan konsistensi dengan YouTube Studio:

  • Studio sebelumnya telah menghapus dukungan untuk Audio Swap dan Song Erase. Nilai API yang sesuai, audio_removed dan song_erased, diabaikan secara diam-diam dan kini tidak didokumentasikan.
  • channel_whitelisted telah diganti dengan channel_allowlisted. Nilai sebelumnya tidak lagi didokumentasikan, tetapi masih didukung.
  • Nilai closed_disabled_monetization, closed_manually, closed_no_adsense, closed_own_video_match, reference_removed, replaced, dan video_modified kini didukung.

14 Juni 2022

Dokumentasi resource assetSearch telah diperbarui untuk mencerminkan dua properti baru: isrcs[] dan iswcs[]. Nilai properti isrcs[] dan iswcs[] yang baru masing-masing berisi array nilai string dengan setiap nilai yang menentukan ISRC atau ISWC, sebagaimana mestinya, yang dipetakan ke aset yang diidentifikasi oleh hasil penelusuran.

Properti baru direkomendasikan daripada properti isrc dan iswc yang sudah disertakan dalam resource assetSearch karena properti baru memberikan data yang lebih akurat. Sementara properti baru berpotensi mencantumkan array nilai string, properti isrc dan iswc masing-masing hanya mengidentifikasi satu kode ISRC atau ISWC yang terkait dengan hasil penelusuran.

12 Mei 2022

Link ke library klien telah diperbarui untuk mengarah ke library klien Google API standar. Binding yang dibuat sebelumnya untuk PHP telah diperbarui.

3 Mei 2022

Parameter status metode claimSearch.list kini mendukung lebih banyak filter berdasarkan detail klaim potensial.

May 2, 2022

Dokumentasi untuk Respons metode assetSearch.list telah diperbarui untuk mencerminkan peningkatan konsistensi dengan AIP-158:

  • Deskripsi pageInfo.totalResults secara eksplisit menyebutkan bahwa nilai tersebut adalah estimasi, bukan nilai sebenarnya
  • Kolom pageInfo.resultsPerPage dan pageInfo.startIndex telah dihapus

25 April 2022

Dokumentasi untuk resource assetLabels.list telah diperbarui untuk memperjelas arti parameter permintaan labelPrefix dan q, serta untuk mendokumentasikan bahwa permintaan / respons mendukung penomoran halaman.

8 Desember 2021

Dokumentasi untuk resource claimSearch.list telah diperbarui untuk mencerminkan dengan benar dua kasus penggunaan yang dicakup oleh metode ini:

  • Telusuri menurut ID (aset, referensi, atau video) atau string kueri
  • Telusuri berdasarkan tanggal pembuatan, tanggal perubahan, atau status klaim

Setiap kasus penggunaan mendukung kumpulan parameter kueri yang berbeda. Dokumentasi metode claimSearch.list telah diperbarui untuk menjelaskan parameter mana yang didukung untuk setiap kasus penggunaan.

17 November 2021

Update ini mencakup perubahan berikut:

  • Metode claims.update kini mendukung kemampuan untuk memperbarui status klaim yang tidak aktif atau potensial menjadi active. Definisi properti status resource claim memberikan detail selengkapnya.
  • Dokumentasi untuk resource claim dan claimSearch telah diperbarui untuk mencerminkan penambahan objek studioInfo baru, yang berisi link ke halaman YouTube Studio yang terkait dengan klaim.
  • Daftar nilai yang didukung untuk parameter origin metode claimSearch.list telah berubah. Parameter ini kini mendukung empat nilai tambahan: batchTool, inProductShorts, melodyMatch, dan youTubeAdmin. Selain itu, nilai dropboxUpload dan webUpload tidak lagi didukung.

26 Februari 2021

Dokumentasi untuk parameter videoId metode claimSearch.list telah diperbarui untuk menunjukkan bahwa nilai parameter kini menerima maksimum 10 ID video yang dipisahkan koma. API akan menampilkan error badRequest — kode respons HTTP 400 — jika nilai berisi lebih dari 10 ID video.

6 Desember 2018

Catatan: Ini adalah pengumuman penghentian penggunaan.

Dokumentasi API telah diperbarui untuk menghapus referensi ke resource contentOwnerAdvertisingOptions dan metodenya. Metode ini digunakan sangat sedikit, dan pengguna API yang menggunakannya telah dihubungi secara terpisah sebelum pengumuman ini.

21 Maret 2018

Update ini berisi perubahan berikut:

  • Properti metadataMine.artist kini harus ditetapkan setiap kali Anda menyisipkan, memperbarui, atau mem-patch aset video musik atau rekaman suara. API kini menampilkan error jika properti tidak ditetapkan untuk jenis resource tersebut. Selain itu, perhatikan bahwa properti metadataMine.artist hanya didukung untuk artis video musik dan rekaman suara.

24 Juli 2017

Update ini berisi perubahan berikut:

  • Resource package baru mewakili sekelompok file yang dikirim melalui web, SFTP, atau mekanisme pengiriman lainnya. API ini mendukung dua metode untuk resource ini:

    • Metode package.insert memvalidasi dan mengupload paket khusus metadata yang berisi tepat satu file metadata.
    • Metode package.get mengambil informasi tentang paket yang diupload sebelumnya.

  • Untuk metode validator.validate, definisi properti uploaderName telah diperbarui untuk menunjukkan bahwa nilai tersebut tidak mengidentifikasi partner konten yang mengupload data, melainkan nilai seperti web-google atau yt-google yang mengidentifikasi akun uploader tertentu yang digunakan pemilik konten.

  • Properti status resource reference tidak lagi menggunakan nilai duplicate_on_hold untuk menunjukkan bahwa referensi adalah duplikat dari referensi lain. Sebagai gantinya, jika referensi merupakan duplikat, nilai properti status kini ditetapkan ke inactive, dan nilai properti statusReason adalah REASON_DUPLICATE_FOR_OWNERS.

    Namun, seperti sebelumnya, properti duplicateLeader resource hanya diisi jika referensinya merupakan duplikat. Jika ditetapkan, nilai properti tersebut akan mengidentifikasi referensi duplikat.

17 April 2017

Update ini berisi perubahan berikut:

  • Resource assetShare baru yang hanya relevan dengan aset komposisi, mengidentifikasi hubungan antara dua representasi resource aset. Representasi ini mencerminkan model data publikasi baru yang dirancang untuk memberikan transparansi dan kontrol yang lebih besar atas cara pengaitan hak Anda dengan aset rekaman suara.

    Dalam model baru, setiap rekaman suara dipetakan ke satu aset unik, yang disebut tampilan komposisi. Metadata aset tersebut mewakili kumpulan informasi kanonis yang ditampilkan YouTube tentang hak komposisi yang terkait dengan rekaman tertentu, dan dapat menyintesis informasi dari beberapa penyedia data.

    Selain itu, setiap pemilik komposisi memiliki aset bagian komposisi-nya sendiri. Bagian komposisi merepresentasikan informasi yang diberikan penerbit tertentu untuk aset komposisi. Bagian komposisi dapat dikaitkan dengan banyak rekaman suara.

    Resource assetShare mengidentifikasi hubungan antara tampilan komposisi dan bagian komposisi. Metode assetShares.list baru memungkinkan Anda melakukan salah satu hal berikut:

    • Berikan ID tampilan komposisi dan ambil bagian komposisi yang sesuai yang dimiliki oleh partner yang memberikan otorisasi atas permintaan tersebut, jika bagian tersebut ada.
    • Berikan ID bagian komposisi yang dimiliki oleh partner konten dan ambil daftar semua tampilan komposisi yang ditautkan ke bagian tersebut.

  • Panduan Mengelola aset komposisi yang baru menjelaskan cara berbagai metode API menangani permintaan, bergantung pada apakah ID aset yang dikirimkan ke metode tersebut mengidentifikasi tampilan komposisi atau bagian komposisi.

  • Properti claimedVideoOptions.autoGeneratedBreaks baru di resource contentOwnerAdvertisingOptions menunjukkan apakah YouTube harus otomatis membuat jeda iklan di video yang diklaim dan berdurasi lebih dari 10 menit. Meskipun properti ini memengaruhi semua video pemilik konten yang berdurasi lebih dari 10 menit, jika video memiliki beberapa klaim, partner pertama yang mengklaim video akan menetapkan perilaku default untuk properti ini sehubungan dengan video tersebut.

11 Agustus 2016

Update ini berisi perubahan berikut:

  • Persyaratan Layanan untuk Layanan YouTube API ("Persyaratan yang Diperbarui") yang baru dipublikasikan, yang dibahas secara mendetail di Blog YouTube Engineering and Developers, memberikan serangkaian pembaruan yang lengkap 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 diikuti developer.

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

31 Mei 2016

Update ini berisi perubahan berikut:

  • Referensi dan metode baru

    • Metode validator.validate baru memungkinkan Anda menentukan apakah file metadata berisi error validasi yang akan mencegah YouTube memprosesnya dengan sukses. Jika file berisi error, properti errors respons API akan berisi daftar error validasi, yang mengidentifikasi tingkat keparahan, penyebab, dan lokasi setiap error.

  • Error baru dan yang diperbarui

    • Metode assets.patch dan assets.update kini mendukung error berikut. Sebagai pengingat, metode dapat mendukung beberapa error yang memiliki jenis error yang sama. Lihat dokumentasi error untuk setiap metode atau halaman error untuk mengetahui daftar lengkap kemungkinan error.

      Error
      invalidValue (400) parameters.assetId
      Permintaan gagal karena aset yang diperbarui telah digabungkan dengan aset lain. Kirim ulang permintaan menggunakan ID aset tersebut, yang ditampilkan dalam pesan error, sebagai nilai parameter assetId.

28 Maret 2016

Update ini berisi perubahan berikut:

  • Pembaruan pada resource dan metode yang ada

    • Properti matchInfo.matchSegments[] baru resource claim berisi daftar yang setiap itemnya menjelaskan segmen video yang diklaim yang cocok dengan bagian video referensi. Klaim dapat memiliki beberapa segmen pencocokan. Misalnya, jika konten audio dan video dari video yang diupload cocok dengan konten video referensi, akan ada dua segmen kecocokan. Satu segmen akan menjelaskan kecocokan audio dan segmen lainnya akan menjelaskan kecocokan video.

      Untuk setiap segmen pencocokan, API menampilkan durasi dan jenis (audio atau video) konten yang cocok. API ini juga mengidentifikasi selisih waktu saat setiap segmen kecocokan dimulai dan berakhir di video yang diklaim dan video referensi.

    • Nilai properti claimedVideoOptions.newVideoDefaults[] resource contentOwnerAdvertisingOptions kini dapat diperbarui saat Anda memanggil metode contentOwnerAdvertisingOptions.patch atau contentOwnerAdvertisingOptions.update.

    • Properti allowedOptions.autoGeneratedBreaks hanya baca resource contentOwnerAdvertisingOptions tidak digunakan lagi.

  • Error baru dan yang diperbarui

    • Metode claims.update API kini mendukung error berikut. Sebagai pengingat, metode dapat mendukung beberapa error yang memiliki jenis error yang sama. Lihat dokumentasi error untuk setiap metode atau halaman error untuk mengetahui daftar lengkap kemungkinan error.

      Error
      badRequest (400) alreadyClaimed
      Klaim tersebut merupakan duplikat dari klaim lain yang sudah ada dan tidak dapat diperbarui.

    • Metode assets.list terkadang habis waktu tunggunya dan menampilkan kode respons HTTP 500 (Internal Server Error), terutama saat permintaan mengambil data untuk banyak aset dan nilai parameter fetchMatchPolicy adalah effective. Jika permintaan assets.list Anda menentukan beberapa ID aset dan menampilkan error 500, coba kirim ulang permintaan untuk satu aset atau sejumlah kecil aset.

    • Dokumentasi error references.insert telah diperbarui untuk menunjukkan bahwa jika permintaan mengupload file referensi yang rusak, masalah tersebut tidak akan diidentifikasi hingga referensi itu sendiri diproses. Jadi, meskipun permintaan references.insert menampilkan respons yang berhasil, referensi mungkin tidak berhasil diproses. Sebaiknya, setelah menyisipkan referensi, Anda melakukan polling menggunakan metode references.list untuk mengonfirmasi bahwa referensi diaktifkan seperti yang diharapkan.

3 Februari 2016

Update ini berisi perubahan berikut:

  • Pembaruan pada resource dan metode yang ada

    • API ini kini mendukung iklan listingan produk. Iklan listingan produk menyoroti produk yang terkait dengan atau ditampilkan dalam konten video. Iklan ini adalah kartu bersponsor yang ditampilkan selama video diputar. Kartu tersebut otomatis ditambahkan oleh sistem iklan. Penonton akan melihat teaser untuk kartu tersebut selama beberapa detik, dan dapat pula mengklik ikon di pojok kanan atas video untuk mengakses kartu video.

      Akibat perubahan ini, product_listing kini dapat disertakan dalam nilai properti berikut:

      Metode API/resource Properti
      contentOwnerAdvertisingOptions allowedOptions.licAdFormats[]
      contentOwnerAdvertisingOptions allowedOptions.ugcAdFormats[]
      contentOwnerAdvertisingOptions claimedVideoOptions.newVideoDefaults[]
      videoAdvertisingOptions adFormats[]
      videoAdvertisingOptions.getEnabledAds countriesRestriction[].adFormats[]

    • createdBefore dan createdAfter baru metode assetSearch.list menginstruksikan API untuk hanya menampilkan aset yang dibuat sebelum dan/atau setelah tanggal tertentu.

    • Dalam respons API terhadap permintaan assetSearch.list, properti type kini mendukung nilai art_track_video. Pusat Bantuan YouTube menyediakan informasi selengkapnya tentang video trek gambar album.

    • Metode claimSearch.list mendukung parameter baru berikut:

      Parameter
      referenceId Parameter filter ini menentukan ID referensi YouTube dari referensi yang klaimnya Anda ambil.
      inactiveReasons Parameter opsional ini memungkinkan Anda membatasi respons API agar hanya menyertakan klaim tidak aktif berdasarkan alasan yang ditentukan mengapa klaim menjadi tidak aktif. Definisi parameter mencantumkan jenis klaim tidak aktif yang dapat Anda telusuri.
      partnerUploaded Parameter Boolean opsional ini memungkinkan Anda menentukan bahwa respons API hanya boleh menyertakan klaim yang diupload oleh partner atau yang tidak diupload oleh partner.

    • Objek references#origination baru resource reference berisi informasi yang menjelaskan sumber referensi.

    • Metode references.insert kini mendukung kemampuan untuk mengupload referensi yang dihasilkan menggunakan software gfp_gen YouTube. Jika Anda memberikan sidik jari yang telah dibuat sebelumnya, tetapkan nilai properti fpDirect ke true di resource reference yang diupload.

      Perhatikan bahwa dengan perubahan ini, API tidak lagi menampilkan error jika Anda mencoba menetapkan properti fpDirect saat mengupload referensi.

  • Error baru dan yang diperbarui

    Dokumentasi kini mencantumkan error yang ditampilkan oleh metode resource whitelist.

    Selain itu, tabel berikut mengidentifikasi error baru yang didukung API dan metode yang dapat menampilkan setiap error. Perhatikan bahwa metode dapat menampilkan beberapa error yang memiliki jenis error yang sama. Lihat dokumentasi error untuk setiap metode atau halaman error untuk mengetahui informasi selengkapnya.

    Error
    badRequest (400) inappropriateCampaignTarget
    Metode campaigns.insert dan campaigns.update menampilkan error ini jika kampanye mencoba menampilkan video yang mungkin tidak pantas untuk beberapa pengguna. Untuk mengatasi error ini, pilih konten lain untuk ditampilkan.
    badRequest (400) canNotCreatePartnerUploadedClaimOnCompositionOrSoundRecordingAssets
    Metode claims.insert menampilkan error ini jika Anda mencoba membuat klaim yang diupload partner dengan aset komposisi atau rekaman suara.
    badRequest (400) existingSoundRecordingOrMusicVideoClaim
    Metode claims.insert menampilkan error ini jika klaim sudah ada untuk musik yang direkam di video yang ditentukan. Klaim komposisi langsung tidak dapat ditambahkan melalui API.
    badRequest (400) asset_id
    Metode references.insert menampilkan error ini jika permintaan mencoba membuat referensi melalui file, tetapi permintaan tidak menentukan assetId.
    badRequest (400) canNotBeActivated
    Metode references.update menampilkan error ini jika referensi tidak dapat diaktifkan, mungkin karena status referensi atau kondisi kepemilikan.
    badRequest (400) videoNotClaimed
    Metode videoAdvertisingOptions.get menampilkan error ini jika Anda belum mengklaim video yang opsi iklannya ingin Anda ambil, sehingga informasi yang diminta tidak tersedia untuk Anda.

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 di Persyaratan Layanan YouTube API.

21 April 2015

Update ini berisi perubahan berikut:

30 Maret 2015

Update ini berisi perubahan berikut:

  • Pembaruan pada resource dan metode yang ada

    • Parameter isrcs baru metode assetSearch.list memungkinkan Anda menentukan daftar hingga 50 ISRC. Respons API akan menyertakan aset yang terkait dengan ISRC tersebut.

    • Properti event[].reason resource claimHistory mendukung nilai baru berikut. Setiap alasan menjelaskan mengapa peristiwa tertentu yang terkait dengan klaim terjadi:

      • closed_audio_claim_on_visual_reference
      • closed_partner_exclusion
      • closed_reference_conflict

    • Parameter sort baru metode claimSearch.list menentukan metode yang akan digunakan untuk mengurutkan resource dalam respons API. Secara default, resource diurutkan dalam urutan kronologis terbalik (dari yang terbaru ke yang terlama) berdasarkan tanggal pembuatannya. Anda juga dapat mengurutkan referensi dari jumlah penayangan tertinggi ke terendah untuk konten yang diklaim.

      Perhatikan bahwa jika permintaan claimSearch.list juga menetapkan parameter value status ke appealed, disputed, pending, potential, atau routedForReview, hasil akan diurutkan berdasarkan waktu berakhirnya periode peninjauan klaim.

    • Metode ownership.update dan ownership.patch kini mencantumkan semua properti yang dapat diperbarui dengan benar saat memanggil metode ini. Perubahan ini merupakan koreksi pada dokumentasi API dan tidak mengidentifikasi perubahan pada fungsi API.

    • Parameter fetchMatchPolicy untuk metode assets.get dan assets.list kini mencantumkan effective sebagai nilai yang didukung. Nilai ini menginstruksikan server API untuk mengambil kebijakan kecocokan yang diterapkan YouTube untuk aset.

    • Parameter id untuk metode assets.list, claims.list, contentOwners.list, policies.list, publishers.list, dan references.list kini mencatat bahwa nilai parameternya dapat berisi maksimum 50 ID yang dipisahkan koma.

  • Error baru dan yang diperbarui

    Tabel di bawah ini mengidentifikasi error baru yang didukung API dan metode yang dapat menampilkan setiap error. Perhatikan bahwa metode dapat menampilkan beberapa error yang memiliki jenis error yang sama.

    Lihat dokumentasi error untuk setiap metode atau halaman error untuk mengetahui informasi selengkapnya.

    Jenis error Detail error Deskripsi
    badRequest (400) tooManyIsrcs Metode assetSearch.list menampilkan error ini jika parameter isrcs menentukan lebih dari 50 ISRC.
    badRequest (400) videoIsPrivate Metode claims.insert menampilkan error ini jika Anda mencoba mengklaim video pribadi. Anda hanya dapat mengklaim video jika status privasinya adalah public atau unlisted.
    notModified (304) blockOutsideOwnershipUnchanged Metode claims.update menampilkan error ini jika tanda blockOutsideOwnership pada klaim tidak berhasil diubah. Ada beberapa alasan mengapa error ini dapat terjadi. Contohnya adalah karena modifikasi yang ditentukan tidak memengaruhi video yang diklaim.

7 November 2014

Update ini berisi perubahan berikut:

  • Pembaruan pada resource dan metode yang ada

    • Parameter status metode claimSearch.list kini mendukung nilai routedForReview. Nilai ini membatasi hasil pada klaim yang memerlukan peninjauan manual berdasarkan aturan dalam kebijakan kecocokan aset.

    • Properti event[].reason resource claimHistory mendukung nilai baru berikut. Setiap alasan menjelaskan mengapa peristiwa tertentu yang terkait dengan klaim terjadi:

      • closed_invalid_reference_segment
      • closed_noadsense
      • suspended_monetization_on_channel
      • video_content_modified

    • Properti origin.source resource claim, yang mengidentifikasi sumber klaim, kini mendukung nilai melodyMatch. Klaim kecocokan melodi menunjukkan bahwa video yang diklaim memiliki komposisi musik yang sama dengan referensi.

    • Dokumentasi metode references.insert telah diperbarui untuk mencerminkan dengan benar bahwa API menggunakan dua endpoint yang berbeda untuk metode tersebut. Hal ini tidak menunjukkan perubahan pada fungsi API, melainkan koreksi pada dokumentasi yang ada.

      • Jika permintaan mengupload file referensi baru, endpoint yang benar adalah:

        POST https://www.googleapis.com/upload/youtube/partner/v1/references

      • Jika permintaan membuat referensi menggunakan video yang diklaim sebagai konten referensi, endpoint yang benar adalah:

        POST https://www.googleapis.com/youtube/partner/v1/references

  • Error baru dan yang diperbarui

    Tabel di bawah ini mengidentifikasi error baru yang didukung API dan metode yang dapat menampilkan setiap error. Perhatikan bahwa metode dapat menampilkan beberapa error yang memiliki jenis error yang sama.

    Lihat dokumentasi error untuk setiap metode atau halaman error untuk mengetahui informasi selengkapnya.

    Jenis error Detail error Deskripsi
    badRequest (400) invalidLabelName Metode assets.insert, assets.update, dan assetLabels.insert menampilkan error ini jika nama label aset tidak valid. Nama label harus terdiri dari dua hingga 30 karakter. Nama label tidak boleh berisi tanda kurung siku, koma, titik dua, tanda dan, atau karakter pipa vertikal (|).
    badRequest (400) ownerHaveMaximumNumberOfLabels Metode assets.insert, assets.update, dan assetLabels.insert menampilkan error ini jika pemilik konten telah menentukan 2.500 label aset unik, yang merupakan jumlah maksimum yang saat ini diizinkan.
    badRequest (400) tooManyLabelsOnOneAsset Metode assets.insert dan assets.update menampilkan error ini jika aset sudah dikaitkan dengan 30 label aset, yang merupakan jumlah maksimum yang saat ini diizinkan.
    badRequest (400) channelMonetizationSuspended Metode claims.insert dan claims.update menampilkan error ini jika channel video ditangguhkan karena klaim partner.
    badRequest (400) channelNotActive Metode claims.update menampilkan error ini jika channel video tidak aktif.

  • Metode assets.insert dan assets.update tidak lagi menampilkan error badRequest untuk beberapa aset jika resource dalam isi permintaan tidak berisi properti metadataMine.contentType.

23 September 2014

Update ini berisi perubahan berikut:

  • Perubahan ID Pemilik Konten

    Perubahan ID pemilik konten yang diumumkan dalam histori revisi pada 9 Juli 2014 telah mulai berlaku. Akibat perubahan ini, API kini menampilkan ID unik yang dihasilkan untuk mengidentifikasi pemilik konten yang terkait dengan pengguna yang diautentikasi atau resource yang dikelola melalui API. Sebelumnya, API menampilkan nama yang dapat dibaca manusia sebagai ID, seperti "qrs_network".

    Perubahan ini memengaruhi fungsi API berikut dan kemungkinan akan memengaruhi partner yang memiliki Kode Partner yang di-hardcode dalam aplikasi mereka.

    • API kini menampilkan ID baru sebagai nilai properti resource yang sebelumnya menampilkan Kode Partner, seperti properti id resource contentOwner.
    • Semua metode API mendukung parameter onBehalfOfContentOwner, yang mengidentifikasi pemilik konten yang atas namanya permintaan API dibuat. Setelah perubahan ini, parameter harus ditetapkan ke ID baru, bukan Kode Partner. Untuk mencegah kerusakan kode, parameter akan menerima salah satu nilai selama periode transisi.
    • Setelah perubahan ini, parameter contentOwnerId metode contentOwners.list harus menentukan ID baru, bukan Kode Partner.

  • Pembaruan pada resource dan metode yang ada

    • Parameter metadataSearchFields baru metode assetSearch.list memungkinkan Anda menentukan kolom metadata aset yang ingin ditelusuri serta nilai yang ingin ditelusuri di kolom tersebut. Nilai parameter adalah daftar pasangan kolom dan nilai yang dipisahkan koma; dalam pasangan, kolom dan nilai dipisahkan dengan titik dua.

    • Objek appliedPolicy baru dari resource claim menentukan kebijakan yang sebenarnya diterapkan YouTube untuk klaim tersebut. Nilai objek adalah resource policy. Referensi tersebut berisi informasi kebijakan untuk negara tempat pemilik konten yang mengirimkan permintaan memiliki aset yang diklaim.

      Kebijakan yang diterapkan dapat berbeda dari kebijakan yang ditentukan pemilik konten dengan dua cara:

      1. Kebijakan ini memperhitungkan kebijakan yang ditetapkan oleh pemilik lain yang memiliki kepemilikan sebagian atas aset yang diklaim di beberapa wilayah yang sama dengan pemilik konten yang mengirimkan permintaan API.

      2. Kebijakan ini memperhitungkan kebijakan administratif YouTube yang berlaku di wilayah tempat pemilik konten memiliki aset yang diklaim.

    • Properti uploaderChannelId baru resource claimHistory mengidentifikasi ID channel tempat video yang diklaim diupload.

8 September 2014

Update ini berisi perubahan berikut:

  • Referensi dan metode baru

    • Resource assetLabel baru mengidentifikasi label teks yang dapat ditetapkan ke aset. Label aset memungkinkan Anda menempatkan aset ke dalam kategori kustom, sehingga mempermudah pengaturan daftar aset. Anda dapat menelusuri aset berdasarkan labelnya, yang juga akan memudahkan penggunaan yang mengharuskan Anda memperbarui grup aset khusus.

      • Metode assetLabels.list memungkinkan Anda mengambil daftar label pemilik konten.
      • Metode assetLabels.insert memungkinkan Anda membuat label aset baru. Anda juga dapat membuat label baru dengan memanggil metode assets.update dan memperbarui label untuk aset. Server API akan otomatis membuat resource assetLabel baru untuk label yang belum ditentukan sebelumnya.

  • Pembaruan pada resource dan metode yang ada

    • Properti label[] resource asset telah diperbarui untuk menunjukkan bahwa Anda dapat memanggil metode assets.update untuk memperbarui label aset. Namun, Anda tidak dapat menetapkan label aset saat memanggil metode assets.insert.

      Panduan Menggunakan Label Aset yang baru menjelaskan cara membuat dan mengambil label aset serta cara memperbarui label aset atau menelusuri aset yang terkait dengan label tertentu.

  • Error baru dan yang diperbarui

    API mendukung beberapa error baru untuk metode assetLabels.list dan assetLabels.insert baru.

9 Juli 2014

Update ini berisi perubahan berikut:

  • Perubahan ID Pemilik Konten

    Secara historis, API telah menggunakan Kode Partner yang dapat dibaca manusia, seperti "qrs_network", untuk mengidentifikasi pemilik konten secara unik yang terkait dengan pengguna yang diautentikasi atau resource yang dikelola melalui API. Pada Kuartal 3 2014, API akan beralih untuk menggunakan ID unik 22 karakter untuk mengidentifikasi pemilik konten. Perubahan ini memengaruhi fungsi API berikut dan kemungkinan akan memengaruhi partner yang memiliki Kode Partner yang di-hardcode di aplikasi mereka.

    • API akan menampilkan ID 22 karakter sebagai nilai properti resource yang sebelumnya menampilkan Kode Partner, seperti properti id resource contentOwner.
    • Semua metode API mendukung parameter onBehalfOfContentOwner, yang mengidentifikasi pemilik konten yang atas namanya permintaan API dibuat. Setelah perubahan ini, parameter harus ditetapkan ke ID 22 karakter, bukan Kode Partner. Untuk mencegah kerusakan kode, parameter akan menerima salah satu nilai selama periode transisi.
    • Setelah perubahan ini, parameter contentOwnerId metode contentOwners.list harus menentukan ID 22 karakter, bukan Kode Partner.

  • Pembaruan pada resource dan metode yang ada

    • Resource asset kini mendukung properti label, yang menentukan daftar label aset yang terkait dengan aset. Anda dapat menerapkan label ke beberapa aset untuk mengelompokkannya Anda dapat menggunakan label sebagai filter penelusuran untuk melakukan pembaruan massal, mendownload laporan, atau memfilter YouTube Analytics.

    • Metode assetSearch.list kini mendukung parameter opsional berikut:

      • labels: Membatasi hasil agar hanya menyertakan aset yang terkait dengan label yang ditentukan. Secara default, API menampilkan aset yang cocok dengan semua label yang ditentukan. Namun, Anda dapat menggunakan parameter includeAnyProvidedLabel untuk menginstruksikan API agar menampilkan aset yang cocok dengan salah satu label yang ditentukan.
      • includeAnyProvidedLabel: Digunakan bersama dengan parameter labels, parameter ini menginstruksikan API untuk menampilkan aset yang terkait dengan label apa pun yang ditentukan dalam nilai parameter labels.

    • Resource claimHistory kini berisi properti baru berikut:

    • Metode claimSearch.list kini mendukung parameter opsional berikut:

      • createdAfter: Membatasi hasil hanya untuk menyertakan klaim yang dibuat setelah tanggal yang ditentukan.
      • createdBefore: Membatasi hasil agar hanya menyertakan klaim yang dibuat sebelum tanggal yang ditentukan.
      • includeThirdPartyClaims: Digunakan bersama dengan parameter videoId, parameter ini menunjukkan apakah akan menyertakan klaim pihak ketiga dalam hasil API.

  • Informasi error yang lebih mendetail

    Dokumentasi error kini menentukan kode respons HTTP untuk setiap jenis error.

  • Error baru dan yang diperbarui

    Tabel di bawah ini mengidentifikasi error baru yang didukung API dan metode yang dapat menampilkan setiap error. Perhatikan bahwa metode dapat menampilkan beberapa error yang memiliki jenis error yang sama. Misalnya, error required ditampilkan jika Anda mencoba menyisipkan resource asset yang tidak memiliki kolom metadata yang diperlukan. Bahkan, mungkin ada lebih dari satu kolom metadata yang diperlukan, yang masing-masing akan menampilkan error dengan pesan yang sedikit berbeda.

    Lihat dokumentasi error untuk setiap metode atau halaman error untuk mengetahui informasi selengkapnya.

    Metode Error
    assetSearch.list
    • invalidValue – API tidak mendukung kemampuan untuk menelusuri aset acara atau season. Ubah nilai parameter type menjadi nilai yang didukung.
    assets.insert
    • conflict – Terlalu banyak aset dengan ID yang sama (misalnya, ID kustom, ISRC, dll.) yang sudah ada.
    • conflict – Terlalu banyak salinan aset yang ditentukan yang sudah ada.
    • invalidValue – Pengguna yang memanggil API tidak memiliki izin untuk membuat aset dari jenis yang ditentukan.
    assets.patch
    assets.update
    • badRequest – API tidak mendukung konversi jenis aset yang telah Anda coba.
    claimSearch.list
    ownership.patch
    ownership.update
    • badRequest – Anda tidak dapat memperbarui kepemilikan aset trek gambar album.
    references.patch
    references.update
    • badRequest – Referensi dalam status tidak valid untuk operasi yang Anda coba.

3 Februari 2014

Update ini berisi perubahan berikut:

  • Pembaruan pada resource dan metode yang ada

    • Resource asset kini dapat memiliki nilai type art_track_video.

    • Resource claimSearch kini menyertakan properti baru berikut:

      • Objek origin berisi informasi yang menjelaskan cara pembuatan klaim.
      • Properti thirdPartyClaim berisi nilai Boolean yang menunjukkan apakah klaim dibuat oleh pemilik konten selain yang terkait dengan pengguna yang melakukan penelusuran.

    • Metode claimSearch.list kini mendukung parameter opsional berikut:

      • contentType: Membatasi hasil agar hanya menyertakan klaim khusus audio, klaim khusus video, atau klaim audiovisual.
      • origin: Menentukan satu atau beberapa asal klaim, seperti descriptiveSearch atau videoMatch, yang klaimnya ingin Anda temukan.
      • status: Membatasi hasil agar hanya menyertakan klaim yang memiliki status yang ditentukan.

    • Properti status resource claim kini mendukung nilai tambahan berikut: appealed, disputed, potential, takedown, dan unknown.

    • Properti blockOutsideOwnership baru dari resource claim menunjukkan apakah video yang diklaim harus diblokir di wilayah tempat video tersebut tidak dimiliki secara eksplisit. Secara default, video yang diklaim akan tetap dapat ditonton di negara tempat data kepemilikan belum ditentukan untuk aset yang terkait dengan klaim tersebut.

    • Properti allowedOptions.autoGeneratedBreaks baru di resource contentOwnerAdvertisingOption menunjukkan apakah partner dapat memilih untuk menampilkan iklan mid-roll, in-stream pada waktu jeda yang ditentukan secara otomatis oleh YouTube.

    • Metode contentOwners.list kini dapat dipanggil dengan token otorisasi yang menentukan cakupan https://www.googleapis.com/auth/youtubepartner-content-owner-readonly.

    • Properti timeUpdated baru resource policy menentukan waktu saat kebijakan terakhir diperbarui.

    • Metode policies.list kini mendukung parameter sort opsional, yang dapat digunakan untuk menentukan bahwa hasil harus diurutkan dalam urutan menaik atau menurun berdasarkan waktu terakhir kali diperbarui.

    • Properti expiryTime baru dari resource referenceConflict menentukan waktu berakhirnya periode peninjauan untuk konflik referensi, sehingga konflik akan berakhir.

    • Properti autoGeneratedBreaks baru di resource videoAdvertisingOption menunjukkan apakah video harus menampilkan iklan mid-roll, in-stream pada waktu jeda yang ditentukan secara otomatis oleh YouTube.

  • Error baru dan yang diperbarui

    Tabel di bawah ini mengidentifikasi error baru yang didukung API dan metode yang dapat menampilkan setiap error. Perhatikan bahwa metode dapat menampilkan beberapa error yang memiliki jenis error yang sama. Misalnya, error required ditampilkan jika Anda mencoba menyisipkan resource asset yang tidak memiliki kolom metadata yang diperlukan. Bahkan, mungkin ada lebih dari satu kolom metadata yang diperlukan, yang masing-masing akan menampilkan error dengan pesan yang sedikit berbeda.

    Lihat dokumentasi error untuk setiap metode atau halaman error untuk mengetahui informasi selengkapnya.

    Metode Error
    assets.insert
    assets.update
    • badRequest – API tidak mendukung operasi tulis pada aset gambar album.
    claimSearch.list
    • invalidValue – Parameter pageToken dalam permintaan menentukan token halaman yang tidak valid.
    claims.insert
    • badRequest – Klaim yang Anda coba buat tidak valid karena channel video tidak aktif.
    • badRequest – Video yang Anda coba klaim dikecualikan dari kebijakan penghapusan. Untuk pertanyaan, hubungi copyright@youtube.com
    • badRequest – Permintaan Anda tidak dapat diproses karena Anda tidak dapat membuat klaim pihak ketiga pada video yang ditentukan.
    • conflict – YouTube tidak dapat membuat klaim yang diminta karena video tersebut telah menanggapi permintaan penghapusan.
    • conflict – YouTube tidak dapat membuat klaim yang diminta karena video tersebut memiliki klaim penghapusan yang aktif.
    references.insert
    • badRequest – Video yang diklaim yang Anda coba gunakan telah dihapus atau ditolak, atau pemrosesannya gagal.

  • Error contentOwnerNotProvided dan internalError, yang tidak spesifik untuk metode API tertentu, tidak lagi tercantum di setiap halaman metode. Deskripsinya masih dapat ditemukan di bagian Error umum dalam dokumentasi error API.

12 September 2013

Update ini berisi perubahan berikut:

  • Referensi dan metode baru

    • Resource referenceConflict baru mengidentifikasi konflik antara dua file referensi dan mencantumkan kecocokan yang ada di antara file tersebut saat konflik diidentifikasi. Metode referenceConflicts.list memungkinkan Anda mengambil daftar konflik referensi yang belum terselesaikan yang terkait dengan pemilik konten resmi. Metode referenceConflicts.get memungkinkan Anda mengambil konflik referensi dengan menentukan ID konflik referensi uniknya.

    Pembaruan pada resource dan metode yang ada

    • API ini kini mendukung kemampuan untuk mengambil kebijakan kecocokan yang efektif untuk aset. Perubahan ini sejalan dengan perubahan yang dirilis pada 16 Juli 2013, yang mencakup dukungan untuk mengambil kumpulan metadata dan data kepemilikan kanonis untuk aset.

      Untuk mengambil kebijakan pencocokan yang efektif untuk aset, tetapkan parameter value fetchMatchPolicy ke effective saat memanggil metode assets.get atau assets.list. Dalam respons API, objek matchPolicyEffective di setiap resource asset yang ditampilkan berisi kebijakan kecocokan yang efektif untuk aset tersebut.

    • Objek ownershipConflicts baru resource asset berisi informasi tentang konflik kepemilikan aset. Struktur objek mirip dengan struktur resource ownership, yang mengidentifikasi setiap jenis hak yang dapat dimiliki pemilik aset. (Untuk sebagian besar jenis aset, pemilik hanya dapat memiliki kepemilikan aset umum, tetapi untuk aset komposisi, pemilik dapat mencantumkan kepemilikan hak pertunjukan, hak sinkronisasi, atau hak mekanis.)

      Demikian pula, objek ownershipConflicts berisi daftar terpisah yang mengidentifikasi konflik untuk hak kepemilikan umum, hak pertunjukan, hak sinkronisasi, dan hak mekanis. Untuk setiap konflik, data mengidentifikasi wilayah tempat konflik terjadi, pemilik yang telah memberikan data kepemilikan yang bertentangan, dan persentase aset yang diklaim dimiliki oleh setiap pemilik yang berkonflik.

    • Metode assets.get dan assets.get kini mendukung parameter fetchOwnershipConflicts baru. Parameter ini memiliki nilai boolean yang menunjukkan apakah permintaan API harus mengambil konflik kepemilikan untuk aset dalam respons API. Nilai defaultnya adalah false, yang berarti konflik kepemilikan tidak ditampilkan.

    • Definisi parameter q metode assetSearch.list telah diperbarui untuk mengidentifikasi kolom metadata yang ditelusuri YouTube.

    • Dokumentasi isi permintaan untuk metode references.insert kini menunjukkan bahwa Anda harus menetapkan nilai properti contentType. Perubahan ini memperbarui dokumentasi untuk mencerminkan fungsi API yang sebenarnya dengan benar, tetapi tidak mewakili perubahan pada fungsi API.

  • Error baru dan yang diperbarui

    • API mendukung error forbidden baru, yang tidak spesifik untuk metode tertentu, yang menunjukkan bahwa operasi yang diminta tidak dapat diotorisasi oleh akun layanan.

    • Metode assets.insert kini mengidentifikasi error metadata yang terjadi di properti dalam objek metadataMine, bukan di objek metadata, yang tidak digunakan lagi sejak update API pada 16 Juli 2013.

    • Halaman errors telah diperbarui sehingga untuk setiap resource yang mendukung metode update dan patch, halaman tersebut berisi satu tabel yang mencantumkan error yang ditampilkan oleh kedua metode tersebut. Sebelumnya, halaman mencantumkan error untuk setiap metode secara terpisah, meskipun daftarnya selalu sama.

16 Juli 2013

Update ini berisi perubahan berikut:

  • Referensi dan metode baru

    • Metode claimHistory.get baru memungkinkan Anda mengidentifikasi dan mengambil informasi tentang klaim tertentu. Resource claimHistory yang ditampilkan berisi daftar peristiwa yang terkait dengan klaim, seperti klaim yang dibuat, diperbarui, disengketakan, atau ditutup.

    • Metode claimSearch.list baru memungkinkan Anda menelusuri klaim yang memenuhi salah satu atau semua kriteria berikut:

      • Klaim dikaitkan dengan aset tertentu.
      • Klaim dikaitkan dengan video tertentu.
      • Klaim cocok dengan string kueri yang diberikan dalam permintaan.

      Setiap resource claimSnippet dalam respons API berisi detail tentang klaim, termasuk ID klaim unik, status, jenisnya (audio, video, atau audiovisual), serta aset dan video yang terkait dengan klaim tersebut. Referensi ini juga menentukan jumlah penayangan untuk video yang diklaim dan judul video yang diklaim.

  • Pembaruan pada resource dan metode yang ada

    • Dokumentasi kini mencantumkan nilai yang didukung untuk properti yang memiliki serangkaian nilai enumerasi. Properti tersebut mencakup properti type resource asset dan properti status resource claim.

    • Untuk metode assets.get dan assets.list, API kini mendukung nilai yang dipisahkan koma untuk parameter permintaan fetchMetadata dan fetchOwnership, sehingga Anda dapat mengambil beberapa kumpulan metadata atau data kepemilikan.

      Daftar di bawah menjelaskan perubahan yang sesuai pada struktur resource asset serta dampak perubahan tersebut pada metode API yang digunakan resource get, list, insert, update, atau patch asset.

      • Objek metadata tidak digunakan lagi dan diganti dengan objek metadataMine dan metadataEffective. Objek baru memungkinkan resource asset menyertakan kumpulan metadata yang disediakan oleh pemilik konten yang membuat permintaan API serta kumpulan metadata kanonis yang telah ditentukan YouTube sebagai kumpulan metadata yang paling akurat dan lengkap untuk aset.

      • Demikian pula, objek ownership telah diganti dengan objek ownershipMine dan ownershipEffective.

      • Objek matchPolicy telah diganti dengan objek matchPolicyMine. (API saat ini tidak mendukung kemampuan untuk mengambil kebijakan kecocokan yang efektif untuk aset.)

      Catatan: Untuk memastikan kompatibilitas mundur, jika hanya satu versi metadata, satu kumpulan data kepemilikan, atau satu kebijakan kecocokan yang diminta untuk aset, respons API akan menyertakan objek yang tidak digunakan lagi serta objek yang baru didukung. Misalnya, jika permintaan menetapkan parameter fetchMetadata ke mine, respons API akan berisi objek metadata dan objek metadataMine, yang keduanya akan berisi data yang sama. (Kemampuan untuk menetapkan fetchMetadata=mine didukung sebelum update fitur yang memungkinkan Anda mengambil beberapa versi metadata.)

      Namun, jika parameter fetchMetadata ditetapkan ke mine,effective, respons API akan berisi objek metadataMine dan metadataEffective, tetapi tidak akan berisi objek metadata. (Kemampuan untuk menetapkan fetchMetadata=mine,effective tidak didukung sebelum update fitur ini, sehingga tidak perlu menampilkan objek metadata untuk kompatibilitas mundur.) Prinsip yang sama juga berlaku untuk parameter fetchOwnership dan fetchMatchPolicy.

      Demikian pula, untuk kompatibilitas mundur, permintaan ke insert, update, atau patch resource asset dapat menyertakan objek metadataMine atau objek metadata. Prinsip yang sama berlaku untuk menetapkan data kepemilikan atau kebijakan pencocokan resource asset.

    • Parameter assetId, q, dan videoId metode claims.list tidak digunakan lagi. Untuk menelusuri klaim menggunakan salah satu kriteria ini, gunakan metode claimSearch.list, yang mendukung semua parameter tersebut.

    • Dalam resource ownership, nilai properti general[].ratio, performance[].ratio, synchronization[].ratio, dan mechanical[].ratio kini memiliki format konten double, bukan integer.

    • Definisi properti rules[].action resource policy kini mencantumkan nilai yang valid untuk properti tersebut: block, monetize, takedown, dan track. Namun, perlu diperhatikan bahwa Anda tidak dapat menggunakan API untuk menerapkan kebijakan penghapusan pada klaim.

    • Properti claimId baru dari resource reference akan ada jika referensi dibuat dengan mengaitkan aset dengan video YouTube yang ada yang diupload ke channel YouTube yang ditautkan ke akun CMS Anda. Dalam hal ini, kolom ini berisi ID klaim yang mewakili pengaitan yang dihasilkan antara aset dan video.

    • Properti excludedIntervals[] baru dari resource reference menentukan daftar interval waktu selama referensi yang harus diabaikan oleh YouTube saat mencoba mencocokkan referensi. Setiap interval menentukan waktu mulai dan berakhir yang diukur dalam detik dari awal video.

    • API tidak lagi mewajibkan properti status ditetapkan di resource reference yang dikirim dalam isi permintaan references.update atau references.patch.

    • Dokumentasi telah dikoreksi untuk menjelaskan format respons API dengan benar untuk metode videoAdvertisingOptions.getEnabledAds. Respons, yang merupakan resource youtubePartner#videoAdvertisingOptionGetEnabledAds, berisi informasi berikut:

      • id – ID yang digunakan YouTube untuk mengidentifikasi video yang diklaim secara unik dan terkait dengan setelan.

      • adBreaks – Daftar objek yang setiap objeknya berisi informasi tentang titik sebelum, selama, atau setelah pemutaran video saat iklan diizinkan untuk berjalan. Setiap objek juga dapat menentukan atribut lain dari jeda iklan, seperti slot iklan yang terjadi selama jeda dan jenis iklan yang diizinkan untuk berjalan selama setiap slot.

      • adsOnEmbeds – Kolom boolean yang menunjukkan apakah YouTube dapat menampilkan iklan saat video diputar di pemutar tersemat.

      • countriesRestriction – Daftar objek yang setiap objeknya mengidentifikasi daftar wilayah dan format iklan yang digunakan selama pemutaran video di wilayah tersebut.

  • Error baru dan yang diperbarui

    • Tabel di bawah ini mengidentifikasi error baru yang didukung API dan metode yang dapat menampilkan setiap error. Laporan ini juga mengidentifikasi error yang telah berubah. Perhatikan bahwa metode dapat menampilkan beberapa error yang memiliki jenis error yang sama. Misalnya, error required ditampilkan jika Anda mencoba menyisipkan resource asset yang tidak memiliki kolom metadata yang diperlukan. Bahkan, mungkin ada lebih dari satu kolom metadata yang diperlukan, yang masing-masing akan menampilkan error dengan pesan yang sedikit berbeda.

      Lihat dokumentasi error untuk setiap metode atau halaman error untuk mengetahui informasi selengkapnya.

      Metode Error
      assets.insert
      assets.update
      assets.patch
      • Error invalidValue dan required yang sebelumnya dikaitkan dengan properti turunan objek metadata kini dikaitkan dengan properti turunan yang sama di objek metadataMine.
      claimHistory.get
      • notFound – Klaim yang historinya Anda coba ambil tidak dapat ditemukan.
      • required – Permintaan tidak menentukan nilai untuk parameter claimId.
      claimSearch.list
      claims.list
      • badRequest – Permintaan menentukan kriteria yang tidak valid. Paling banyak, salah satu parameter filter berikut dapat ditentukan: q, assetId, videoId.
      claims.insert
      • badRequest – Klaim yang Anda coba buat tidak valid karena pemilik konten yang diminta bukan pemilik aset yang terkait dengan klaim tersebut.
      • badRequest – Pemilik konten yang Anda wakili tidak memiliki izin untuk membuat kebijakan dengan tindakan yang ditentukan.
      • invalidValue – Pemilik konten yang Anda wakili tidak memiliki izin untuk mengklaim video yang diupload pengguna melalui API.
      contentOwners.list
      • badRequest – Permintaan menentukan kriteria yang tidak valid. Salah satu parameter filter berikut harus ditentukan: fetchMine, id. (Sebelumnya, error mencantumkan kumpulan parameter filter yang berbeda – has_conflicts_with, restrict_to_user, name_prefix, dan id.)
      ownership.update
      ownership.patch
      • badRequest – Permintaan yang memperbarui data kepemilikan aset komposisi harus menentukan data kepemilikan terperinci &ndahs; hak mechanical, performance, synchronization, dan/atau lyric – bukan hak kepemilikan general. Jenis hak lyric baru didukung.
      policies.insert
      policies.update
      policies.patch
      • invalidValue – Permintaan berisi aturan kebijakan yang tidak valid karena API tidak mendukung pembuatan atau perubahan kebijakan yang menentukan tindakan takedown. Error ini, yang melaporkan alasan invalidPolicyTakedownAction, menggantikan error invalidPolicyConditionalTakedown yang tidak digunakan lagi.
      references.insert
      • badRequest – Permintaan harus mengirim file media atau menentukan nilai untuk parameter permintaan claimId. Namun, permintaan tidak boleh mengirim file media dan menentukan nilai untuk parameter permintaan claimId.
      • badRequest – Referensi untuk konten yang sama telah dibuat dari klaim lain di video YouTube yang sama.
      • badRequest – API tidak mendukung kemampuan untuk menetapkan nilai untuk properti fpDirect saat membuat referensi.
      • internalError – Ada masalah dengan file media yang diupload.
      • invalidValue – Nilai parameter permintaan contentType, assetId, atau claimId tidak valid. Error ini mengidentifikasi nilai yang tidak valid.
      • notFound – Aset atau klaim yang Anda tentukan tidak dapat ditemukan. Periksa nilai parameter assetId dan claimId dalam permintaan Anda.
      • required – Permintaan harus menentukan nilai untuk parameter contentType.
      references.insert
      references.update
      references.patch
      • invalidValue – excludedIntervals yang ditentukan untuk referensi tidak valid. Perhatikan bahwa Anda tidak dapat menentukan interval pengecualian saat menonaktifkan referensi.

10 Mei 2013

Update ini berisi perubahan berikut:

8 April 2013

Update ini berisi perubahan berikut:

  • API ini telah diganti namanya menjadi YouTube Content ID API.

  • Beberapa properti telah berubah di resource assetMatchPolicy:

    • Nilai properti kind telah diubah dari youtubePartner#policy menjadi youtubePartner#assetMatchPolicy.
    • Properti policyId baru berisi nilai yang secara unik mengidentifikasi resource kebijakan tersimpan.
    • Nilai properti rules[].subaction kini berupa daftar string, bukan string.
    • Nilai properti rules[].conditions.contentMatchType kini berupa daftar string, bukan string.
    • Properti id, name, dan description telah dihapus.

  • Dokumentasi untuk metode assetMatchPolicy.update telah diperbarui untuk mencerminkan fakta bahwa Anda dapat menetapkan nilai untuk properti policyId atau objek rules[] saat memanggil metode.

  • Resource claims kini mendukung beberapa properti baru:

    Nama properti Nilai Deskripsi
    timeCreated datetime Tanggal dan waktu klaim dibuat.
    matchInfo object Objek matchInfo berisi informasi tentang konten yang cocok yang menghasilkan klaim. Informasi ini hanya disertakan dalam resource claim jika klaim dibuat secara otomatis karena video yang diupload cocok dengan file referensi yang ada.
    matchInfo.referenceId string ID unik yang digunakan YouTube untuk mengidentifikasi reference referensi yang menghasilkan kecocokan.
    matchInfo.longestMatch object Objek longestMatch berisi informasi tentang kecocokan terpanjang antara referensi dan video yang diupload.
    matchInfo.longestMatch.durationSecs unsigned long Durasi kecocokan, dalam detik.
    matchInfo.longestMatch.userVideoOffset unsigned long Selisih waktu saat kecocokan dimulai, diukur dalam detik dari awal video yang diupload.
    matchInfo.longestMatch.referenceOffset unsigned long Offset waktu saat pencocokan dimulai, diukur dalam detik dari awal referensi.
    matchInfo.totalMatch object Objek totalMatch berisi informasi tentang jumlah total video yang diupload yang cocok dengan referensi dan jumlah total referensi yang cocok dengan video yang diupload. Nilai ini dapat berbeda jika konten yang cocok berjalan dalam loop di video yang diupload atau referensi. Misalnya, jika video yang diupload menyertakan klip berdurasi 10 detik dari referensi, tetapi klip tersebut diulang enam kali, total konten yang cocok dalam video yang diupload adalah 60 detik, tetapi total konten yang cocok dalam referensi hanya 10 detik.
    matchInfo.totalMatch.userVideoDurationSecs unsigned long Total durasi, dalam detik, konten video yang diupload yang cocok dengan referensi.
    matchInfo.totalMatch.referenceDurationSecs unsigned long Total durasi, dalam detik, konten referensi yang cocok dengan video yang diupload.
    origin object Objek origin berisi informasi yang menjelaskan sumber klaim.
    origin.source string Sumber klaim.

  • Properti policy di resource claims telah diperbarui untuk menunjukkan bahwa nilai tidak dapat diperbarui untuk klaim AudioSwap.

  • Properti timeProvidedMs resource metadataHistory telah diganti namanya menjadi timeProvided.

  • Properti timeProvidedMs resource ownershipHistory telah diganti namanya menjadi timeProvided.

  • Definisi metode ownershipHistory.list telah diperbarui untuk menunjukkan bahwa metode ini hanya mengambil data kepemilikan terbaru untuk setiap pemilik konten. Namun, jika pemilik konten telah mengirimkan data kepemilikan melalui beberapa sumber data (API, feed konten, dll.), daftar tersebut akan berisi data terbaru untuk setiap pemilik konten dan sumber data.

  • Beberapa properti telah berubah di resource policy:

    • Properti rule telah diganti namanya menjadi rules.
    • Nilai properti rules[].subaction kini berupa daftar string, bukan string.
    • Nilai properti rules[].conditions.contentMatchType kini berupa daftar string, bukan string.

  • Dokumentasi untuk metode policies.insert dan policies.update telah diperbarui untuk mencerminkan fakta bahwa Anda dapat menetapkan nilai untuk objek rules[] saat memanggil metode tersebut.

  • Beberapa metode API mendukung jenis error baru. Tabel di bawah ini mengidentifikasi metode dan mengidentifikasi secara singkat jenis error yang baru didukung. Dalam banyak kasus, mungkin ada beberapa error untuk jenis tertentu. Misalnya, error required ditampilkan jika Anda mencoba menyisipkan resource asset yang tidak memiliki kolom metadata yang diperlukan. Bahkan, mungkin ada lebih dari satu kolom metadata yang diperlukan, yang masing-masing akan menampilkan error dengan pesan yang sedikit berbeda.

    Lihat dokumentasi error untuk setiap metode atau halaman error untuk mengetahui informasi selengkapnya.

    Metode Error
    assets.insert
    • invalidValue – Kolom metadata aset berisi nilai yang tidak valid.
    • required – Kolom metadata aset yang diperlukan tidak ada.
    assets.update
    assets.patch
    • forbidden – Aset yang diperbarui tidak dimiliki oleh partner yang mencoba menyelesaikan pembaruan.
    • invalidValue – Kolom metadata aset berisi nilai yang tidak valid.
    • notFound – Aset dikaitkan dengan aset musim atau aset acara yang tidak dapat ditemukan.
    • required – Kolom metadata aset yang diperlukan tidak ada.
    claims.insert
    • badRequest – Permintaan mencoba mengklaim video, tetapi klaim tidak diizinkan.
    ownership.update
    ownership.patch
    • badRequest – Permintaan menentukan total kepemilikan lebih dari 100 persen dalam suatu wilayah.
    policies.insert
    policies.patch
    policies.update
    • conflictingPolicyRules – Kebijakan berisi aturan kebijakan yang bertentangan.

  • Halaman errors baru mencantumkan error yang dapat ditampilkan API. Halaman ini mencakup error umum, yang mungkin terjadi untuk beberapa metode API yang berbeda, serta error khusus metode.

18 Januari 2013

Update ini berisi perubahan berikut:

  • Metode videoAdvertisingOptions.getEnabledAds yang baru didokumentasikan memungkinkan Anda mengambil detail tentang jenis iklan yang diizinkan untuk video yang diupload oleh partner atau pengguna tertentu.

  • Definisi parameter ownershipRestriction metode assetSearch.list telah diperbarui untuk menunjukkan bahwa nilai parameter default adalah mine, yang menunjukkan bahwa API hanya boleh mengambil aset yang dimiliki oleh pengguna saat ini.

  • Dokumentasi metode assets.list mencerminkan perubahan berikut:

    • Parameter id kini wajib ada.

    • Parameter fetchMatchPolicy yang baru didukung memungkinkan Anda menunjukkan apakah permintaan API juga harus mengambil kebijakan pencocokan yang telah Anda tetapkan untuk aset.

    • Parameter fetchOwnership yang baru didukung memungkinkan Anda menunjukkan apakah permintaan API juga harus mengambil data kepemilikan untuk aset.

    • Daftar aset yang ditampilkan API tidak lagi berisi data penomoran halaman. Akibatnya, properti nextPageToken dan objek pageInfo telah dihapus dari respons API. Objek pageInfo berisi properti totalResults, resultsPerPage, dan startIndex.

  • Dokumentasi resource claims telah diperbarui untuk menunjukkan bahwa Anda harus menentukan kebijakan saat membuat klaim. (YouTube saat ini tidak menerapkan kebijakan penggunaan default Anda jika klaim yang disisipkan tidak menentukan kebijakan, meskipun dokumentasi sebelumnya menunjukkan bahwa hal itu memang terjadi.)

  • Properti hasUnpublishedDraft resource policy tidak digunakan lagi.

  • Parameter id metode policies.list yang baru didukung memungkinkan Anda mengidentifikasi kebijakan tersimpan yang harus diambil oleh permintaan API. Hanya kebijakan milik pemilik konten yang saat ini diautentikasi yang dapat diambil.

  • Definisi parameter releaseClaims untuk metode references.patch dan references.update telah diperbarui untuk menunjukkan bahwa parameter hanya berfungsi saat status klaim diperbarui menjadi inactive. Dalam hal ini, Anda juga dapat menetapkan nilai parameter releaseClaims ke true untuk merilis semua klaim kecocokan yang dihasilkan oleh referensi.

  • Metode references.patch dan references.update telah diperbarui untuk menunjukkan bahwa Anda harus menentukan status referensi saat melakukan salah satu operasi ini.

  • Beberapa metode API mendukung jenis error baru. Tabel di bawah mengidentifikasi metode dan error yang baru didukung:

    Metode Jenis error Detail error Deskripsi
    guideCategories.list notFound Unavailable Aset yang kebijakan kecocokannya Anda coba ambil tidak dapat ditemukan.
    claims.get notFound Unavailable Klaim yang Anda coba ambil tidak dapat ditemukan.
    ownership.patch invalidValue Unavailable Data kepemilikan yang Anda berikan berisi nilai yang tidak valid.
    ownership.update invalidValue Unavailable Data kepemilikan yang Anda berikan berisi nilai yang tidak valid.