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

プロパティ

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

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

アプリでサムネイルを表示する場合は、コードで API レスポンスで返された画像 URL をそのまま使用してください。たとえば、API レスポンスで返された URL で https ドメインではなく http ドメインを使用することはできません。

チャンネルのサムネイル URL は https ドメインでのみ使用できます。この URL は API レスポンスに表示されます。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).urlstring
画像の URL。アプリケーションでサムネイル URL を使用する際のガイドラインについては、snippet.thumbnails プロパティの定義をご覧ください。
snippet.thumbnails.(key).widthunsigned integer
画像の幅。
snippet.thumbnails.(key).heightunsigned integer
画像の高さ。
snippet.defaultLanguagestring
channel リソースの snippet.title プロパティと snippet.description プロパティのテキストの言語。
snippet.localizedobject
snippet.localized オブジェクトには、チャンネルのローカライズされたタイトルと説明が含まれます。または、チャンネルのメタデータのデフォルトの言語でチャンネルのタイトルと説明が含まれます。
  • ローカライズされたテキストがリソース スニペットで返される条件は、channels.list リクエストで hl パラメータを使用してローカライズされたテキストを返す言語が指定されていること、hl パラメータ値が YouTube アプリケーションの言語を識別すること、ローカライズされたテキストがその言語で利用可能であることです。
  • hl パラメータ値が指定されていない場合、または値が指定されていても、指定した言語のローカライズされたメタデータを使用できない場合は、デフォルト言語のメタデータが返されます。
プロパティに読み取り専用値が含まれています。ローカライズされたメタデータを追加、更新、削除するには、localizations オブジェクトを使用します。
snippet.localized.titlestring
ローカライズされたチャンネル タイトル。
snippet.localized.descriptionstring
ローカライズされたチャネルの説明。
snippet.countrystring
チャンネルに関連付けられている国。このプロパティの値を設定するには、brandingSettings.channel.country プロパティの値を更新します。
contentDetailsobject
contentDetails オブジェクトは、チャンネルのコンテンツに関する情報をカプセル化します。
contentDetails.relatedPlaylistsobject
relatedPlaylists オブジェクトは、チャンネルに関連付けられた再生リスト(チャンネルのアップロード動画や高評価動画など)を識別するマップです。これらのプレイリストは、playlists.list メソッドを使用して取得できます。
contentDetails.relatedPlaylists.likesstring
チャンネルの高く評価した動画を含む再生リストの ID。playlistItems.insert メソッドと playlistItems.delete メソッドを使用して、そのリストにアイテムを追加または削除します。
contentDetails.relatedPlaylists.favoritesstring
このプロパティは非推奨になりました。

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

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

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

2025 年 3 月 31 日より、チャンネルのショート動画の視聴回数(viewCount)が更新され、ショート動画の再生または繰り返し再生が開始された回数が含まれるようになります。

statistics.commentCountunsigned long
このプロパティは非推奨になりました。

チャンネルのコメント数。
statistics.subscriberCountunsigned long
チャンネルのチャンネル登録者数。この値は 3 桁の有効数字に切り捨てられます。チャンネル登録者数の丸め方について詳しくは、リビジョン履歴または YouTube ヘルプセンターをご覧ください。
statistics.hiddenSubscriberCountboolean
チャンネルのチャンネル登録者数が一般公開されるかどうかを示します。
statistics.videoCountunsigned long
チャンネルにアップロードされた公開動画の数。この値は、チャンネルの公開動画の数のみを反映します(所有者に対しても同様です)。この動作は、YouTube ウェブサイトに表示されるカウントと一致します。
topicDetailsobject
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 のリスト。
statusobject
status オブジェクトは、チャンネルのプライバシー ステータスに関する情報をカプセル化します。
status.privacyStatusstring
チャンネルのプライバシー ステータス。

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

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

    チャンネル所有者が、チャンネルで長い動画をアップロードできない問題を解決すると、チャンネルは allowed または eligible の状態に戻ります。
  • eligible - このチャンネルは、15 分を超える長さの動画をアップロードできます。ただし、チャンネル所有者はまず電話による確認で長尺動画をアップロードする機能を有効にする必要があります。この機能の詳細については、YouTube ヘルプセンターをご覧ください。
status.madeForKidsboolean
この値は、チャンネルが子ども向けとして指定されているかどうかを示し、チャンネルの現在の「子ども向け」ステータスを含みます。たとえば、ステータスは selfDeclaredMadeForKids プロパティの値に基づいて決定されます。チャンネル、動画、ライブ配信の視聴者を設定する方法について詳しくは、YouTube ヘルプセンターをご覧ください。
status.selfDeclaredMadeForKidsboolean
channels.update リクエストで、このプロパティを使用すると、チャンネル所有者はチャンネルを子ども向けとして指定できます。プロパティ値は、チャンネル所有者が API リクエストを承認した場合にのみ返されます。
brandingSettingsobject
brandingSettings オブジェクトは、チャンネルのブランディングに関する情報をカプセル化します。
brandingSettings.channelobject
channel オブジェクトは、チャンネル ページのブランディング プロパティをカプセル化します。
brandingSettings.channel.titlestring
チャンネルのタイトル。タイトルの文字数は全角 15 文字(半角 30 文字)以内です。
brandingSettings.channel.descriptionstring
チャンネルの説明: チャンネル ページのチャンネル情報ボックスに表示されます。プロパティの値の最大長は 1,000 文字です。
brandingSettings.channel.keywordsstring
チャンネルに関連付けられているキーワード。値は、スペース区切りの文字列のリストです。チャンネル キーワードが許容される最大長 500 文字を超えている場合や、エスケープされていない引用符(")が含まれている場合、キーワードは切り捨てられることがあります。500 文字の上限はキーワードごとの上限ではなく、すべてのキーワードの合計長の上限です。
brandingSettings.channel.trackingAnalyticsAccountIdstring
チャンネルへのトラフィックのトラッキングと測定に使用する Google アナリティクス アカウントの ID。
brandingSettings.channel.unsubscribedTrailerstring
チャンネル登録していない視聴者向けに、チャンネル ページのブラウジング ビューの注目の動画モジュールで再生する動画。チャンネル登録している視聴者には、チャンネルの最近のアクティビティをハイライトした別の動画が表示される場合があります。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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