Resueltas en la lectura
Una lectura indica qué locale y qué contexto quiere y si quiere el borrador. El servidor hace la elección, y cada cliente recibe los valores ya resueltos en los campos que pidió.
Tres argumentos en cada lectura
Toda lectura por modelo, singular o de lista, admite tres argumentos: locale, contexts y preview. Los valores resueltos llegan directamente en los campos tipados. El SDK tipado admite los mismos tres en sus propias llamadas.
Reserva de locale, campo por campo
Para cada campo traducible, el servidor recorre una lista ordenada y sirve el primer valor que encuentra: el locale, el solicitado, su cadena de reserva configurada, las coincidencias más cercanas en el mismo idioma y escritura, el predeterminado del proyecto y, por último, el valor original. Como el recorrido es por campo, un registro traducido solo en parte puede devolver su título de un locale y su cuerpo de otro en la misma respuesta. Una lectura que no nombra ningún locale recibe los valores originales.
Variantes y público
El argumento contexts lleva las dimensiones de segmentación. Dispositivo, plataforma y locale están integrados, y las dimensiones propias de tu proyecto, un mercado por ejemplo, se tipan como enums. El servidor deduce el estado de inicio de sesión y la pertenencia a un segmento a partir del token de acceso del usuario con sesión iniciada. Después selecciona la variante que coincide y combina sus valores sobre el registro. Una dimensión que omites queda ausente, así que una regla que la exige no coincide. La página de personalización recorre un ejemplo.
Borrador o publicado
Con preview en true, una lectura devuelve el último borrador en lugar de la versión publicada, para una clave que tenga drafts:read como alcance.
Comprobar cómo se resolvió una lectura
Dos interruptores de depuración informan sobre una lectura sin cambiar su contenido. localeStrict lista los campos que recurrieron a la reserva. resolutionTrace devuelve el recorrido completo, a una clave que tenga el alcance de depuración de segmentación.
Lee el detalle
La guía de GraphQL documenta los argumentos locale, contexts y preview y lo que resuelve cada uno.