注: これは非推奨のお知らせです。
guideCategories
リソースと guideCategories.list
メソッドは、どちらも 2020 年 9 月 9 日に非推奨になりました。YouTube チャンネルに関連付けることができるカテゴリのリストを返します。
割り当てへの影響: このメソッドを呼び出すと、割り当てコストは 1 単位になります。
リクエスト
HTTP リクエスト
GET https://www.googleapis.com/youtube/v3/guideCategories
パラメータ
下記の表は、このクエリでサポートされているパラメータの一覧です。このリストのパラメータはすべてクエリ パラメータです。
パラメータ | ||
---|---|---|
必須パラメータ | ||
part |
string part パラメータでは、API レスポンスに含める guideCategory リソース プロパティを指定します。パラメータ値を snippet に設定します。 |
|
フィルタ(次のパラメータのいずれか 1 つのみを指定) | ||
id |
string id パラメータでは、取得するリソースの YouTube チャンネル カテゴリ ID をカンマ区切りのリストで指定します。guideCategory リソースでは、id プロパティに YouTube チャンネル カテゴリ ID を指定します。 |
|
regionCode |
string regionCode パラメータは、指定した国で利用可能なガイドカテゴリのリストを返すように API に指示します。パラメータ値は ISO 3166-1 alpha-2 の国コードです。 |
|
オプション パラメータ | ||
hl |
string hl パラメータは、API レスポンスのテキスト値に使用される言語を指定します。デフォルト値は en-US です。 |
リクエスト本文
このメソッドを呼び出す場合は、リクエストの本文を指定しないでください。
レスポンス
成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。
{ "kind": "youtube#guideCategoryListResponse", "etag": etag, "nextPageToken": string, "prevPageToken": string, "pageInfo": { "totalResults": integer, "resultsPerPage": integer }, "items": [ guideCategory resource ] }
プロパティ
次の表は、このリソースで使用されているプロパティの定義を示したものです。
プロパティ | |
---|---|
kind |
string API リソースのタイプを識別します。値は youtube#guideCategoryListResponse です。 |
etag |
etag このリソースの Etag。 |
nextPageToken |
string 結果セットの次のページを取得するために pageToken パラメータの値として使用できるトークン。 |
prevPageToken |
string 結果セットの前のページを取得するために、 pageToken パラメータの値として使用できるトークン。 |
pageInfo |
object pageInfo オブジェクトは、結果セットのページ情報をカプセル化します。 |
pageInfo.totalResults |
integer 結果セット内の結果の合計数。 |
pageInfo.resultsPerPage |
integer API レスポンスに含まれる結果の数。 |
items[] |
list YouTube チャンネルに関連付けることができるカテゴリのリスト。このマップでは、カテゴリ ID はマップキーであり、その値は対応する guideCategory リソースです。 |
エラー
次の表は、このメソッドを呼び出したときに API からレスポンスとして返される可能性のあるエラー メッセージの一覧です。詳細については、エラー メッセージのドキュメントを参照してください。
エラーのタイプ | エラーの詳細 | 説明 |
---|---|---|
notFound (404) |
notFound |
id パラメータで特定されたガイド カテゴリが見つかりません。有効な値のリストを取得するには、guideCategories.list メソッドを使用します。 |
実習
APIs Explorer を使用してこの API を呼び出し、API のリクエストとレスポンスを確認します。