# ローカリゼーション

ローカリゼーションをサポートする Stripe API の翻訳方法についてご紹介します。

サポート対象の API に合わせてローカライズされたコンテンツを提供することで、ユーザーの優先言語で情報を表示できます。

1. Stripe は、API グループの翻訳可能なフィールドを *XLIFF 2.0 形式* (XLIFF (XML Localization Interchange File Format) is a standardized format used to store and transfer localizable content between different translation and localization systems)で提供しています。
2. ターゲット言語のコンテンツをダウンロード・翻訳することができます。
3. ユーザーの場所に応じて翻訳されたコンテンツがアプリケーションで提供されるようなります。

## ローカライズ可能な API のシェイプ

ローカリゼーションをサポートするエンドポイントは、以下の例のように、自己翻訳された文字列を許可する新しいシェイプを API 内で公開します。

```json
{
 "localization_key": "payout_methods.bank_account.account_number",
 "content": "Account Number"
}
```

このシェイプは、次の 2 つのキーで構成されます。

- **localization\_key**: インテグレーターが各自のローカライゼーションバックエンドで使用して対応する翻訳を表示できる、言語固有のコンテンツを示します。
- **content**: キーに対応する翻訳済みのコピー。

## サポートされている API

[PayoutMethodsBankAccountSpec](https://docs.stripe.com/api/v2/money-management/payout-methods-bank-account-spec.md?api-version=2025-04-30.preview) エンドポイントを使用すると、ユーザーの銀行口座を登録するときに形式ラベルをローカライズできるようになります。

## XLIFF ファイルのダウンロード

Stripe は、翻訳可能なフィールドのリストを *XLIFF 2.0 形式* (XLIFF (XML Localization Interchange File Format) is a standardized format used to store and transfer localizable content between different translation and localization systems)で提供しています。フィールドにはそれぞれ、固定 ID キー (XLIFF ファイルのユニット ID)、英語の翻訳、コンテキストの説明が含まれています。

次の例は、XLIFF ファイル内の翻訳可能なフィールドを示しています。

```xml
<unit id="payout.methods_bank.account_account.number">
  <notes>
    <note id="n1">Form field label for bank account number.</note>
  </notes>
  <segment id="s1">
    <source>Account Number</source>
  </segment>
</unit>
```

次のファイルをローカリゼーションパイプラインに統合することで、翻訳者が説明で提供されるコンテキストに基づいてコンテンツを正確に翻訳できるようになります。

**資金管理のローカリゼーションファイル:** [stripe_api_localizations-money_movement.xlf](https://docs.stripecdn.com/a5c1f9ef04530fda8d4a3c0b1e2464d9f609214558d4b7b76c7739d3326308ca.xlf)

混合言語体験 (MLX) を回避するため、現在サービスを提供している国と今後提供予定の国のすべてについて、ファイル内のすべてのフィールドを翻訳してください。MLX とは、ユーザーが希望する言語で一部のフィールドしか表示されない状態を指します。これは、特定の国向けに一部のフィールドしか翻訳していない一方で、Stripe ではユーザーがすべてのフィールドに情報を入力する必要がある場合に発生する可能性があります。希望する言語で表示されるフィールドが少数のみで、その他のフィールドが米国英語 (Stripe のデフォルトの言語とロケール) で表示されると、ユーザーが混乱し、ビジネスへの信頼が低下するおそれがあります。

## ローカライズ可能な API に関する変更

Stripe は、ローカライズされた API が MLX の影響を受けないよう必要な保護を行っています。マイナーリリース中にローカライズされた API に新しいフィールドを追加する場合は、API でサポートしている現在の翻訳ファイルバージョンを再送信する必要があります。翻訳ファイルのバージョンが更新されるまで、API レスポンスで新しいフィールドは返されません。