実装: チャネル

このページでは、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"
        }
      }
    }

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

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

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

チャンネルのセクションを管理するための channelSections.listchannelSections.insertchannelSections.updatechannelSections.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 を使用してメディア ファイルをアップロードすることはサポートされていないため、このクエリを APIs Explorer を使用してテストすることはできません。