Implementasi: Saluran

Halaman ini menjelaskan cara menggunakan YouTube Data API (v3) untuk menjalankan fungsi yang terkait dengan pengambilan dan pembaruan data channel. Resource channel mencakup ID playlist yang mengidentifikasi video yang diupload dan disukai channel. Untuk mengambil informasi ini saat memanggil metode channels.list, pastikan parameter value part menyertakan bagian resource contentDetails.

Mengambil informasi tentang saluran

Panggil metode channels.list untuk mengambil informasi tentang channel tertentu. Ada beberapa cara untuk mengidentifikasi saluran:

Menetapkan informasi branding channel

Contoh ini memperbarui opsi branding channel. Contoh ini memiliki dua langkah:

  • Langkah 1: Ambil opsi branding channel

    Panggil metode channels.list dan tetapkan nilai parameter part ke brandingSettings dan nilai parameter mine ke true.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=brandingSettings
        &mine=true

    Aplikasi Anda dapat menampilkan setelan yang diambil, sehingga pengguna dapat mengubah setelan yang akan diperbarui.

  • Langkah 2: Perbarui opsi branding channel

    Panggil metode channels.list dan tetapkan nilai berikut:

    • Tetapkan properti id ke ID channel YouTube unik channel. ID dapat diekstrak dari respons API pada langkah 1.
    • Tetapkan nilai parameter part ke brandingSettings.

    Link ke API Explorer di bawah akan membuat resource channel dengan setelan branding berikut:

    {
  "id": "CHANNEL_ID",
  "brandingSettings": {
    "channel": {
      "description": "A great channel to be enjoyed by all.",
      "moderateComments": true,
      "showRelatedChannels": true,
      "showBrowseView": true,
      "featuredChannelsTitle": "Featured Channel Stuff",
      "featuredChannelsUrls": [
        "UC_x5XG1OV2P6uZZ5FSM9Ttw",
        "UCBR8-60-B28hp2BmDPdntcQ",
        "UCK8sQmJBp8GCxrOtXWBpyEA"
      ],
      "profileColor": "#006600"
    }
  }
}

    Untuk menyelesaikan permintaan di API Explorer, Anda harus menetapkan nilai properti id ke ID channel channel pengguna yang diautentikasi. Anda juga harus menetapkan properti gambar agar cocok dengan setelan saat ini.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.update?
        part=brandingSettings

Mengelola bagian channel

API ini mendukung metode channelSections.list, channelSections.insert, channelSections.update, dan channelSections.delete untuk mengelola bagian channel. Bagian channel adalah kumpulan video yang ditampilkan di channel. Misalnya, bagian dapat menyertakan upload terbaru, upload paling populer, atau video dari satu atau beberapa playlist di channel.

Contoh di bawah ini mengambil bagian channel untuk channel YouTube resmi Google. Permintaan memanggil metode channelSections.list dan menetapkan nilai parameter channelId ke UCK8sQmJBp8GCxrOtXWBpyEA, yang merupakan ID saluran untuk saluran Google. 

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channelSections.list?
part=snippet,contentDetails
&channelId=UCK8sQmJBp8GCxrOtXWBpyEA

Permintaan ini memerlukan otorisasi jika, alih-alih menggunakan parameter channelId, Anda menetapkan nilai parameter mine ke true. Parameter tersebut menunjukkan bahwa Anda mengambil bagian channel untuk channel pengguna yang saat ini diautentikasi.

Mengupload dan menetapkan gambar watermark untuk channel

Anda dapat memanggil metode watermarks.set untuk mengupload gambar watermark dan menyetelnya untuk channel. Gambar kemudian akan ditampilkan selama pemutaran video channel yang ditentukan. Anda juga dapat menentukan saluran target yang akan ditautkan gambar serta detail pengaturan waktu yang menentukan kapan watermark muncul dan berapa lama watermark terlihat.

Metode watermarks.unset menghapus gambar watermark channel.

Sayangnya, kueri ini tidak dapat diuji menggunakan API Explorer karena API Explorer tidak mendukung kemampuan untuk mengupload file media, yang merupakan persyaratan untuk metode ini.