asc subscription localization
使用此技能在 App Store Connect 的所有語系中大量建立或更新訂閱項目、訂閱群組與應用程式內購買的顯示名稱(與描述),省去逐一透過各語言介面手動設定的繁瑣流程。
前置條件
- 已設定認證(
asc auth login或ASC_*環境變數)。 - 知道您的 App 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 "顯示名稱"
例如,將「Monthly Pro」設定到所有語系:
# 每個語系一個指令(跳過已存在的)
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 "群組顯示名稱"
可選擇為群組設定自訂應用程式名稱:
asc subscriptions groups localizations create \
--group-id "GROUP_ID" \
--locale "LOCALE" \
--name "群組顯示名稱" \
--custom-app-name "我的 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 "顯示名稱"
可選的描述:
asc iap localizations create \
--iap-id "IAP_ID" \
--locale "LOCALE" \
--name "解鎖所有功能" \
--description "一次性購買,解鎖所有進階功能"
4. 驗證
asc iap localizations list --iap-id "IAP_ID" --paginate --output table
更新現有本地化項目
若要變更現有本地化項目的顯示名稱:
訂閱項目
asc subscriptions localizations update --id "LOC_ID" --name "新名稱"
訂閱群組
asc subscriptions groups localizations update --id "LOC_ID" --name "新群組名稱"
應用程式內購買
asc iap localizations update --id "LOC_ID" --name "新名稱"
若要大量更新,請先列出現有本地化項目,取出其 ID,然後逐一更新。
大量本地化 App 中的所有訂閱項目
若整個 App 含有多個訂閱群組與訂閱項目:
# 1. 列出所有群組
asc subscriptions groups list --app "APP_ID" --paginate
# 2. 針對每個群組,本地化該群組本身
# (重複上方群組本地化流程)
# 3. 針對每個群組,列出其訂閱項目
asc subscriptions list --group-id "GROUP_ID" --paginate
# 4. 針對每個訂閱項目,進行本地化
# (重複上方訂閱本地化流程)
代理程式行為
- 一律先列出現有本地化項目,避免重複建立錯誤。
- 跳過已有本地化的語系,僅建立缺少的項目。
- 若使用者提供單一顯示名稱,則套用至所有語系(各語系使用相同名稱)。
- 若使用者提供各語系的翻譯名稱,則分別使用對應的名稱。
- 若有提供描述,則在建立時傳入
--description,否則省略。 - 驗證步驟使用
--output table以便使用者視覺確認。 - 中間自動化步驟使用預設的 JSON 輸出。
- 大量建立完成後,務必執行列表指令驗證完整性。
- 對於含有多個訂閱項目的 App,依序按群組處理,以保持輸出可讀性。
- 若某語系的建立呼叫失敗,記錄該語系與錯誤,然後繼續處理其餘語系。批次完成後,彙整所有失敗資訊,讓使用者能夠處理。
備註
- 訂閱項目的顯示名稱會出現在使用者的訂閱管理頁面與購買對話框內。
- 為已存在的語系建立本地化項目會失敗,請務必先檢查。
- 沒有批次 API,每個語系需個別呼叫建立。
- 在列表指令中使用
--paginate以確保回傳所有現有本地化項目。 - 若您只有 App 名稱而非 ID,請使用
asc-id-resolver技能進行解析。