Activities: insert

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

Untuk mengetahui detail selengkapnya, lihat Pusat Bantuan YouTube.

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

Catatan: Meskipun resource activity dapat berisi informasi tentang tindakan seperti pengguna memberi rating 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 pada suatu video dan metode playlistItems.insert() untuk menandai video sebagai favorit.

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

Permintaan

Permintaan HTTP

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

Otorisasi

Permintaan ini memerlukan otorisasi dengan setidaknya salah 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. Parameter ini mengidentifikasi properti yang akan ditetapkan oleh operasi tulis serta properti yang akan disertakan oleh 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 berikut:

    • snippet.description
    • contentDetails.bulletin.resourceId

Respons

Jika berhasil, metode ini akan menampilkan resource aktivitas 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) bulletinTextRequired Permintaan harus menggunakan properti description objek snippet guna memberikan teks untuk postingan buletin.
badRequest (400) invalidMetadata Properti kind tidak cocok 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 Anda.