I18nRegions
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
i18nRegion
リソースは、YouTube ユーザーが優先コンテンツ リージョンとして選択できる地理的エリアを識別します。コンテンツの地域は、コンテンツの言語 / 地域とも呼ばれます。YouTube ウェブサイトの場合、YouTube ドメインやユーザーの IP ロケーションなどのヒューリスティクスに基づいてコンテンツ リージョンが自動的に選択される場合があります。ユーザーは、YouTube サイトのフッターから目的のコンテンツ リージョンを手動で選択することもできます。
各 i18nRegion
リソースは、リージョン コードと名前を識別します。リージョン コードは、search.list
、videos.list
、activities.list
、videoCategories.list
などの API メソッドを呼び出すときに、regionCode
パラメータの値として使用できます。
メソッド
この API は、i18nRegions
リソースの次のメソッドをサポートしています。
- list
- YouTube ウェブサイトがサポートするコンテンツ リージョンのリストを返します。今すぐ試す
リソース表現
次の JSON 構造は、i18nRegions
リソースの形式を示しています。
{
"kind": "youtube#i18nRegion",
"etag": etag,
"id": string,
"snippet": {
"gl": string,
"name": string
}
}
プロパティ
次の表は、このリソースで使用されているプロパティの定義を示したものです。
プロパティ |
kind |
string
API リソースのタイプを識別します。値は youtube#i18nRegion になります。 |
etag |
etag
このリソースの Etag。 |
id |
string
YouTube が i18n 地域を一意に識別するために使用する ID。 |
snippet |
object
snippet オブジェクトには、地域コードや名前など、I18n 地域に関する基本的な詳細情報が含まれています。 |
snippet.gl |
string
地域を識別する 2 文字の ISO 国コード。 |
snippet.name |
string
リージョンの名前。 |
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-08-21 UTC。
[null,null,["最終更新日 2025-08-21 UTC。"],[[["\u003cp\u003eAn i18nRegion resource specifies a geographic area that YouTube users can choose as their preferred content region.\u003c/p\u003e\n"],["\u003cp\u003eThe i18nRegion includes a region code and a name, and the code can be used when calling API methods such as \u003ccode\u003esearch.list\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe YouTube API's \u003ccode\u003ei18nRegions.list\u003c/code\u003e method allows retrieval of a list of supported content regions.\u003c/p\u003e\n"],["\u003cp\u003eEach i18nRegion resource includes an \u003ccode\u003eid\u003c/code\u003e, \u003ccode\u003eetag\u003c/code\u003e, and \u003ccode\u003esnippet\u003c/code\u003e containing the region code (\u003ccode\u003egl\u003c/code\u003e) and region \u003ccode\u003ename\u003c/code\u003e.\u003c/p\u003e\n"]]],["The `i18nRegion` resource represents a YouTube content region, selectable by users or automatically determined. Each resource has a unique ID, region code, and name. The region code is usable in API methods like `search.list`. The resource can be retrieved via the `i18nRegions.list` method, which provides the supported content regions. The resource's properties include `kind` (`youtube#i18nRegion`), `etag`, `id`, and a `snippet` object containing the region's code (`gl`) and name.\n"],null,["# I18nRegions\n\nAn **i18nRegion** resource identifies a geographic area that a YouTube user can select as the preferred content region. The content region can also be referred to as a content locale. For the YouTube website, a content region could be automatically selected based on heuristics like the YouTube domain or the user's IP location. A user could also manually select the desired content region from the YouTube site footer. \n\nEach `i18nRegion` resource identifies a region code and a name. The region code can be used as the value of the `regionCode` parameter when calling API methods like `search.list`, `videos.list`, `activities.list`, and `videoCategories.list`.\n\nMethods\n-------\n\nThe API supports the following methods for `i18nRegions` resources:\n\n[list](/youtube/v3/docs/i18nRegions/list)\n: Returns a list of content regions that the YouTube website supports.\n [Try it now](/youtube/v3/docs/i18nRegions/list#usage).\n\nResource representation\n-----------------------\n\nThe following JSON structure shows the format of a `i18nRegions` resource: \n\n```text\n{\n \"kind\": \"youtube#i18nRegion\",\n \"etag\": etag,\n \"id\": string,\n \"snippet\": {\n \"gl\": string,\n \"name\": string\n }\n}\n```\n\n### Properties\n\nThe following table defines the properties that appear in this resource:\n\n| Properties ||\n|----------------|---------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies the API resource's type. The value will be `youtube#i18nRegion`. |\n| `etag` | `etag` The Etag of this resource. |\n| `id` | `string` The ID that YouTube uses to uniquely identify the i18n region. |\n| `snippet` | `object` The `snippet` object contains basic details about the i18n region, such as its region code and name. |\n| snippet.`gl` | `string` The two-letter ISO country code that identifies the region. |\n| snippet.`name` | `string` The name of the region. |"]]