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. Para o 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 do 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 que o site do YouTube suporta. 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 |
string Identifica o tipo de recurso da API. O valor será youtube#i18nRegion . |
etag |
etag A Etag desse recurso. |
id |
string O ID que o YouTube usa para identificar de forma exclusiva a região i18n. |
snippet |
object O objeto snippet contém detalhes básicos sobre a região i18n, como o código e o nome da região. |
snippet.gl |
string O código de país ISO de duas letras que identifica a região. |
snippet.name |
string O nome da região. |