Channels

API で、チャンネルまたは動画を「子ども向け」としてマークできるようになりました。さらに、channel リソースと video リソースにも、そのチャンネルまたは動画の「子ども向け」ステータスを識別するプロパティが含まれるようになりました。YouTube API サービスの利用規約とデベロッパー ポリシーも 2020 年 1 月 10 日に更新されました。詳細については、YouTube Data API サービスと YouTube API サービスの利用規約の変更履歴をご覧ください。

channel リソースには、YouTube チャンネルに関する情報が含まれています。

メソッド

API は、channels リソースに対して次のメソッドをサポートしています。

list
リクエスト条件に一致する 0 個以上の channel リソースのコレクションを返します。ぜひ、こちらからお試しください。
update
チャンネルのメタデータを更新します。このメソッドは現在、channel リソースの brandingSettings オブジェクトと invideoPromotion オブジェクト、およびそれらの子プロパティの更新のみをサポートしています。ぜひ、こちらからお試しください。

リソース表現

次の JSON 構造は、channels リソースの形式を示しています。

{
  "kind": "youtube#channel",
  "etag": etag,
  "id": string,
  "snippet": {
    "title": string,
    "description": string,
    "customUrl": string,
    "publishedAt": datetime,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "country": string
  },
  "contentDetails": {
    "relatedPlaylists": {
      "likes": string,
      "favorites": string,
      "uploads": string
    }
  },
  "statistics": {
    "viewCount": unsigned long,
    "subscriberCount": unsigned long,  // this value is rounded to three significant figures
    "hiddenSubscriberCount": boolean,
    "videoCount": unsigned long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "status": {
    "privacyStatus": string,
    "isLinked": boolean,
    "longUploadsStatus": string,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean
  },
  "brandingSettings": {
    "channel": {
      "title": string,
      "description": string,
      "keywords": string,
      "trackingAnalyticsAccountId": string,
      "unsubscribedTrailer": string,
      "defaultLanguage": string,
      "country": string
    },
    "watch": {
      "textColor": string,
      "backgroundColor": string,
      "featuredPlaylistId": string
    }
  },
  "auditDetails": {
    "overallGoodStanding": boolean,
    "communityGuidelinesGoodStanding": boolean,
    "copyrightStrikesGoodStanding": boolean,
    "contentIdClaimsGoodStanding": boolean
  },
  "contentOwnerDetails": {
    "contentOwner": string,
    "timeLinked": datetime
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

プロパティ

次の表は、このリソースで使用されているプロパティの定義を示したものです。

プロパティ
kind string
API リソースのタイプを識別します。値は youtube#channel になります。
etag etag
このリソースの Etag。
id string
YouTube がチャンネルを一意に識別するために使用する ID。
snippet object
snippet オブジェクトには、タイトル、説明、サムネイル画像など、チャンネルに関する基本的な詳細情報が含まれます。
snippet.title string
チャンネルのタイトル。
snippet.description string
チャンネルの説明。プロパティの値の最大長は 1,000 文字です。
snippet.customUrl string
チャンネルのカスタム URL。カスタム URL の利用資格要件と設定方法については、YouTube ヘルプセンターをご覧ください。
snippet.publishedAt datetime
チャンネルが作成された日時。値は ISO 8601 形式で指定します。
snippet.thumbnails object
チャンネルに関連付けられたサムネイル画像のマップ。マップ内の各オブジェクトについて、キーはサムネイル画像の名前、値はサムネイルに関するその他の情報を含むオブジェクトです。

アプリケーションでサムネイルを表示する際は、コードで API レスポンスで返された画像 URL をそのまま使用するようにしてください。たとえば、API レスポンスで返される URL で、https ドメインの代わりに http ドメインを使用しないでください。

チャンネルのサムネイル URL は https ドメインでのみ使用できます。これは、API レスポンスで URL がどのように表示されるかを示しています。http ドメインから YouTube の画像を読み込もうとすると、アプリケーションで画像が破損しているように見えることがあります。新しく作成されたチャンネルでは、サムネイル画像が空の場合があります。画像が表示されるまでに最大で 1 日かかることがあります。
snippet.thumbnails.(key) object
有効なキー値は次のとおりです。
  • default - デフォルトのサムネイル画像。動画（または、再生リストのアイテムや検索結果など、動画を参照するリソース）のデフォルト サムネイルは幅 120px、高さ 90px です。チャンネルのデフォルト サムネイルは幅 88px、高さ 88px です。
  • medium - サムネイル画像の高解像度バージョン。動画（または動画を参照するリソース）の場合、この画像は幅 320px、高さ 180px です。チャンネルの場合は、幅 240px、高さ 240px です。
  • high - サムネイル画像の高解像度版。動画（または動画を参照するリソース）の場合、この画像は幅 480px、高さ 360px です。チャンネルの場合、幅 800px、高さ 800px です。
snippet.thumbnails.(key).url string
画像の URL。アプリケーションでサムネイル URL を使用する際のその他のガイドラインについては、snippet.thumbnails プロパティの定義をご覧ください。
snippet.thumbnails.(key).width unsigned integer
画像の幅。
snippet.thumbnails.(key).height unsigned integer
画像の高さ。
snippet.defaultLanguage string
channel リソースの snippet.title プロパティと snippet.description プロパティのテキストの言語。
snippet.localized object
snippet.localized オブジェクトには、チャンネルのローカライズされたタイトルと説明、またはチャンネルのメタデータのデフォルト言語によるチャンネルのタイトルと説明が含まれます。
  • channels.list リクエストで hl パラメータを使用して、ローカライズされたテキストを返す言語を指定し、hl パラメータ値で YouTube アプリケーションの言語を識別し、ローカライズされたテキストがその言語で利用可能な場合、ローカライズされたテキストがリソース スニペットで返されます。
  • hl パラメータ値が指定されていない場合、または値が指定されているが、指定された言語のローカライズされたメタデータが利用できない場合は、デフォルト言語のメタデータが返されます。
。このプロパティには読み取り専用の値が含まれています。ローカライズされたメタデータを追加、更新、削除するには、localizations オブジェクトを使用します。
snippet.localized.title string
ローカライズされたチャンネルのタイトル。
snippet.localized.description string
ローカライズされたチャンネルの説明。
snippet.country string
チャンネルに関連付けられている国。このプロパティの値を設定するには、brandingSettings.channel.country プロパティの値を更新します。
contentDetails object
contentDetails オブジェクトは、チャンネルのコンテンツに関する情報をカプセル化します。
contentDetails.relatedPlaylists object
relatedPlaylists オブジェクトは、チャンネルに関連付けられた再生リスト（チャンネルのアップロード動画や高く評価した動画など）を識別するマップです。これらの再生リストは、playlists.list メソッドを使用して取得できます。
contentDetails.relatedPlaylists.likes string
チャンネルの高く評価した動画を含む再生リストの ID。playlistItems.insert メソッドと playlistItems.delete メソッドを使用して、そのリストにアイテムを追加したり、リストからアイテムを削除したりします。
contentDetails.relatedPlaylists.favorites string
このプロパティは非推奨になりました。

チャンネルのお気に入りの動画を含む再生リストの ID。playlistItems.insert メソッドと playlistItems.delete メソッドを使用して、このリストにアイテムを追加したり、リストからアイテムを削除したりします。

YouTube では、お気に入りの動画機能は非推奨となっています。たとえば、video リソースの statistics.favoriteCount プロパティは 2015 年 8 月 28 日に非推奨になりました。そのため、過去の理由により、このプロパティ値には空のプレイリストを参照するプレイリスト ID が含まれている可能性があり、取得できないことがあります。
contentDetails.relatedPlaylists.uploads string
チャンネルのアップロード済み動画を含む再生リストの ID。新しい動画をアップロードするには videos.insert メソッドを使用し、以前にアップロードした動画を削除するには videos.delete メソッドを使用します。
statistics object
statistics オブジェクトは、チャンネルの統計情報をカプセル化します。
statistics.viewCount unsigned long

チャンネルのすべてのフォーマットのすべての動画が視聴された回数の合計。

2026 年 8 月 24 日より、チャンネルのすべての動画形式（長尺動画、ライブ配信、ショート動画）で、viewCount が更新され、動画の再生が開始された瞬間に視聴回数がカウントされるようになります（自動再生、ポインタを合わせる、クリック/タップして再生する場合を含む）。
statistics.commentCount unsigned long
このプロパティは非推奨になりました。

チャンネルのコメント数。
statistics.subscriberCount unsigned long
チャンネルの登録者数。この値は有効数字 3 桁に切り捨てられます。チャンネル登録者数の丸め処理について詳しくは、変更履歴または YouTube ヘルプセンターをご覧ください。
statistics.hiddenSubscriberCount boolean
チャンネルのチャンネル登録者数が一般公開されているかどうかを示します。
statistics.videoCount unsigned long
チャンネルにアップロードされた公開動画の数。この値は、チャンネル所有者であっても、チャンネルの公開動画の数のみを反映します。この動作は、YouTube ウェブサイトに表示されるカウントと一致しています。
topicDetails object
topicDetails オブジェクトは、チャンネルに関連付けられたトピックに関する情報をカプセル化します。

重要: トピック ID に関連する変更の詳細については、topicDetails.topicIds[] プロパティの定義と変更履歴をご覧ください。
topicDetails.topicIds[] list
チャンネルに関連付けられているトピック ID のリスト。

このプロパティは 2016 年 11 月 10 日をもって非推奨となりました。2017 年 11 月 10 日までサポートされます。

重要: Freebase と Freebase API のサポート終了に伴い、2017 年 2 月 27 日よりトピック ID の動作が変更されました。その時点で、YouTube は厳選されたトピック ID の一部を返すようになりました。
topicDetails.topicCategories[] list
チャンネルのコンテンツを説明しているウィキペディアの URL のリスト。
status object
status オブジェクトは、チャンネルのプライバシー ステータスに関する情報をカプセル化します。
status.privacyStatus string
チャンネルのプライバシー ステータス。

このプロパティの有効な値は次のとおりです。
  • private
  • public
  • unlisted
status.isLinked boolean
チャンネル データが、YouTube ユーザー名または Google+ アカウントにすでにリンクされているユーザーを特定するかどうかを示します。このいずれかのリンクを持つユーザーは公開されている YouTube ID を既に持っているユーザーであり、動画のアップロードなど、いくつかの操作の前提条件となります。
status.longUploadsStatus string
チャンネルが 15 分を超える動画をアップロードできるかどうかを示します。このプロパティは、チャンネル所有者が API リクエストを承認した場合にのみ返されます。この機能について詳しくは、YouTube ヘルプセンターをご覧ください。

このプロパティの有効な値は次のとおりです。
  • allowed - このチャンネルでは、15 分を超える動画をアップロードできます。
  • disallowed - このチャンネルでは、15 分を超える動画をアップロードできません。チャンネルが長時間の動画をアップロードできるのは、YouTube コミュニティ ガイドラインに基づいて良好な状態にあり、コンテンツに対して全世界での Content ID のブロックが適用されていない場合に限られます。

    チャンネル所有者が、チャンネルで長時間の動画をアップロードできない原因となっている問題を解決すると、チャンネルは allowed または eligible の状態に戻ります。
  • eligible - このチャンネルは 15 分を超える動画をアップロードできます。ただし、チャンネル所有者はまず、電話認証を通じて長い動画をアップロードする機能を有効にする必要があります。この機能について詳しくは、YouTube ヘルプセンターをご覧ください。
status.madeForKids boolean
この値は、チャンネルが子ども向けとして指定されているかどうかを示し、チャンネルの現在の「子ども向け」ステータスが含まれます。たとえば、ステータスは selfDeclaredMadeForKids プロパティの値に基づいて決定されます。チャンネル、動画、ブロードキャストの視聴者を設定する方法について詳しくは、YouTube ヘルプセンターをご覧ください。
status.selfDeclaredMadeForKids boolean
channels.update リクエストでは、このプロパティを使用して、チャンネル所有者がチャンネルを子ども向けとして指定できます。プロパティ値は、チャンネル所有者が API リクエストを承認した場合にのみ返されます。
brandingSettings object
brandingSettings オブジェクトは、チャンネルのブランディングに関する情報をカプセル化します。
brandingSettings.channel object
channel オブジェクトは、チャンネル ページのブランディング プロパティをカプセル化します。
brandingSettings.channel.title string
チャンネルのタイトル。タイトルの文字数は全角 15 文字（半角 30 文字）以内です。
brandingSettings.channel.description string
チャンネルの説明。チャンネル ページのチャンネル情報ボックスに表示されます。プロパティの値の最大長は 1,000 文字です。
brandingSettings.channel.keywords string
チャンネルに関連付けられているキーワード。値は、スペース区切りの文字列のリストです。チャンネルのキーワードが 500 文字の上限を超えている場合や、エスケープされていない引用符（"）が含まれている場合は、キーワードが切り捨てられることがあります。なお、500 文字の上限はキーワードごとの上限ではなく、すべてのキーワードの合計の長さの上限です。
brandingSettings.channel.trackingAnalyticsAccountId string
チャンネルへのトラフィックをトラッキングして測定するために使用する Google アナリティクス アカウントの ID。
brandingSettings.channel.unsubscribedTrailer string
チャンネル ページのブラウズ ビューで、チャンネル登録していない視聴者向けのおすすめ動画モジュールで再生される動画。チャンネル登録者には、チャンネルの最新のアクティビティを強調する別の動画が表示されることがあります。

指定する場合、プロパティの値は、チャンネル所有者が所有する公開動画または限定公開動画の YouTube 動画 ID である必要があります。
brandingSettings.channel.defaultLanguage string
channel リソースの snippet.title プロパティと snippet.description プロパティのテキストの言語。
brandingSettings.channel.country string
チャンネルに関連付けられている国。このプロパティを更新して、snippet.country プロパティの値を設定します。
brandingSettings.watch object
注: このオブジェクトとそのすべての子プロパティは非推奨になりました。

watch オブジェクトは、チャンネルの動画の動画再生ページのブランディング プロパティをカプセル化します。
brandingSettings.watch.textColor string
注: このプロパティは非推奨になりました。

動画再生ページのブランドエリアのテキストの色。
brandingSettings.watch.backgroundColor string
注: このプロパティは非推奨になりました。

動画再生ページのブランドエリアの背景色。
brandingSettings.watch.featuredPlaylistId string
注: このプロパティは非推奨になりました。値を設定しようとすると、API からエラーが返されます。
brandingSettings.image object
このプロパティとそのすべての子プロパティは非推奨になりました。

image オブジェクトは、チャンネルのチャンネル ページまたは動画再生ページに表示される画像に関する情報をカプセル化します。
brandingSettings.image.bannerImageUrl string
このプロパティは非推奨になりました。

YouTube ウェブサイトのチャンネル ページに表示されるバナー画像の URL。画像は 1060px × 175px です。
brandingSettings.image.bannerMobileImageUrl string
このプロパティは非推奨になりました。

モバイルアプリのチャンネル ページに表示されるバナー画像の URL。画像は 640px × 175px です。
brandingSettings.image.watchIconImageUrl string
このプロパティは非推奨になりました。

動画プレーヤーの上に表示される画像の URL。高さは 25px ですが幅は固定ではなく、170px 以下の画像です。この画像が提供されていない場合は、画像の代わりにチャンネル名が表示されます。
brandingSettings.image.trackingImageUrl string
このプロパティは非推奨になりました。

チャンネル ページまたは動画ページの視聴回数の統計情報を収集するために使用できる 1 ピクセル × 1 ピクセルのトラッキング ピクセルの URL。
brandingSettings.image.bannerTabletLowImageUrl string
このプロパティは非推奨になりました。

タブレット アプリケーションのチャンネル ページに表示される低解像度のバナー画像の URL。画像の最大サイズは 1,138 x 188 ピクセルです。
brandingSettings.image.bannerTabletImageUrl string
このプロパティは非推奨になりました。

タブレット アプリのチャンネル ページに表示されるバナー画像の URL。画像は 1707px × 283px です。
brandingSettings.image.bannerTabletHdImageUrl string
このプロパティは非推奨になりました。

タブレット アプリのチャンネル ページに表示される高解像度のバナー画像の URL。画像の最大サイズは 2,276 x 377 ピクセルです。
brandingSettings.image.bannerTabletExtraHdImageUrl string
このプロパティは非推奨になりました。

タブレット アプリのチャンネル ページに表示される超高解像度バナー画像の URL。画像の最大サイズは 2,560 x 424 ピクセルです。
brandingSettings.image.bannerMobileLowImageUrl string
このプロパティは非推奨になりました。

モバイル アプリのチャンネル ページに表示される低解像度のバナー画像の URL。画像の最大サイズは 320 x 88 ピクセルです。
brandingSettings.image.bannerMobileMediumHdImageUrl string
このプロパティは非推奨になりました。

モバイル アプリのチャンネル ページに表示される中解像度のバナー画像の URL。画像の最大サイズは 960 × 263 ピクセルです。
brandingSettings.image.bannerMobileHdImageUrl string
このプロパティは非推奨になりました。

モバイルアプリのチャンネル ページに表示される高解像度のバナー画像の URL。画像の最大サイズは 1,280 x 360 ピクセルです。
brandingSettings.image.bannerMobileExtraHdImageUrl string
このプロパティは非推奨になりました。

モバイル アプリのチャンネル ページに表示される非常に高解像度のバナー画像の URL。画像の最大サイズは 1,440 x 395 ピクセルです。
brandingSettings.image.bannerTvImageUrl string
このプロパティは非推奨になりました。

テレビアプリのチャンネル ページに表示される超高解像度のバナー画像の URL。画像の最大サイズは 2,120 x 1,192 ピクセルです。
brandingSettings.image.bannerTvLowImageUrl string
このプロパティは非推奨になりました。

テレビアプリのチャンネル ページに表示される低解像度のバナー画像の URL。画像の最大サイズは 854 × 480 ピクセルです。
brandingSettings.image.bannerTvMediumImageUrl string
このプロパティは非推奨になりました。

テレビ アプリのチャンネル ページに表示される中解像度のバナー画像の URL。画像の最大サイズは 1,280 x 720 ピクセルです。
brandingSettings.image.bannerTvHighImageUrl string
このプロパティは非推奨になりました。

テレビアプリのチャンネル ページに表示される高解像度のバナー画像の URL。画像の最大サイズは 1,920×1,080 ピクセルです。
brandingSettings.image.bannerExternalUrl string
このプロパティは、YouTube がチャンネルのさまざまなバナー画像サイズを生成するために使用するバナー画像の場所を指定します。
brandingSettings.hints[] list
このプロパティとそのすべての子プロパティは非推奨になりました。

hints オブジェクトは、追加のブランディング プロパティをカプセル化します。
brandingSettings.hints[].property string
このプロパティは非推奨になりました。

プロパティ。
brandingSettings.hints[].value string
このプロパティは非推奨になりました。

プロパティの値。
auditDetails object
auditDetails オブジェクトは、マルチチャンネル ネットワーク（MCN）が特定のチャンネルを承認するか拒否するかを判断する際に評価するチャンネル データをカプセル化します。このリソース部分を取得する API リクエストには、https://www.googleapis.com/auth/youtubepartner-channel-audit スコープを含む認証トークンを指定する必要があります。また、そのスコープを使用するトークンは、MCN がチャンネルの承認または不承認を決定したとき、またはトークンが発行された日から 2 週間以内に取り消す必要があります。
auditDetails.overallGoodStanding boolean
このフィールドは、チャンネルに問題があるかどうかを示します。現在、このフィールドは communityGuidelinesGoodStanding、copyrightStrikesGoodStanding、contentIdClaimsGoodStanding プロパティに対する論理 AND 演算の結果を表します。つまり、他のすべてのプロパティも true の値を持つ場合、このプロパティの値は true になります。ただし、これらのプロパティのいずれかの値が false の場合、このプロパティの値は false になります。ただし、このプロパティの値を設定するために使用される方法は変更される可能性があります。
auditDetails.communityGuidelinesGoodStanding boolean
チャンネルが YouTube のコミュニティ ガイドラインを遵守しているかどうかを示します。
auditDetails.copyrightStrikesGoodStanding boolean
チャンネルに著作権侵害の警告があるかどうかを示します。
auditDetails.contentIdClaimsGoodStanding boolean
チャンネルに未解決の申し立てがあるかどうかを示します。
contentOwnerDetails object
contentOwnerDetails オブジェクトは、チャンネルをコンテンツ マネージャーにリンクしている YouTube パートナーのみが閲覧できるチャンネル データをカプセル化します。
contentOwnerDetails.contentOwner string
チャンネルにリンクされているコンテンツ所有者の ID。
contentOwnerDetails.timeLinked datetime
チャンネルがコンテンツ所有者に関連付けられた日時。値は ISO 8601 形式で指定します。
localizations object
localizations オブジェクトは、チャンネルのメタデータの翻訳をカプセル化します。
localizations.(key) object
キー値に関連付けられたローカライズされたメタデータの言語。値は、BCP-47 言語コードを含む文字列です。
localizations.(key).title string
ローカライズされたチャンネルのタイトル。
localizations.(key).description string
ローカライズされたチャンネルの説明。