asc 訂閱在地化
使用此技能可跨所有 App Store Connect 地區批量建立或更新訂閱項目、訂閱群組與 App 內購買的顯示名稱(及描述)。這能消除在 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 "顯示名稱"
例如,要跨所有地區設定「每月專業版」:
# 每個地區一個指令(跳過已存在的地區)
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
工作流程:批量在地化 App 內購買
App 內購買 (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 "新群組名稱"
App 內購買
asc iap localizations update --id "LOC_ID" --name "新名稱"
若要批量更新,請先列出現有在地化資料,擷取 ID,然後逐一更新。
批量在地化應用程式中的所有訂閱項目
針對包含多個訂閱群組與訂閱項目的完整應用程式:
# 1. 列出所有群組
asc subscriptions groups list --app "APP_ID" --paginate
# 2. 針對每個群組,在地化群組本身
# (重複上述群組在地化工作流程)
# 3. 針對每個群組,列出訂閱項目
asc subscriptions list --group "GROUP_ID" --paginate
# 4. 針對每個訂閱項目,進行在地化
# (重複上述訂閱在地化工作流程)
代理行為
- 一律先列出現有在地化資料,以避免重複建立的錯誤。
- 跳過已有在地化資料的地區;僅建立缺少的。
- 當使用者提供單一顯示名稱時,將其用於所有地區(各處使用相同名稱)。
- 當使用者提供每個地區的翻譯名稱時,對每個地區使用對應的地區特定名稱。
- 若提供了描述,則在建立時傳入
--description。否則忽略它。 - 驗證步驟使用
--output table,讓使用者可以視覺確認。 - 中間自動化步驟使用預設的 JSON 輸出。
- 批量建立後,一律執行 list 指令以驗證完整性。
- 對於包含許多訂閱項目的應用程式,按群組依序處理以保持輸出可讀性。
- 如果某個地區的 create 呼叫失敗,請記錄該地區和錯誤,然後繼續處理其餘地區。在批次完成後,一併回報所有失敗,以便使用者處理。
備註
- 訂閱顯示名稱是使用者在訂閱管理頁面和購買對話框中看到的內容。
- 為已存在的地區建立在地化資料將會失敗;請務必先檢查。
- 沒有批量 API;每個地區需要個別的 create 呼叫。
- 在 list 指令上使用
--paginate以確保傳回所有現有在地化資料。 - 如果您只有應用程式名稱而沒有 ID,請使用
asc-id-resolver技能。