payload.country segue as regras de países e os padrões de cada mecanismo. O Doubao sempre pergunta a partir da China continental. payload.state pergunta a partir de um estado dos EUA nos mecanismos compatíveis. Confira as regras de cada mecanismo abaixo antes do envio.
País
Envie um código ISO 3166-1 alfa-2 empayload.country:
400 VALIDATION_ERROR. O padrão e o significado de country dependem do mecanismo:
Países não suportados
Um partaskType e country que não pode ser atendido retorna 422 REGION_UNSUPPORTED no envio. Tentar de novo não adianta.
Leia
countries.policy de cada mecanismo em GET /v1/capabilities: only lista países aceitos e all_except lista exclusões. Commerce lista os países de todo o catálogo; cada requisição ainda precisa corresponder à sua loja ou URL de produto. A aceitação do país e o local de execução seguem as regras de cada mecanismo acima. O erro a seguir inclui a causa em details:
Estado dos EUA
Defina empayload.state o código de duas letras de um estado dos EUA para perguntar a partir desse estado. O mecanismo responde como a um usuário que está ali, então perguntas “perto de mim” trazem lugares desse estado. state acompanha country US, que também é o padrão. Esta requisição pergunta ao ChatGPT a partir do Texas:
O resultado devolve o mesmo código em
state. Uma tarefa com state custa 1 crédito a mais que o preço do mecanismo. Um código que não é um estado dos EUA, um country diferente de US ou state junto com uule retornam 400 VALIDATION_ERROR. GET /v1/states?country=US lista os 50 estados e DC.
uule do Google
GOOGLE_AIO, GOOGLE_AIMODE e GOOGLE_SERP também aceitam payload.uule, o parâmetro de localização do próprio Google, para sistemas que já guardam um por lugar. Envie o valor w+ exatamente como ele entra em uma URL de busca do Google. O Google o recebe sem alterações, então a página de resultados, o AI Overview e o AI Mode respondem para esse lugar, e country continua definindo o mercado. Esta requisição pergunta a partir de Austin, Texas:
uule. Envie uule ou state; uma requisição com os dois retorna 400 VALIDATION_ERROR, assim como um valor que não é um UULE w+, como o w%2B… codificado em porcentagem. Os outros mecanismos recusam o campo com 422 LOCATION_UNSUPPORTED.
GOOGLE_PLACES aceita uule da mesma forma ou, no lugar dele, city, um nome de lugar como "Reno, Nevada, United States". Cada página da lista é buscada a partir desse lugar.
Listar o que cada mecanismo atende
GET /v1/capabilities retorna cada taskType público com seus aliases, campos de entrada, preço, suporte a localização e política de países. Não exige chave de API, é lido das mesmas regras que validam os envios e pode ficar em cache por 5 minutos. Adicione ?taskType= para receber um único mecanismo; aliases são aceitos.
Um
taskType desconhecido retorna 400 VALIDATION_ERROR. Veja também a referência de capabilities.