Activities: insert

YouTube tidak lagi menggunakan fitur buletin channel, dan metode ini tidak lagi didukung.

Untuk mengetahui detail selengkapnya, lihat Pusat Bantuan YouTube.

Memposting buletin untuk channel tertentu. (Pengguna yang mengirimkan permintaan harus diberi otorisasi untuk bertindak atas nama channel.)

Catatan: Meskipun resource activity dapat berisi informasi tentang tindakan seperti pengguna memberikan rating pada video atau menandai video sebagai favorit, Anda harus menggunakan metode API lain untuk membuat resource activity tersebut. Misalnya, Anda akan menggunakan metode videos.rate() API untuk memberi rating video dan metode playlistItems.insert() untuk menandai video sebagai favorit.

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

Permintaan

Permintaan HTTP

POST https://www.googleapis.com/youtube/v3/activities

Otorisasi

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

Cakupan
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. Tag tersebut mengidentifikasi properti yang akan ditetapkan oleh operasi tulis serta properti yang akan disertakan dalam respons API.

Daftar berikut berisi nama part yang dapat Anda sertakan dalam nilai parameter:
  • contentDetails
  • id
  • snippet

Isi permintaan

Berikan resource aktivitas dalam isi permintaan. Untuk resource tersebut:

  • Anda harus menentukan nilai untuk properti ini:

    • snippet.description

  • Anda dapat menetapkan nilai untuk properti ini:

    • snippet.description
    • contentDetails.bulletin.resourceId

Tanggapan

Jika berhasil, metode ini menampilkan resource aktivitas di isi respons.

Error

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

Jenis error Detail error Deskripsi
badRequest (400) bulletinTextRequired Permintaan tersebut harus menggunakan properti description objek snippet untuk menyediakan teks bagi postingan buletin.
badRequest (400) invalidMetadata Properti kind tidak sesuai dengan jenis ID yang diberikan.
forbidden (403) forbidden Permintaan tidak diotorisasi dengan benar.
notFound (404) playlistNotFound YouTube tidak dapat menemukan video yang ingin Anda kaitkan dengan postingan buletin. Periksa nilai properti contentDetails.bulletinPosted.playlistId.
notFound (404) videoNotFound YouTube tidak dapat menemukan video yang ingin Anda kaitkan dengan postingan buletin. Periksa nilai properti contentDetails.bulletinPosted.videoId.
userRateLimitExceeded (403) rateLimitExceeded Permintaan tidak dapat diselesaikan karena Anda telah melebihi kuota.