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:
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 |
stringIdentifie le type de la ressource de l'API. La valeur sera youtube#i18nRegion. |
etag |
etagEtag de cette ressource. |
id |
stringID utilisé par YouTube pour identifier de manière unique la région d'internationalisation. |
snippet |
objectL'objet snippet contient des informations de base sur la région d'internationalisation, telles que son code et son nom. |
snippet.gl |
stringCode pays ISO à deux lettres identifiant la région. |
snippet.name |
stringNom de la région. |