Resolvido na leitura
Uma leitura informa qual locale e contexto ela quer e se quer o rascunho. O servidor faz a escolha, e cada cliente recebe os valores finais nos campos que pediu.
Três argumentos em toda leitura
Toda leitura por modelo, singular ou de lista, aceita três argumentos: locale, contexts e preview. Os valores resolvidos voltam diretamente nos campos tipados. O SDK tipado aceita os mesmos três em suas próprias chamadas.
Fallback de locale, campo a campo
Para cada campo traduzível, o servidor percorre uma lista ordenada e serve o primeiro valor que encontra: o locale, conforme pedido, seguido da sua cadeia de fallback configurada, das correspondências mais próximas no mesmo idioma e escrita, do padrão do projeto e, por fim, do valor original. Como a busca é por campo, um registro parcialmente traduzido pode devolver o título de um locale e o corpo de outro na mesma resposta. Uma leitura que não indica locale recebe os valores originais.
Variantes e público
O argumento contexts carrega as dimensões de segmentação. Dispositivo, plataforma e locale são nativos, e as dimensões do seu projeto, um mercado por exemplo, são tipadas como enums. O servidor deduz o status de login e a participação em segmentos a partir do token de acesso do usuário logado. Em seguida seleciona a variante correspondente e mescla seus valores no registro. Uma dimensão que você omite fica ausente, então uma regra que a exige não corresponde. A página de personalização percorre um exemplo.
Rascunho ou publicado
Com preview definido como true, uma leitura devolve o rascunho mais recente no lugar da versão publicada, para uma chave com drafts:read no escopo.
Verificando como uma leitura foi resolvida
Duas chaves de depuração informam sobre uma leitura sem alterar seu conteúdo. localeStrict lista os campos que usaram fallback. resolutionTrace devolve o percurso completo, para uma chave que tenha o escopo de depuração de segmentação.
Leia os detalhes
O guia do GraphQL documenta os argumentos locale, contexts e preview e o que cada um resolve.