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 "표시 이름"
예를 들어, 모든 로케일에 "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 "내 앱"
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를 추출한 다음 각각을 업데이트하세요.
앱의 모든 구독 대량 로컬라이제이션
여러 구독 그룹과 구독이 있는 전체 앱의 경우:
# 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를 사용하여 기존 로컬라이제이션이 모두 반환되도록 합니다. - 앱 이름만 있고 ID가 없는 경우
asc-id-resolver스킬을 사용하세요.