localización de suscripciones asc
Usa esta habilidad para crear o actualizar de forma masiva los nombres (y descripciones) de visualización de suscripciones, grupos de suscripción y compras integradas en todas las configuraciones regionales de App Store Connect. Esto elimina el tedioso proceso manual de hacer clic en cada idioma en App Store Connect para establecer el mismo nombre de visualización.
Precondiciones
- Autenticación configurada (
asc auth logino variables de entornoASC_*). - Conocer el ID de tu aplicación (
ASC_APP_IDo--app). - Los grupos de suscripción y las suscripciones ya deben existir.
Configuraciones regionales compatibles de App Store
Estas son las configuraciones regionales compatibles con App Store Connect para localizaciones de suscripciones y compras integradas:
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
Flujo de trabajo: Localización masiva de una suscripción
1. Resolver IDs
# Encontrar grupos de suscripción
asc subscriptions groups list --app "APP_ID" --output table
# Encontrar suscripciones dentro de un grupo
asc subscriptions list --group-id "GROUP_ID" --output table
2. Verificar localizaciones existentes
asc subscriptions localizations list --subscription-id "SUB_ID" --paginate --output table
Esto muestra qué configuraciones regionales ya tienen un nombre establecido. Solo crea localizaciones para las que falten.
3. Crear localizaciones para todas las configuraciones regionales faltantes
Para cada configuración regional que aún no tenga una localización, ejecuta:
asc subscriptions localizations create \
--subscription-id "SUB_ID" \
--locale "LOCALE" \
--name "Display Name"
Por ejemplo, para establecer "Monthly Pro" en todas las configuraciones regionales:
# Un comando por configuración regional (saltar las que ya existan)
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. Verificar
asc subscriptions localizations list --subscription-id "SUB_ID" --paginate --output table
Flujo de trabajo: Localización masiva de un grupo de suscripción
Los grupos de suscripción también tienen su propio nombre de visualización por configuración regional (este es el "nombre del grupo" que se muestra a los usuarios en la hoja de gestión de suscripciones).
1. Verificar localizaciones existentes del grupo
asc subscriptions groups localizations list --group-id "GROUP_ID" --paginate --output table
2. Crear para configuraciones regionales faltantes
asc subscriptions groups localizations create \
--group-id "GROUP_ID" \
--locale "LOCALE" \
--name "Group Display Name"
Opcional: establecer un nombre de aplicación personalizado para el grupo:
asc subscriptions groups localizations create \
--group-id "GROUP_ID" \
--locale "LOCALE" \
--name "Group Display Name" \
--custom-app-name "My App"
3. Verificar
asc subscriptions groups localizations list --group-id "GROUP_ID" --paginate --output table
Flujo de trabajo: Localización masiva de una compra integrada
Las compras integradas (IAP) tienen sus propios comandos de localización con el mismo patrón.
1. Resolver ID de la IAP
asc iap list --app "APP_ID" --output table
2. Verificar localizaciones existentes
asc iap localizations list --iap-id "IAP_ID" --paginate --output table
3. Crear para configuraciones regionales faltantes
asc iap localizations create \
--iap-id "IAP_ID" \
--locale "LOCALE" \
--name "Display Name"
Descripción opcional:
asc iap localizations create \
--iap-id "IAP_ID" \
--locale "LOCALE" \
--name "Unlock All Features" \
--description "One-time purchase to unlock all premium features"
4. Verificar
asc iap localizations list --iap-id "IAP_ID" --paginate --output table
Actualizar localizaciones existentes
Para cambiar el nombre de visualización de localizaciones existentes:
Suscripciones
asc subscriptions localizations update --id "LOC_ID" --name "New Name"
Grupos de suscripción
asc subscriptions groups localizations update --id "LOC_ID" --name "New Group Name"
Compras integradas
asc iap localizations update --id "LOC_ID" --name "New Name"
Para actualizar de forma masiva, primero lista las localizaciones existentes, extrae los IDs y luego actualiza cada una.
Localizar todas las suscripciones de una aplicación de forma masiva
Para una aplicación completa con múltiples grupos de suscripción y suscripciones:
# 1. Listar todos los grupos
asc subscriptions groups list --app "APP_ID" --paginate
# 2. Para cada grupo, localizar el grupo en sí
# (repetir el flujo de trabajo de localización de grupo anterior)
# 3. Para cada grupo, listar suscripciones
asc subscriptions list --group-id "GROUP_ID" --paginate
# 4. Para cada suscripción, localizarla
# (repetir el flujo de trabajo de localización de suscripción anterior)
Comportamiento del agente
- Siempre lista las localizaciones existentes primero para evitar errores de creación duplicada.
- Salta las configuraciones regionales que ya tengan una localización; solo crea las que falten.
- Cuando el usuario proporciona un solo nombre de visualización, úsalo para todas las configuraciones regionales (mismo nombre en todas partes).
- Cuando el usuario proporciona nombres traducidos por configuración regional, usa el nombre específico de cada configuración.
- Si se proporciona una descripción, pásala con
--descriptional crear. De lo contrario, omítela. - Usa
--output tableen los pasos de verificación para que el usuario pueda confirmar visualmente. - Usa la salida JSON predeterminada para pasos de automatización intermedios.
- Después de la creación masiva, siempre ejecuta el comando list para verificar la completitud.
- Para aplicaciones con muchas suscripciones, procésalas secuencialmente por grupo para mantener la salida legible.
- Si una llamada create falla para una configuración regional, registra la configuración regional y el error, y continúa con las restantes. Después de completar el lote, reporta todos los fallos juntos para que el usuario pueda solucionarlos.
Notas
- Los nombres de visualización de las suscripciones son lo que los usuarios ven en la hoja de gestión de suscripciones y en los diálogos de compra.
- Crear una localización para una configuración regional que ya existe fallará; siempre verifica primero.
- No existe una API masiva; cada configuración regional requiere una llamada create separada.
- Usa
--paginateen los comandos list para asegurarte de que se devuelvan todas las localizaciones existentes. - Usa la habilidad
asc-id-resolversi solo tienes nombres de aplicación en lugar de IDs.