Résolution à la lecture
Une lecture indique quelle locale et quel contexte elle veut, et si elle veut le brouillon. Le serveur fait le choix, et chaque client reçoit les valeurs finales sur les champs qu'il a demandés.
Trois arguments sur chaque lecture
Chaque lecture par modèle, au singulier ou en liste, prend trois arguments : locale, contexts et preview. Les valeurs résolues reviennent directement sur les champs typés. Le SDK typé prend les trois mêmes sur ses propres appels.
Repli de locale, champ par champ
Pour chaque champ traduisible, le serveur parcourt une liste ordonnée et sert la première valeur qu'il trouve : la valeur dans la locale, telle que demandée, puis dans sa chaîne de repli configurée, les correspondances les plus proches dans la même langue et le même script, la valeur par défaut du projet, puis la valeur d'origine. Comme le parcours se fait par champ, un enregistrement partiellement traduit peut renvoyer son titre depuis une locale et son corps depuis une autre dans la même réponse. Une lecture qui ne nomme aucune locale obtient les valeurs d'origine.
Variantes et audience
L'argument contexts porte les dimensions de ciblage. L'appareil, la plateforme et la locale sont intégrés, et les dimensions propres à votre projet, un marché par exemple, sont typées comme des enums. Le serveur déduit l'état de connexion et l'appartenance à un segment du jeton d'accès de l'utilisateur connecté. Il sélectionne ensuite la variante correspondante et fusionne ses valeurs sur l'enregistrement. Une dimension que vous omettez est absente, si bien qu'une règle qui l'exige ne correspond pas. La page personnalisation en donne un exemple détaillé.
Brouillon ou publié
Avec preview à true, une lecture renvoie le dernier brouillon à la place de la version publiée, pour une clé qui détient drafts:read comme portée.
Vérifier comment une lecture a été résolue
Deux interrupteurs de débogage rendent compte d'une lecture sans changer son contenu. localeStrict liste les champs qui se sont repliés. resolutionTrace renvoie le parcours complet, à une clé qui détient la portée de débogage du ciblage.
Lire le détail
Le guide GraphQL documente les arguments locale, contexts et preview et ce que chacun résout.