API Reference

アクティビティ

activity リソースには、特定のチャンネルまたはユーザーが YouTube で行った操作に関する情報が含まれます。アクティビティ フィードでレポートされる操作には、動画の評価、動画の共有、お気に入りへの追加、動画のアップロードなどがあります。各 activity リソースは、操作の種類、操作に関連付けられたチャンネル、操作に関連付けられたリソース（評価またはアップロードされた動画など）を識別します。

このリソースの詳細については、リソース表現およびプロパティ一覧をご覧ください。

字幕

caption リソースは、YouTube の字幕トラックを表します。字幕トラックは 1 つの YouTube 動画とのみ関連付けられます。

このリソースの詳細については、リソース表現およびプロパティ一覧をご覧ください。

ChannelBanners

channelBanner リソースには、新しくアップロードされた画像をチャンネルのバナー画像として設定する URL が含まれています。

このリソースの詳細については、リソース表現およびプロパティ一覧をご覧ください。

ChannelSections

channelSection リソースには、チャンネルがおすすめとして選択した一連の動画に関する情報が含まれます。たとえば、チャンネルの最新アップロード、特に人気の高いアップロード、再生リストからの動画などが表示されます。

チャンネルのセクションが表示されるのは、チャンネルのコンテンツが（フィードビューではなく）ブラウズビューで表示されている場合のみです。チャンネルでブラウズビューにコンテンツを表示するには、指定したチャンネルの brandingSettings.channel.showBrowseView プロパティを true に設定します。

1 つのチャンネルで最大 10 個のセクションを作成できます。

このリソースの詳細については、リソース表現およびプロパティ一覧をご覧ください。

チャンネル

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

このリソースの詳細については、リソース表現およびプロパティ一覧をご覧ください。

CommentThreads

commentThread リソースには、YouTube コメント スレッドに関する情報が含まれます。コメント スレッドは、トップレベルのコメントと、そのコメントに対する返信（存在する場合）で構成されます。commentThread リソースは、動画またはチャンネルに関するコメントを表すことができます。

最上位のコメントと返信は、実際には commentThread リソース内にネストされた comment リソースです。commentThread リソースには、必ずしもコメントに対するすべての返信が含まれているわけではありません。また、特定のコメントに対するすべての返信を取得するには、comments.list メソッドを使用する必要があります。また、一部のコメントには返信がありません。

このリソースの詳細については、リソース表現およびプロパティ一覧をご覧ください。

コメント

comment リソースには、1 つの YouTube コメントに関する情報が含まれます。comment リソースは、動画またはチャンネルに関するコメントを表すことができます。また、トップレベルのコメントまたはトップレベルのコメントに対する返信をコメントにすることもできます。

このリソースの詳細については、リソース表現およびプロパティ一覧をご覧ください。

GuideCategories

guideCategory リソースは、チャンネルのコンテンツやその他の指標（チャンネルの人気度など）に基づいて、YouTube がアルゴリズムによって割り当てるカテゴリを識別します。このリストは video categories と似ています。異なる点は、動画をアップロードしたユーザーは動画カテゴリを割り当てることができますが、チャンネル カテゴリを割り当てられるのは YouTube だけです。

このリソースの詳細については、対応するリソース表現とプロパティのリストを参照してください。

I18nLanguages

i18nLanguage リソースは、YouTube ウェブサイトがサポートするアプリケーション言語を識別します。アプリケーション言語は UI 言語とも呼ばれます。YouTube ウェブサイトの場合、アプリケーションの言語は Google アカウントの設定、ブラウザの言語、IP の場所に基づいて自動的に選択されます。また、YouTube サイトのフッターから必要な UI 言語を手動で選択することもできます。

各 i18nLanguage リソースは、言語コードと名前を識別します。言語コードは、videoCategories.list や guideCategories.list などの API メソッドを呼び出すときに hl パラメータの値として使用できます。

このリソースの詳細については、リソース表現およびプロパティ一覧をご覧ください。

I18nRegions

i18nRegion リソースは、YouTube ユーザーが優先コンテンツの地域として選択できる地域を識別します。コンテンツ リージョンは、コンテンツ ロケールとも呼ばれます。YouTube ウェブサイトの場合、コンテンツの地域は、YouTube のドメインやユーザーの IP の場所などのヒューリスティックに基づいて自動的に選択されます。ユーザーは、YouTube サイトのフッターから目的のコンテンツ リージョンを手動で選択することもできます。

各 i18nRegion リソースは、地域コードと名前を識別します。リージョン コードは、search.list、videos.list、activities.list、videoCategories.list などの API メソッドを呼び出すときに、regionCode パラメータの値として使用できます。

このリソースの詳細については、リソース表現およびプロパティ一覧をご覧ください。

メンバー

member リソースは、YouTube チャンネルのチャンネル メンバーを表します。メンバーはクリエイターに金銭的サポートを定期的に提供し、特別な特典を受けることができます。たとえば、クリエイターがチャットに対してメンバー限定モードを有効にすると、メンバーはチャットできるようになります。

