実装: チャネル

このページでは、YouTube Data API（v3）を使用して、チャンネルデータの取得と更新に関連する機能を実行する方法について説明します。channel リソースには、チャンネルにアップロードされた動画と高く評価した動画を識別する再生リスト ID が含まれます。channels.list メソッドを呼び出すときにこの情報を取得するには、part パラメータ値に contentDetails リソース部分を含めます。

チャンネルに関する情報を取得する

channels.list メソッドを呼び出して、特定のチャンネルに関する情報を取得します。チャンネルを識別する方法はいくつかあります。

チャンネルのブランディング情報を設定する

この例では、チャンネルのブランディング オプションを更新します。この例には次の 2 つの手順があります。

  • ステップ 1: チャンネルのブランディング オプションを取得する

    channels.list メソッドを呼び出し、part パラメータ値を brandingSettings に、mine パラメータ値を true に設定します。

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

    アプリケーションで取得した設定を表示し、ユーザーが設定を変更して更新できるようにします。

  • ステップ 2: チャンネルのブランディング オプションを更新する

    channels.list メソッドを呼び出し、次の値を設定します。

    • id プロパティを、チャンネルの一意の YouTube チャンネル ID に設定します。ID は、ステップ 1 の API レスポンスから抽出できます。
    • part パラメータ値を brandingSettings に設定します。

    以下の API Explorer へのリンクは、次のブランディング設定で channel リソースを作成します。

    {
  "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"
    }
  }
}

    API Explorer でリクエストを完了するには、id プロパティの値を、認証済みユーザーのチャンネルのチャンネル ID に設定する必要があります。また、現在の設定に合わせて画像プロパティを設定する必要があります。

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

チャンネル セクションを管理する

API は、チャンネル セクションを管理するための channelSections.list、channelSections.insert、channelSections.update、および channelSections.delete メソッドをサポートしています。チャンネル セクションは、チャンネルで注目されている動画のセットです。たとえば、セクションには、チャンネルの最新のアップロード動画、人気のアップロード動画、1 つまたは複数の再生リストの動画を含めることができます。

次の例では、Google の公式 YouTube チャンネルのチャンネル セクションを取得します。リクエストは channelSections.list メソッドを呼び出し、channelId パラメータ値を UCK8sQmJBp8GCxrOtXWBpyEA に設定します。これは、Google のチャンネルのチャンネル ID です。

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

このリクエストでは、channelId パラメータを使用する代わりに mine パラメータ値を true に設定すると、承認が必要になります。このパラメータは、現在認証されているユーザーのチャンネルのチャンネル セクションを取得していることを示します。

チャンネルの透かし画像をアップロードして設定する

watermarks.set メソッドを呼び出して、透かし画像をアップロードし、チャンネルに設定できます。画像は、指定したチャンネルの動画の再生中に表示されます。また、画像がリンクするターゲット チャンネルと、透かしが表示されるタイミングと表示される期間を決定するタイミングの詳細を指定することもできます。

watermarks.unset メソッドは、チャンネルの透かし画像を削除します。

残念ながら、このクエリは API Explorer を使用してテストできません。API Explorer では、このメソッドに必要なメディア ファイルのアップロードがサポートされていないためです。