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 "표시 이름"
예를 들어, 모든 로케일에 "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 "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 "표시 이름"
선택적 설명:
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 "GROUP_ID" --paginate
# 4. 각 구독에 대해 현지화
# (위의 구독 현지화 워크플로 반복)
에이전트 동작
- 항상 기존 현지화를 먼저 나열하여 중복 생성 오류를 방지합니다.
- 이미 현지화가 있는 로케일은 건너뛰고 누락된 것만 생성합니다.
- 사용자가 단일 표시 이름을 제공하면 모든 로케일에 동일한 이름을 사용합니다.
- 사용자가 로케일별로 번역된 이름을 제공하면 각 로케일에 해당하는 이름을 사용합니다.
- 설명이 제공되면 생성 시
--description을 전달하고, 그렇지 않으면 생략합니다. - 확인 단계에서는
--output table을 사용하여 사용자가 시각적으로 확인할 수 있도록 합니다. - 중간 자동화 단계에서는 기본 JSON 출력을 사용합니다.
- 대량 생성 후에는 항상 list 명령을 실행하여 완전성을 확인합니다.
- 구독이 많은 앱의 경우 그룹별로 순차적으로 처리하여 출력을 읽기 쉽게 유지합니다.
- 특정 로케일에 대해 create 호출이 실패하면 로케일과 오류를 기록하고 나머지 로케일을 계속 처리합니다. 배치 완료 후 모든 실패를 함께 보고하여 사용자가 처리할 수 있도록 합니다.
참고 사항
- 구독 표시 이름은 사용자가 구독 관리 시트와 구매 대화상자에서 보게 되는 이름입니다.
- 이미 존재하는 로케일에 대해 현지화를 생성하면 실패합니다. 항상 먼저 확인하십시오.
- 대량 API는 없습니다. 각 로케일마다 별도의 create 호출이 필요합니다.
- list 명령에
--paginate를 사용하여 모든 기존 현지화가 반환되도록 보장합니다. - ID 대신 앱 이름만 있는 경우
asc-id-resolver스킬을 사용하십시오.