语言区域
文本和正文字段可以为每个语言区域保存一个值。读取时请求一种语言,回退链决定对没有该语言翻译的任何字段提供什么。
哪些内容可翻译
文本和正文字段无论位于何处,都为每个语言区域保存一个值:记录顶层、内联模型内、列表项中,或放在正文字段里的模型中。其他所有字段类型,包括数字、日期、引用和媒体,都只有一个所有语言区域共享的值。图像的替代文本属于图像值的一部分,所以也是共享的。
设置语言区域
语言区域是按项目配置的 BCP-47 代码。其中一个是默认值,即你撰写内容所用的语言,每个语言区域都可以指定一个回退语言区域。如果回退指向项目中不存在的语言区域、指向自身或形成循环,保存时会被拒绝。
翻译在控制台的记录编辑器中写入,或由 AI 智能体通过 MCP 写入。GraphQL API 和 SDK 读取翻译,但不写入翻译。
回退链
在读取时传入 locale 后,每个字段会分别按以下顺序解析:你请求的语言区域、它配置的各个回退语言区域依次、项目中同一书写语言下最接近的其他语言区域、项目默认值,然后是撰写时的值。第一个有值的会被提供,因此一条部分翻译的记录可以从一个语言区域返回标题,从另一个返回正文。
最接近匹配这一步限定在同一书写标准内:对 pt-PT 的请求,只有你自己设置了该回退,才会得到 pt-BR 的内容。项目未配置的语言区域仍会返回内容,最终回退到默认值。
找出缺口
在读取时设置 localeStrict 后,响应会列出没有翻译的字段,并把未配置的语言区域报告为错误。resolutionTrace 会返回整个过程,并需要带有定向调试作用域的密钥。两者都不会改变所提供的内容。