로케일

번역되는 것

텍스트와 prose 필드는 레코드 최상위, 인라인 모델 안, 목록 항목 안, prose 필드에 배치된 모델 안 등 어디에 있든 로케일마다 값을 가집니다. 숫자, 날짜, 참조, 미디어를 포함한 다른 모든 필드 타입은 모든 로케일이 공유하는 하나의 값을 가집니다. 이미지 대체 텍스트는 이미지 값의 일부이므로 마찬가지로 공유됩니다.

로케일 설정

로케일은 프로젝트별로 설정하는 BCP-47 코드입니다. 하나는 기본값으로, 작성에 쓰는 언어이며, 각 로케일은 폴백 로케일을 지정할 수 있습니다. 프로젝트에 없는 로케일, 자기 자신, 또는 순환을 이루는 로케일을 가리키는 폴백은 저장할 때 거부됩니다.

번역은 콘솔의 레코드 에디터에서 작성하거나, AI 에이전트가 MCP를 통해 작성합니다. GraphQL API와 SDK는 번역을 읽기만 하고 쓰지 않습니다.

폴백 체인

읽기에 locale 인수를 전달하면 각 필드가 별도로 다음 순서로 결정됩니다. 요청한 로케일, 설정된 폴백이 차례로, 같은 문자 표기에 속하는 프로젝트의 가장 가까운 다른 로케일, 프로젝트 기본값, 작성된 값 순입니다. 값이 있는 첫 번째 것이 제공되므로, 일부만 번역된 레코드는 제목은 한 로케일에서, 본문은 다른 로케일에서 반환할 수 있습니다.

가장 가까운 일치 단계는 같은 문자 표기 안에서만 작동합니다. pt-PT 요청에 pt-BR 콘텐츠가 제공되는 것은 그 폴백을 직접 설정한 경우뿐입니다. 프로젝트에 설정하지 않은 로케일도 콘텐츠를 반환하며, 기본값에서 끝납니다.

누락 찾기

읽기에서 localeStrict 옵션을 설정하면 응답에 번역이 없던 필드가 나열되고, 설정되지 않은 로케일은 오류로 보고됩니다. resolutionTrace 옵션은 전체 탐색 과정을 반환하며 타기팅 디버그 스코프가 있는 키가 필요합니다. 어느 쪽도 제공되는 콘텐츠를 바꾸지 않습니다.