Implementasi: Saluran

Halaman ini menjelaskan cara menggunakan YouTube Data API (v3) untuk menjalankan fungsi yang terkait dengan mengambil dan memperbarui 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 nilai parameter part menyertakan bagian resource contentDetails.

Mengambil informasi tentang channel

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

Menyetel informasi branding channel

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

  • Langkah 1: Mengambil 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, yang memungkinkan pengguna mengubah setelan untuk memperbarui.

  • Langkah 2: Perbarui opsi branding channel

    Panggil metode channels.list dan tetapkan nilai berikut:

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

    Link ke API Explorer di bawah 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 Penjelajah API, Anda perlu menetapkan nilai properti id ke ID saluran dari saluran 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 mendukung metode channelSections.list, channelSections.insert, channelSections.update, dan channelSections.delete untuk mengelola bagian channel. Bagian channel adalah sekumpulan video yang ditampilkan di channel. Misalnya, bagian dapat berisi upload terbaru dari channel, upload terpopuler, atau video dari satu atau beberapa playlist.

Contoh di bawah mengambil bagian channel untuk channel YouTube resmi Google. Permintaan tersebut memanggil metode channelSections.list dan menetapkan parameter value 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 Anda menetapkan nilai parameter mine ke true, bukan parameter channelId. Parameter tersebut menunjukkan bahwa Anda mengambil bagian saluran untuk saluran 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 saluran. Gambar kemudian ditampilkan selama pemutaran video dari saluran yang ditentukan. Anda juga dapat menentukan saluran target yang akan ditautkan ke gambar serta detail pengaturan waktu yang menentukan kapan watermark muncul dan berapa lama terlihat.

Metode watermarks.unset menghapus gambar watermark channel.

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