I18nRegions
Stay organized with collections
Save and categorize content based on your preferences.
An 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.
Each 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.
Methods
The API supports the following methods for i18nRegions resources:
- list
- Returns a list of content regions that the YouTube website supports.
Try it now.
Resource representation
The following JSON structure shows the format of a i18nRegions resource:
{
"kind": "youtube#i18nRegion",
"etag": etag,
"id": string,
"snippet": {
"gl": string,
"name": string
}
}
Properties
The following table defines the properties that appear in this resource:
| Properties |
kind |
string
Identifies the API resource's type. The value will be youtube#i18nRegion. |
etag |
etag
The Etag of this resource. |
id |
string
The ID that YouTube uses to uniquely identify the i18n region. |
snippet |
object
The snippet object contains basic details about the i18n region, such as its region code and name. |
snippet.gl |
string
The two-letter ISO country code that identifies the region. |
snippet.name |
string
The name of the region. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2022-11-04 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2022-11-04 UTC."],[[["An i18nRegion resource specifies a geographic area that YouTube users can choose as their preferred content region."],["The i18nRegion includes a region code and a name, and the code can be used when calling API methods such as `search.list`."],["The YouTube API's `i18nRegions.list` method allows retrieval of a list of supported content regions."],["Each i18nRegion resource includes an `id`, `etag`, and `snippet` containing the region code (`gl`) and region `name`."]]],["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"]]