このリソースの詳細については、リソース表現とプロパティのリストをご覧ください。

MembershipsLevels

membershipsLevel リソースは、API リクエストを承認した作成者の料金レベルを識別します。

このリソースの詳細については、リソース表現とプロパティのリストをご覧ください。

PlaylistItems

playlistItem リソースは、再生リストに含まれる別のリソース（動画など）を識別します。また、playlistItem リソースには、特に再生リストでリソースがどのように使用されるかに関する、含まれるリソースの詳細が含まれます。

また、YouTube は再生リストを使用して、チャンネルのアップロード動画のリストも識別します。リスト内の各 playlistItem は 1 本の動画を表します。そのリストの再生リスト ID は、特定のチャンネルの channel resource から取得できます。その後、playlistItems.list メソッドを使用して一覧表示できます。

このリソースの詳細については、リソース表現およびプロパティ一覧をご覧ください。

再生リスト

playlist リソースは YouTube の再生リストを表します。再生リストとは、順序を付けて表示し、他のユーザーと共有できる動画のコレクションを指します。再生リストには最大 200 本の動画を登録できます。また、各ユーザーが作成する再生リストの数に制限はありません。デフォルトでは再生リストは他のユーザーに一般公開されますが、一般公開または非公開にすることができます。

また、YouTube は再生リストを使用して、チャンネルの動画の特別なコレクションも識別します。以下に例を示します。

• アップロード動画
• 高く評価された動画
• 再生履歴
• 後で見る

このリソースの詳細については、リソース表現およびプロパティ一覧をご覧ください。

検索

検索結果には、API リクエストで指定された検索パラメータに一致する YouTube 動画、チャンネル、または再生リストに関する情報が含まれます。検索結果は動画などの一意に識別可能なリソースを指していますが、検索結果には固有の永続データはありません。

このリソースの詳細については、リソース表現およびプロパティ一覧をご覧ください。

サブスクリプション

subscription リソースには、YouTube ユーザーのチャンネル登録に関する情報が含まれます。subscription は、新しい動画がチャンネルに追加された場合や、別のユーザーが YouTube で動画のアップロード、動画の評価、動画へのコメントといった何らかの操作を行った場合に、ユーザーに通知します。

このリソースの詳細については、対応するリソース表現とプロパティのリストを参照してください。

サムネイル

thumbnail リソースは、リソースに関連付けられたさまざまなサムネイル画像サイズを識別します。サムネイル画像には次の特性があります。

• リソースの snippet.thumbnails プロパティは、そのリソースで使用できるサムネイル画像を識別するオブジェクトです。
• thumbnail リソースには、一連のオブジェクトが含まれます。各オブジェクトの名前（default、medium、high など）は、サムネイル画像のサイズを表します。
• さまざまな種類のリソースで、さまざまなサイズのサムネイル画像をサポートできます。
• さまざまな種類のリソースで、同じ名前のサムネイル画像に対してさまざまなサイズを定義できます。たとえば、video リソースの default サムネイル画像は通常 120 x 90 ピクセル、channel リソースの default サムネイル画像は通常 88 x 88 ピクセルです。
• 同じ種類のリソースで、元の画像や YouTube にアップロードされたコンテンツの解像度によって、特定の画像に対してさまざまなサイズのサムネイル画像を指定できます。たとえば HD 動画は、HD 以外の動画よりも高解像度のサムネイルをサポートできます。
• サムネイル画像のサイズに関する情報を含む各オブジェクトには、width プロパティと height プロパティがあります。ただし width と height のプロパティがその画像に対して返されないことがあります。
• アップロードされたサムネイル画像が必要な寸法に一致しない場合、その画像はアスペクト比を変更することなく、正しいサイズに合わせてサイズ変更されます。画像はトリミングされませんが、サイズが正しくなるように黒いバーが含まれる場合があります。

このリソースの詳細については、対応するリソース表現とプロパティのリストを参照してください。

VideoAbuseReportReasons

videoAbuseReportReason リソースには、動画に不適切なコンテンツが含まれるとしてフラグが付けられる理由に関する情報が含まれます。アプリが videos.reportAbuse メソッドを呼び出して不正な動画を報告する場合、このリクエストでは videoAbuseReportReason リソースからの情報を使用して、その動画が報告される理由を特定します。

このリソースの詳細については、リソース表現およびプロパティ一覧をご覧ください。

VideoCategories

videoCategory リソースは、アップロードされた動画に関連付けられている、または関連付けられている可能性のあるカテゴリを識別します。

このリソースの詳細については、リソース表現およびプロパティ一覧をご覧ください。

動画

video リソースは YouTube 動画を表します。

このリソースの詳細については、リソース表現およびプロパティ一覧をご覧ください。

ウォーターマーク

watermark リソースは、指定したチャンネルの動画の再生中に表示される画像を識別します。画像のリンク先ターゲット チャンネルや、動画の再生中に透かしを表示するタイミングとその長さを指定することもできます。

このリソースの詳細については、リソース表現およびプロパティ一覧をご覧ください。