Channels: update

API tersebut kini mendukung kemampuan untuk menandai channel atau video Anda sebagai "Dibuat untuk Anak-Anak". Selain itu, referensi channel dan video kini juga berisi properti yang mengidentifikasi status "Dibuat untuk Anak-Anak" untuk channel atau video tersebut. Kebijakan Developer dan Persyaratan Layanan untuk Layanan YouTube API juga diperbarui pada 10 Januari 2020. Untuk mengetahui informasi selengkapnya, lihat histori revisi untuk Layanan Data API YouTube dan Persyaratan Layanan untuk Layanan YouTube API.

Memperbarui metadata channel. Perlu diperhatikan bahwa metode ini saat ini hanya mendukung update untuk objek brandingSettings, invideoPromotion, dan localizations resource channel serta properti turunannya.

Dampak kuota: Panggilan ke metode ini memiliki biaya kuota sebanyak 50 unit.

Kasus penggunaan umum

Permintaan

Permintaan HTTP

PUT https://www.googleapis.com/youtube/v3/channels

Otorisasi

Permintaan ini memerlukan otorisasi dengan setidaknya salah satu cakupan berikut (baca selengkapnya tentang autentikasi dan otorisasi).

Cakupan
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parameter

Tabel berikut mencantumkan parameter yang didukung kueri ini. Semua parameter yang tercantum adalah parameter kueri.

Parameter
Parameter yang diperlukan
part string
Parameter part memiliki dua tujuan dalam operasi ini. API ini mengidentifikasi properti yang akan ditetapkan oleh operasi tulis serta properti yang akan disertakan oleh respons API.

API saat ini hanya mengizinkan nilai parameter untuk disetel ke brandingSettings, invideoPromotion, atau localizations. (Anda hanya dapat memperbarui salah satu bagian tersebut dengan satu permintaan.)

Perhatikan bahwa metode ini akan mengganti nilai yang ada untuk semua properti yang dapat diubah dan terdapat di bagian yang ditentukan oleh nilai parameter.
Parameter opsional
onBehalfOfContentOwner string
Parameter ini hanya dapat digunakan dalam permintaan yang diizinkan dengan benar. Parameter onBehalfOfContentOwner menunjukkan bahwa pengguna yang diautentikasi bertindak atas nama pemilik konten yang ditentukan dalam nilai parameter. Parameter ini ditujukan untuk partner konten YouTube yang memiliki dan mengelola banyak channel YouTube yang berbeda. Pemilik konten dapat melakukan autentikasi sekali dan mendapatkan akses ke semua data channel serta video mereka, tanpa harus memberikan kredensial autentikasi untuk setiap channel. Akun CMS sebenarnya yang digunakan pengguna untuk autentikasi harus ditautkan ke pemilik konten YouTube yang ditentukan.

Isi permintaan

Berikan resource channel dalam isi permintaan. Untuk resource tersebut:

  • Anda harus menentukan nilai untuk properti ini:

    • id

  • Anda dapat menetapkan nilai untuk properti berikut:

    • brandingSettings.channel.country
    • brandingSettings.channel.description
    • brandingSettings.channel.defaultLanguage
    • brandingSettings.channel.keywords
    • brandingSettings.channel.trackingAnalyticsAccountId
    • brandingSettings.channel.unsubscribedTrailer
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description
    • status.selfDeclaredMadeForKids

    Jika Anda mengirimkan permintaan pembaruan, dan permintaan Anda tidak menentukan nilai untuk properti yang sudah memiliki nilai, nilai properti yang sudah ada akan dihapus.

Respons

Jika berhasil, metode ini akan menampilkan resource channel dalam isi respons.

Error

Tabel berikut mengidentifikasi pesan error yang dapat ditampilkan API sebagai respons terhadap panggilan ke metode ini. Lihat dokumentasi pesan error untuk detail selengkapnya.

