Um recurso i18nRegion identifica uma área geográfica que um usuário do YouTube pode selecionar como a região de conteúdo preferida. A região de conteúdo também pode ser chamada de localidade de conteúdo. No site do YouTube, uma região de conteúdo pode ser selecionada automaticamente com base em heurísticas, como o domínio do YouTube ou o local do IP do usuário. O usuário também pode selecionar manualmente a região de conteúdo desejada no rodapé do site do YouTube.
Cada recurso i18nRegion identifica um código de região e um nome. O código da região pode ser usado como o valor do parâmetro regionCode ao chamar métodos de API como search.list, videos.list, activities.list e videoCategories.list.
Métodos
A API oferece suporte aos seguintes métodos para recursos i18nRegions:
- list
- Retorna uma lista de regiões de conteúdo compatíveis com o site do YouTube. Faça um teste agora.
Representação de recurso
A estrutura JSON a seguir mostra o formato de um recurso i18nRegions:
{
"kind": "youtube#i18nRegion",
"etag": etag,
"id": string,
"snippet": {
"gl": string,
"name": string
}
}Propriedades
A tabela a seguir define as propriedades que aparecem neste recurso:
| Propriedades | |
|---|---|
kind |
stringIdentifica o tipo do recurso da API. O valor será youtube#i18nRegion. |
etag |
etagA Etag deste recurso. |
id |
stringO ID que o YouTube usa para identificar exclusivamente a região de internacionalização. |
snippet |
objectO objeto snippet contém detalhes básicos sobre a região de localização internacional, como o código e o nome da região. |
snippet.gl |
stringO código do país ISO de duas letras que identifica a região. |
snippet.name |
stringO nome da região. |