.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`	いいえ	オブジェクト	追加のメタデータをキーと値のペアとして保存します。追加または更新は可能ですが、削除はできません。メタデータを削除するには、その値を空欄の文字列に設定します。

翻訳オブジェクト

翻訳オブジェクトには、特定のキーに対するローカライズされた翻訳が含まれます。

フィールド	必須	種類	項目
`ロケール`	はい	文字列	プロジェクト/言語で設定されているロケールの名前または識別子。この値は、インポート中の一致を決定します。既存の言語名と完全に一致しない場合、翻訳はインポートされません。
`<locale_code>`	いいえ	文字列	ロケールの言語コード（例: en-US、fr-FR）。
`コンテンツ`	はい	文字列/オブジェクト	翻訳されたコンテンツ。複数形の場合、キーの`use_ordinal_rules`設定に基づく複数形をマッピングするオブジェクト。
`ステータス`	いいえ	文字列	翻訳の状態。サポートされている翻訳状態: 未翻訳未検証翻訳済レビュー済

ファイル形式オプション

識別子	翻訳状態を無視
タイプ	ブール
アップロード	はい
ダウンロード	いいえ
デフォルト	false
概要	trueの場合、インポートされた翻訳内の状態値を無視します。つまり、アップロードされたファイルは既存の翻訳状態を上書きしません。

識別子	翻訳状態をエクスポート
タイプ	ブール
アップロード	いいえ
ダウンロード	はい
デフォルト	true
概要	エクスポートされた翻訳に状態値を含めます。falseに設定されている場合、状態情報はエクスポートされたファイルから省略されます。

識別子	システムタグをエクスポート
タイプ	ブール
アップロード	いいえ
ダウンロード	はい
デフォルト	false
概要	trueの場合、キーおよび翻訳とともにシステムタグをエクスポートします。

識別子	タグをエクスポート
タイプ	ブール
アップロード	いいえ
ダウンロード	はい
デフォルト	false
概要	trueの場合、キーおよび翻訳とともにタグをエクスポートします。

識別子	説明をエクスポート
タイプ	ブール
アップロード	いいえ
ダウンロード	はい
デフォルト	true
概要	キーの説明をエクスポートします。

識別子	エクスポート文字数制限
タイプ	ブール
アップロード	いいえ
ダウンロード	はい
デフォルト	true
概要	キーの文字制限をキーおよび翻訳とともにエクスポートします。

識別子	custom_metadata_columns
タイプ	ハッシュ
アップロード	いいえ
ダウンロード	はい
デフォルト	[空白]
概要	インポートまたはエクスポートが必要なカスタムメタデータ値のHashMap: キー = Phrase Stringsで定義されたカスタムメタデータプロパティの名前。値 = インポートファイル内でプロパティが存在する列インデックス（1、2、3など）、またはエクスポートファイル内でプロパティが存在すべき列インデックス。

識別子	エクスポート順序ルール使用
タイプ	ブール
アップロード	いいえ
ダウンロード	はい
デフォルト	false
概要	trueの場合、`use_ordinal_rules`フィールドがダウンロードされたファイルに表示されます。 UI経由でファイルをダウンロードする場合は、対応するオプションAdd plural type for each keyを使用してください。

コードサンプル

{
  "welcome_message": {
    "key": {
      "description": "ウェルカム画面に表示されるメッセージ",
      "plural": false,
      "max_characters_allowed": 100,
      "tags": ["UI", "greeting"],
      "metadata": {
        "created_by": "管理者",
        "created_at": "2024-06-20T12:34:56Z"
      }
    },
    "翻訳": [
      {
        "ロケール": "英語 (アメリカ)",
        "ロケール_code": "en-US",
        "コンテンツ": "アプリケーションへようこそ！",
        "state": "レビュー済"
      },
      {
        "ロケール": "フランス語 (フランス)",
        "ロケール_コード": "fr-FR",
        "コンテンツ": "アプリへようこそ！"
        "state": "translated"
      }
    ]
  }
}

複数形

ファイル形式では、名前付きカテゴリを使用して、キーのさまざまな複数形を識別します。以下のカテゴリは複数形用に予約されています。

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

複数化されたキーを正しく識別、持続、マークするための名前の例：

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

複数形の形式は、use_ordinal_rulesフィールドを通じて使用されます。use_ordinal_rules が false または未設定の場合、基数複数形規則が適用されます。

入力例

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