Jenis error Detail error Deskripsi
badRequest (400) brandingValidationError Salah satu nilai dalam objek brandingSettings gagal divalidasi. Gunakan metode channels.list untuk mengambil setelan yang ada untuk saluran, dan perbarui nilai properti dengan mengikuti panduan dalam dokumentasi resource channels.
badRequest (400) channelTitleUpdateForbidden Saat memperbarui brandingSettings part saluran, Anda harus menetapkan nilai properti brandingSettings.channel.title ke judul saluran saat ini atau menghapus properti. API akan menampilkan error jika Anda mengubah nilai properti.
badRequest (400) defaultLanguageNotSetError defaultLanguage harus disetel untuk mengupdate localizations.
badRequest (400) invalidBrandingOption Salah satu setelan branding yang Anda tentukan tidak ada. Gunakan metode channels.list untuk mengambil nilai yang valid dan pastikan untuk memperbaruinya dengan mengikuti panduan dalam dokumentasi resource channels.
badRequest (400) invalidCustomMessage Metadata permintaan mencantumkan pesan khusus yang tidak valid. Periksa nilai properti invideoPromotion.items[].customMessage di resource yang dikirim permintaan.
badRequest (400) invalidDuration Metadata permintaan menentukan durasi yang tidak valid di bagian invideoPromotion.
badRequest (400) invalidDuration Metadata permintaan menentukan jenis posisi yang tidak valid untuk menentukan cara item yang dipromosikan diposisikan pada pemutar video. Periksa nilai properti invideoPromotion.position.type di resource yang dikirim permintaan.
badRequest (400) invalidRecentlyUploadedBy Metadata permintaan mencantumkan ID channel yang tidak valid. Periksa nilai properti invideoPromotion.items[].id.recentlyUploadedBy di resource yang dikirim permintaan.
badRequest (400) invalidTimingOffset Metadata permintaan menentukan offset waktu yang tidak valid di bagian invideoPromotion.
badRequest (400) invalidTimingOffset Metadata permintaan menentukan offset pengaturan waktu yang tidak valid untuk menentukan kapan item yang dipromosikan harus ditampilkan di pemutar video. Periksa nilai properti invideoPromotion.timing.offsetMs di resource yang dikirim permintaan.
badRequest (400) invalidTimingType Metadata permintaan menentukan metode pengaturan waktu yang tidak valid untuk menentukan kapan item yang dipromosikan harus ditampilkan di pemutar video. Periksa nilai properti invideoPromotion.timing.type di resource yang dikirim permintaan.
badRequest (400) localizationValidationError Salah satu nilai dalam objek pelokalan gagal divalidasi. Gunakan metode channels.list untuk mengambil nilai yang valid dan pastikan untuk memperbaruinya dengan mengikuti panduan dalam dokumentasi resource saluran.
badRequest (400) tooManyPromotedItems Jumlah item promosi yang diizinkan terlampaui di bagian invideoPromotion.
forbidden (403) channelForbidden Saluran yang ditentukan dalam parameter id tidak mendukung permintaan atau permintaan tidak diotorisasi dengan benar.
forbidden (403) promotedVideoNotAllowed Saluran yang coba diperbarui oleh permintaan API tidak dapat ditemukan. Periksa nilai properti id di resource channel yang dikirim permintaan untuk memastikan ID saluran sudah benar.
forbidden (403) websiteLinkNotAllowed URL situs yang ditentukan tidak diizinkan.
notFound (404) channelNotFound Saluran yang ditentukan dalam parameter id tidak dapat ditemukan.
notFound (404) channelNotFound Channel yang ditentukan oleh parameter id tidak dapat ditemukan atau tidak memiliki opsi branding.
notFound (404) unknownChannelId ID channel yang ditentukan tidak ditemukan.
notFound (404) unknownChannelId ID channel RecentUploadBy yang ditentukan tidak ditemukan.
notFound (404) unknownVideoId ID video yang ditentukan sebagai item yang dipromosikan tidak dapat ditemukan.
required (400) requiredItemIdType Metadata permintaan harus menentukan jenis item di bagian invideoPromotion.
required (400) requiredItemId Metadata permintaan harus menentukan ID item di bagian invideoPromotion.
required (400) requiredTimingOffset Metadata permintaan harus menentukan offset waktu default sehingga YouTube dapat menentukan waktu untuk menampilkan item yang dipromosikan. Tetapkan nilai properti invideoPromotion.defaultTiming.offsetMs di resource yang dikirim permintaan.
required (400) requiredTimingOffset Metadata permintaan harus menentukan selisih waktu sehingga YouTube dapat menentukan waktu untuk menampilkan item yang dipromosikan. Tetapkan nilai properti invideoPromotion.timing.offsetMs di resource yang dikirim permintaan.
required (400) requiredTimingType Metadata permintaan harus menentukan metode pengaturan waktu sehingga YouTube dapat menentukan waktu untuk menampilkan item yang dipromosikan. Tetapkan nilai properti invideoPromotion.defaultTiming.type di resource yang dikirim permintaan.
required (400) requiredTimingType Metadata permintaan harus menentukan metode pengaturan waktu sehingga YouTube dapat menentukan waktu untuk menampilkan item yang dipromosikan. Tetapkan nilai properti invideoPromotion.timing.type di resource yang dikirim permintaan.
required (400) requiredTiming Metadata permintaan harus menentukan waktu untuk setiap item di bagian invideoPromotion.
required (400) requiredVideoId Metadata permintaan harus menentukan ID video untuk mengidentifikasi item yang dipromosikan.
required (400) requiredWebsiteUrl Metadata permintaan harus menentukan URL situs di bagian invideoPromotion. Tetapkan nilai properti invideoPromotion.items[].id.websiteUrl di resource yang dikirim permintaan.

Cobalah!

Gunakan APIs Explorer untuk memanggil API ini dan melihat permintaan dan respons API.