実装: チャネル

このページでは、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 ではメディア ファイルのアップロード機能がサポートされていないためです。この機能は、このメソッドの要件となります。