Communitygithub.com

asc サブスクリプションローカライズ

asc を使用して、すべての App Store ロケールのサブスクリプションとアプリ内課金の表示名を一括ローカライズします。App Store Connect を手動で操作することなく、各言語のサブスクリプション/IAP 名を設定したい場合に使用します。

asc サブスクリプションローカライズ とは?

このスキルは、App Store Connect のサブスクリプション、サブスクリプショングループ、およびアプリ内課金 (IAP) の表示名 (および説明) を、サポートされているすべてのロケールに対して一括で作成または更新するためのものです。開発者は、App Store Connect の Web インターフェースで各言語をクリックして同じ表示名を設定するという面倒な手作業を排除できます。このスキルは、`asc` コマンドラインツールを使用し、事前に認証 (`asc auth login` または環境変数 `ASC_*`) とアプリ ID (`ASC_APP_ID`) が設定されていることを前提としています。ワークフローでは、まず既存のローカライゼーションを一覧表示して重複作成を防ぎ、次に不足しているロケールごとに `asc subscriptions localizations create`、`asc subscriptions groups localizations create`、`asc iap localizations create` コマンドを実行します。一括更新機能も提供しており、既存のローカライゼーションの名前を変更する場合には `update` コマンドを使用します。このスキルは、すべてのロケールで同じ表示名を使用する場合も、ロケールごとに翻訳された名前を使用する場合もサポートし、作成後の検証手順も含まれています。Claude Code、Cursor、Codex などの AI エージェントで使用できるように設計されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/exiao/skills/tree/HEAD/app-store/app-store-connect/subscription-localization

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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 スキルを使用してください。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

関連スキル