このページでは、YouTube Data API(v3)を使用してチャンネル データの取得と更新を行う関数を実行する方法について説明します。channel
リソースには、チャンネルのアップロード動画と高評価動画を識別する再生リスト ID が含まれます。channels.list
メソッドを呼び出すときにこの情報を取得するには、part
パラメータ値に contentDetails
リソース部分が含まれていることを確認します。
チャンネルに関する情報を取得する
特定のチャンネルに関する情報を取得するには、channels.list
メソッドを呼び出します。チャンネルを識別する方法はいくつかあります。
-
mine
パラメータ値をtrue
に設定して、現在認証されているユーザーの YouTube チャンネルの情報を取得します。リクエストは OAuth 2.0 を使用して承認する必要があります。https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list? part=snippet,contentDetails,brandingSettings &mine=true
-
forUsername
パラメータを YouTube ユーザー名に設定して、そのユーザー名に関連付けられているチャンネルの情報を取得します。この例では、forUsername
パラメータ値をGoogle
に設定して、Google の公式 YouTube チャンネルの情報を取得します。https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list? part=snippet,contentDetails &forUsername=Google
-
id
パラメータを、情報を取得するチャンネルを一意に識別する YouTube チャンネル ID に設定します。この例では、id
パラメータをUCK8sQmJBp8GCxrOtXWBpyEA
に設定します。これにより、Google の公式 YouTube チャンネルも識別されます。https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list? part=snippet,contentDetails &id=UCK8sQmJBp8GCxrOtXWBpyEA
チャンネルのブランディング情報を設定する
この例では、チャンネルのブランディング オプションを更新します。この例には次の 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.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 を使用してメディア ファイルをアップロードすることはサポートされていないため、このクエリを APIs Explorer を使用してテストすることはできません。