Locales
Text- und Prosa-Felder können für jede Locale einen Wert enthalten. Ein Lesezugriff fragt eine Sprache an, und eine Rückfallkette entscheidet, was für jedes Feld ausgeliefert wird, das darin keine Übersetzung hat.
Was übersetzt wird
Felder vom Typ Text und Prosa enthalten pro Locale einen Wert, wo auch immer sie sitzen: auf oberster Ebene eines Datensatzes, in einem Inline-Modell, in einem Listenelement oder in einem Modell, das in einem Prosa-Feld platziert ist. Jeder andere Feldtyp, einschließlich Zahlen, Daten, Referenzen und Medien, hat einen Wert, den alle Locales teilen. Der Alt-Text eines Bilds ist Teil des Bildwerts und wird daher ebenfalls geteilt.
Locales einrichten
Locales sind BCP-47-Codes, die pro Projekt konfiguriert werden. Eine ist die Standard-Locale, die Sprache, in der Sie schreiben, und jede kann eine Rückfall-Locale benennen. Ein Rückfall, der eine Locale nennt, die das Projekt nicht hat, auf sich selbst zeigt oder eine Schleife schließt, wird beim Speichern abgelehnt.
Übersetzungen schreiben Sie im Datensatz-Editor der Konsole, oder ein KI-Agent schreibt sie über MCP. Die GraphQL-API und das SDK lesen Übersetzungen und schreiben sie nicht.
Die Rückfallkette
Übergeben Sie locale bei einem Lesezugriff, und jedes Feld wird einzeln aufgelöst, in dieser Reihenfolge: die angefragte Locale, ihre konfigurierten Rückfälle der Reihe nach, die nächstverwandten anderen Locales des Projekts in derselben Schriftsprache, die Standard-Locale des Projekts, dann der ursprünglich verfasste Wert. Der erste mit einem Wert wird ausgeliefert, sodass ein teilweise übersetzter Datensatz seinen Titel aus einer Locale und seinen Text aus einer anderen liefern kann.
Der Schritt zur nächstverwandten Locale bleibt innerhalb eines Schriftstandards: Eine Anfrage für pt-PT wird nur dann mit pt-BR-Texten bedient, wenn Sie diesen Rückfall selbst festlegen. Eine Locale, die das Projekt nicht konfiguriert hat, liefert trotzdem Inhalte und endet bei der Standard-Locale.
Lücken finden
Setzen Sie localeStrict bei einem Lesezugriff, und die Antwort listet die Felder auf, die keine Übersetzung hatten, und meldet eine nicht konfigurierte Locale als Fehler. resolutionTrace gibt den gesamten Weg zurück und erfordert einen Schlüssel mit dem Targeting-Debug-Scope. Keines von beiden ändert die ausgelieferten Inhalte.
Details nachlesen
Der Lokalisierungsleitfaden behandelt Locale-Einstellungen, die Rückfallreihenfolge sowie die Strict- und Trace-Optionen, mit denen sich prüfen lässt, was ein Lesezugriff ausgeliefert bekam.