asc サブスクリプションローカライズ
このスキルを使用すると、すべてのApp Store Connectロケールに対して、サブスクリプション、サブスクリプショングループ、およびアプリ内課金の表示名(および説明)を一括作成または一括更新できます。これにより、App Store Connectで各言語をクリックして同じ表示名を設定するという面倒な手作業を排除します。
前提条件
- 認証設定済み(
asc auth loginまたはASC_*環境変数) - アプリIDが分かっていること(
ASC_APP_IDまたは--app) - サブスクリプショングループとサブスクリプションが既に存在していること
サポートされているApp Storeロケール
以下は、App Store ConnectでサブスクリプションおよびIAPのローカライズにサポートされているロケールです。
ar-SA, ca, cs, da, de-DE, el, en-AU, en-CA, en-GB, en-US,
es-ES, es-MX, fi, fr-CA, fr-FR, he, hi, hr, hu, id, it,
ja, ko, ms, nl-NL, no, pl, pt-BR, pt-PT, ro, ru, sk,
sv, th, tr, uk, vi, zh-Hans, zh-Hant
ワークフロー: サブスクリプションの一括ローカライズ
1. IDの確認
# サブスクリプショングループを検索
asc subscriptions groups list --app "APP_ID" --output table
# グループ内のサブスクリプションを検索
asc subscriptions list --group-id "GROUP_ID" --output table
2. 既存のローカライズを確認
asc subscriptions localizations list --subscription-id "SUB_ID" --paginate --output table
これにより、どのロケールに既に名前が設定されているかが表示されます。不足しているロケールに対してのみローカライズを作成します。
3. 不足しているすべてのロケールにローカライズを作成
まだローカライズがない各ロケールに対して、以下を実行します。
asc subscriptions localizations create \
--subscription-id "SUB_ID" \
--locale "LOCALE" \
--name "Display Name"
例えば、すべてのロケールに「Monthly Pro」を設定する場合:
# ロケールごとに1コマンド(既に存在するものはスキップ)
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ar-SA" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ca" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "cs" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "da" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "de-DE" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "el" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-AU" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-CA" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-GB" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "es-ES" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "es-MX" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fi" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fr-CA" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fr-FR" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "he" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hi" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hr" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hu" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "id" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "it" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ja" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ko" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ms" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "nl-NL" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "no" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pl" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pt-BR" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pt-PT" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ro" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ru" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "sk" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "sv" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "th" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "tr" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "uk" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "vi" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "zh-Hans" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "zh-Hant" --name "Monthly Pro"
4. 確認
asc subscriptions localizations list --subscription-id "SUB_ID" --paginate --output table
ワークフロー: サブスクリプショングループの一括ローカライズ
サブスクリプショングループにも、ロケールごとに独自の表示名があります(これは、サブスクリプション管理画面でユーザーに表示される「グループ名」です)。
1. 既存のグループローカライズを確認
asc subscriptions groups localizations list --group-id "GROUP_ID" --paginate --output table
2. 不足しているロケールに作成
asc subscriptions groups localizations create \
--group-id "GROUP_ID" \
--locale "LOCALE" \
--name "Group Display Name"
オプション: グループにカスタムアプリ名を設定
asc subscriptions groups localizations create \
--group-id "GROUP_ID" \
--locale "LOCALE" \
--name "Group Display Name" \
--custom-app-name "My App"
3. 確認
asc subscriptions groups localizations list --group-id "GROUP_ID" --paginate --output table
ワークフロー: アプリ内課金の一括ローカライズ
IAPにも同じパターンのローカライズコマンドがあります。
1. IAP IDの確認
asc iap list --app "APP_ID" --output table
2. 既存のローカライズを確認
asc iap localizations list --iap-id "IAP_ID" --paginate --output table
3. 不足しているロケールに作成
asc iap localizations create \
--iap-id "IAP_ID" \
--locale "LOCALE" \
--name "Display Name"
説明のオプション:
asc iap localizations create \
--iap-id "IAP_ID" \
--locale "LOCALE" \
--name "Unlock All Features" \
--description "One-time purchase to unlock all premium features"
4. 確認
asc iap localizations list --iap-id "IAP_ID" --paginate --output table
既存のローカライズの更新
既存のローカライズの表示名を変更するには:
サブスクリプション
asc subscriptions localizations update --id "LOC_ID" --name "New Name"
サブスクリプショングループ
asc subscriptions groups localizations update --id "LOC_ID" --name "New Group Name"
アプリ内課金
asc iap localizations update --id "LOC_ID" --name "New Name"
一括更新するには、まず既存のローカライズを一覧表示し、IDを抽出してから、それぞれを更新します。
アプリ内のすべてのサブスクリプションを一括ローカライズ
複数のサブスクリプショングループとサブスクリプションを持つアプリ全体の場合:
# 1. すべてのグループを一覧表示
asc subscriptions groups list --app "APP_ID" --paginate
# 2. 各グループに対して、グループ自体をローカライズ
# (上記のグループローカライズワークフローを繰り返す)
# 3. 各グループに対して、サブスクリプションを一覧表示
asc subscriptions list --group-id "GROUP_ID" --paginate
# 4. 各サブスクリプションをローカライズ
# (上記のサブスクリプションローカライズワークフローを繰り返す)
エージェントの動作
- 常に既存のローカライズを最初に一覧表示して、重複作成エラーを回避します。
- 既にローカライズがあるロケールはスキップし、不足しているものだけを作成します。
- ユーザーが単一の表示名を指定した場合は、すべてのロケールでそれを使用します(全ロケールで同じ名前)。
- ユーザーがロケールごとに翻訳された名前を指定した場合は、各ロケール固有の名前を使用します。
- 説明が提供された場合は、作成時に
--descriptionを渡します。それ以外の場合は省略します。 - 確認手順では
--output tableを使用して、ユーザーが視覚的に確認できるようにします。 - 中間の自動化手順では、デフォルトのJSON出力を使用します。
- 一括作成後、常にリストコマンドを実行して完全性を確認します。
- 多くのサブスクリプションがあるアプリの場合は、グループごとに順次処理して、出力を見やすく保ちます。
- ロケールの作成呼び出しが失敗した場合は、そのロケールとエラーをログに記録し、残りのロケールで続行します。バッチが完了した後、すべての失敗をまとめて報告して、ユーザーが対処できるようにします。
注意事項
- サブスクリプションの表示名は、ユーザーがサブスクリプション管理画面や購入ダイアログで見る名前です。
- 既に存在するロケールに対してローカライズを作成しようとすると失敗します。必ず事前に確認してください。
- 一括APIはありません。各ロケールに個別の作成呼び出しが必要です。
- リストコマンドで
--paginateを使用して、すべての既存のローカライズが返されるようにします。 - アプリ名のみが分かっている場合は、
asc-id-resolverスキルを使用してIDを解決してください。