.JSON - Phrase Strings

컨텐츠는 영어 텍스트를 Phrase Language AI를 이용해 기계 번역한 것입니다.

파일 확장명	.json
API 확장	strings_json
가져오기	예
내보내기	예
복수형 지원	예
설명 지원	예
상태 지원	예
메타데이터 지원	예
형식 옵션	번역 상태 무시 번역 상태 내보내기 설명 내보내기 태그 내보내기 시스템 태그 내보내기 글자 제한 내보내기 custom_metadata_columns 서수 규칙 사용 내보내기

Phrase Strings JSON 형식은 번역을 저장하고 관리하는 구조화된 방법을 제공하며, 향상된 기능을 위해 메타데이터, 상태 추적 및 워크플로 통합을 포함합니다.

이 형식에는 현지화 세부 정보, 글자 제한, 설명, 복수형 유형 및 번역 상태와 같은 메타데이터가 포함됩니다. 상태 지원 기능을 통해 번역 진행 상황을 더 잘 추적하고 자동화된 워크플로와 통합할 수 있습니다.

필드 정의

키 객체

키 객체에는 각 번역 키에 대한 메타데이터와 설정이 포함되어 있습니다.

필드	필수	유형	설명
`이름`	예	문자열	키에 대한 고유 식별자입니다.
`description`	아니요	문자열	키의 목적에 대한 간략한 설명입니다.
`plural`	아니요	부울	키가 복수화를 지원하는지 여부를 지정합니다.
`use_ordinal_rules`	아니요	부울	키 복수 형태가 서수인지 여부를 나타냅니다. 생략하면 `false`(으)로 기본 설정됩니다. 가져오기 및 내보내기 중에 사용됩니다.
`max_characters_allowed`	아니요	정수/Null	허용되는 최대 문자 수입니다. `null`은(는) 제한이 없음을 의미합니다.
`tags`	아니요	정렬	필터링 및 조직을 위한 범주화 tags입니다.
`metadata`	아니요	객체	추가 메타데이터를 키-값 쌍으로 저장합니다. 추가하거나 업데이트할 수는 있지만 제거할 수는 없습니다. 메타데이터를 제거하려면 해당 값을 비어 있음 문자열로 설정하십시오.

번역 객체

번역 객체에는 특정 키에 대한 로캘별 번역이 포함되어 있습니다.

필드	필수	유형	설명
`로캘`	예	문자열	Project/Languages에 구성된 locale의 이름 또는 식별자입니다. 이 값은 가져오기 중 일치 항목을 결정합니다. 기존 언어 이름과 정확히 일치하지 않으면 번역이 가져오기 되지 않습니다.
`locale_code`	아니요	문자열	로캘의 언어 코드(예: en-US, fr-FR).
`컨텐츠`	예	문자열/객체	번역된 콘텐츠. 복수형인 경우 키의 `use_ordinal_rules` 설정에 따라 복수형을 매핑하는 객체입니다.
`상태`	아니요	문자열	번역 상태. 지원되는 번역 상태: 번역되지 않음 확인되지 않음 번역됨 검토됨

형식 옵션

식별자	번역 상태 무시
유형	부울
업로드	예
다운로드	아니요
기본값	false
설명	true이면 가져온 번역의 상태 값을 무시합니다. 즉, 업로드된 파일이 기존 번역 상태를 덮어쓰지 않습니다.

식별자	번역 상태 내보내기
유형	부울
업로드	아니요
다운로드	예
기본값	true
설명	내보낸 번역에 상태 값을 포함합니다. false로 설정하면 내보낸 파일에서 상태 정보가 생략됩니다.

식별자	시스템 태그 내보내기
유형	부울
업로드	아니요
다운로드	예
기본값	false
설명	true이면 키 및 번역과 함께 시스템 태그를 내보냅니다.

식별자	태그 내보내기
유형	부울
업로드	아니요
다운로드	예
기본값	false
설명	true이면 키 및 번역과 함께 태그를 내보냅니다.

식별자	설명 내보내기
유형	부울
업로드	아니요
다운로드	예
기본값	true
설명	키 설명을 내보냅니다.

식별자	글자 제한 내보내기
유형	부울
업로드	아니요
다운로드	예
기본값	true
설명	키 및 번역과 함께 키 글자 제한을 내보냅니다.

식별자	custom_metadata_columns
유형	해시
업로드	아니요
다운로드	예
기본값	[empty]
설명	가져오거나 내보내야 하는 사용자 지정 메타데이터 값의 HashMap: 키 = Phrase Strings에 정의된 사용자 지정 메타데이터 속성의 이름. 값 = 가져온 파일에서 속성이 있는 위치/내보낸 파일에서 속성이 있어야 하는 위치의 열 인덱스(1, 2, 3 등).

식별자	서수 규칙 사용 내보내기
유형	부울
업로드	아니요
다운로드	예
기본값	false
설명	true이면 `use_ordinal_rules` 필드가 다운로드된 파일에 표시됩니다. UI를 통해 파일을 다운로드하는 경우 해당 옵션 Add plural type for each key을(를) 사용하십시오.

코드 샘플

{
  "환영 문구": {
    "key": {
      "description": "환영 화면에 표시되는 메시지",
      "plural": false,
      "max_characters_allowed": 100,
      "tags": ["UI", "greeting"],
      "metadata": {
        "created_by": "관리자",
        "created_at": "2024-06-20T12:34:56Z"
      }
    },
    "번역": [
      {
        "로캘": "영어(미국)",
        "로캘_코드": "en-US",
        "콘텐츠": "저희 애플리케이션에 오신 것을 환영합니다!","
        "state": "검토됨"
      },
      {
        "로캘": "프랑스어(프랑스)",
        "로캘_코드": "fr-FR",
        "콘텐츠": "저희 애플리케이션에 오신 것을 환영합니다!"
        "state": "translated"
      }
    ]
  }
}

복수 형태

이 형식 기명된 범주를 사용하여 키 다양한 복수형을 식별합니다. 복수형에 대한 다음 범주는 예약되어 있습니다.

.zero | .one | .two | .few | .many | .other

올바르게 식별되고, 지속되고, 표시된 복수형 키의 예시명:

inbox.messages.notification.one
inbox.messages.notification.other

복수형 사용은 use_ordinal_rules 필드를 통해 설정됩니다. 사용_서수_규칙이(가) false이거나 설정되지 않은 경우, 기수 복수화 규칙이 적용됩니다.

예제 입력

{
  "rank": {
    "use_ordinal_rules": true,
    "values": {
      "one": "1위",
      "two": "2위",
      "few": "3위",
      "other": "%d위"
    }
  }