Nous mettons à jour l'API Data pour qu'elle corresponde à la façon dont YouTube comptabilise les vues des Shorts.
En savoir plus
I18nRegions
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Une ressource i18nRegion identifie une zone géographique qu'un utilisateur YouTube peut sélectionner comme région de contenu préférée. La région de contenu peut également être appelée "locale de contenu". Pour le site Web YouTube, une région de contenu peut être sélectionnée automatiquement en fonction d'heuristiques telles que le domaine YouTube ou la localisation de l'adresse IP de l'utilisateur. Un utilisateur peut également sélectionner manuellement la région de contenu souhaitée dans le pied de page du site YouTube.
Chaque ressource i18nRegion identifie un code de région et un nom. Le code de région peut être utilisé comme valeur du paramètre regionCode lorsque vous appelez des méthodes d'API telles que search.list, videos.list, activities.list et videoCategories.list.
Méthodes
L'API prend en charge les méthodes suivantes pour les ressources i18nRegions:
- liste
- Renvoie la liste des régions de contenu compatibles avec le site Web YouTube.
Essayer
Représentation de la ressource
La structure JSON suivante montre le format d'une ressource i18nRegions:
{
"kind": "youtube#i18nRegion",
"etag": etag,
"id": string,
"snippet": {
"gl": string,
"name": string
}
}
Propriétés
Le tableau suivant définit les propriétés qui apparaissent dans cette ressource:
| Propriétés |
kind |
string
Identifie le type de la ressource de l'API. La valeur sera youtube#i18nRegion. |
etag |
etag
Etag de cette ressource. |
id |
string
ID utilisé par YouTube pour identifier de manière unique la région d'internationalisation. |
snippet |
object
L'objet snippet contient des informations de base sur la région d'internationalisation, telles que son code et son nom. |
snippet.gl |
string
Code pays ISO à deux lettres identifiant la région. |
snippet.name |
string
Nom de la région. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/21 (UTC).
[null,null,["Dernière mise à jour le 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. |"]]
