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 "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 "GROUP_ID" --paginate
# 4. 各サブスクリプションについて、ローカライズ
# (上記のサブスクリプションローカライゼーションワークフローを繰り返す)
エージェントの動作
- 重複作成エラーを避けるため、常にまず既存のローカライゼーションを一覧表示します。
- すでにローカライゼーションがあるロケールはスキップし、不足しているものだけを作成します。
- ユーザーが 1 つの表示名を指定した場合は、すべてのロケールでその名前を使用します (すべて同じ名前)。
- ユーザーがロケールごとに翻訳された名前を指定した場合は、ロケール固有の名前を使用します。
- 説明が指定された場合は、作成時に
--descriptionを渡します。それ以外の場合は省略します。 - 確認手順では
--output tableを使用して、ユーザーが視覚的に確認できるようにします。 - 中間の自動化手順では、デフォルトの JSON 出力を使用します。
- 一括作成後、必ず list コマンドを実行して完全性を確認します。
- 多数のサブスクリプションがあるアプリの場合は、出力を見やすくするためにグループごとに順次処理します。
- 特定のロケールで create 呼び出しが失敗した場合は、そのロケールとエラーを記録し、残りのロケールで続行します。バッチ完了後、すべての失敗を報告してユーザーが対処できるようにします。
注記
- サブスクリプションの表示名は、サブスクリプション管理画面や購入ダイアログでユーザーに表示されるものです。
- すでに存在するロケールのローカライゼーションを作成しようとすると失敗します。必ず事前に確認してください。
- 一括 API はありません。各ロケールには個別の create 呼び出しが必要です。
- リストコマンドでは
--paginateを使用して、既存のすべてのローカライゼーションが返されるようにします。 - アプリ名のみがわかっていて ID がわからない場合は、
asc-id-resolverスキルを使用してください。