읽을 때 결정

읽기 요청은 어떤 로케일과 컨텍스트를 원하는지, 초안을 원하는지를 알려 줍니다. 선택은 서버가 하며, 각 클라이언트는 요청한 필드에 완성된 값을 받습니다.

모든 읽기에 세 가지 인수

모델별 읽기는 단건이든 목록이든 locale, contexts, preview 세 가지 인수를 받습니다. 결정된 값은 타입 지정 필드에 바로 돌아옵니다. 타입 지정 SDK도 자체 호출에서 같은 세 가지를 받습니다.

필드별 로케일 폴백

번역 가능한 각 필드에 대해 서버는 순서가 있는 목록을 따라가며 처음 찾은 값을 제공합니다. 요청한 로케일, 설정된 폴백 체인, 같은 언어와 문자 체계에서 가장 가까운 항목, 프로젝트 기본값, 그다음 작성된 값입니다. 이 탐색은 필드별로 이루어지므로, 일부만 번역된 레코드는 같은 응답에서 제목은 한 로케일에서, 본문은 다른 로케일에서 반환할 수 있습니다. 로케일을 지정하지 않은 읽기는 작성된 값을 받습니다.

변형과 오디언스

contexts 인수는 타기팅 차원을 전달합니다. 기기, 플랫폼, 로케일은 기본 제공이며, 프로젝트 고유의 차원, 예를 들면 시장은 enum으로 타입이 지정됩니다. 서버는 로그인 상태와 세그먼트 소속을 로그인한 사용자의 액세스 토큰에서 도출합니다. 그런 다음 일치하는 변형 하나를 골라 그 값을 레코드에 병합합니다. 생략한 차원은 없는 것으로 처리되므로, 그 차원을 요구하는 규칙은 일치하지 않습니다. 개인화 페이지에서 예시를 단계별로 설명합니다.

초안 또는 게시됨

preview를 true로 설정하면 읽기는 게시된 버전 대신 최신 초안을 반환합니다. 이는 drafts:read 스코프를 가진 키에서 사용할 수 있습니다.

읽기가 어떻게 결정되었는지 확인하기

디버깅 스위치 두 가지는 읽기의 콘텐츠를 바꾸지 않고 읽기에 대해 보고합니다. localeStrict 옵션은 폴백이 일어난 필드를 나열합니다. resolutionTrace 옵션은 전체 탐색 과정을 반환하며, 타기팅 디버그 스코프를 가진 키에만 제공됩니다.

자세한 내용 보기

GraphQL 가이드에 locale, contexts, preview 인수와 각각이 결정하는 것이 문서화되어 있습니다.

문서의 콘텐츠 결정전체 기능