Localización de suscripciones asc
Usa esta habilidad para crear o actualizar de forma masiva los nombres visibles (y descripciones) de suscripciones, grupos de suscripciones y compras integradas en todos los idiomas 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 visible.
Precondiciones
- Autenticación configurada (
asc auth logino variables de entornoASC_*). - Conocer el ID de tu aplicación (
ASC_APP_IDo--app). - Los grupos de suscripciones y las suscripciones ya deben existir.
Idiomas admitidos en App Store
Estos son los idiomas que App Store Connect soporta para las localizaciones de suscripciones e 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
Flujo de trabajo: Localización masiva de una suscripción
1. Resolver IDs
# Encontrar grupos de suscripciones
asc subscriptions groups list --app "APP_ID" --output table
# Encontrar suscripciones dentro de un grupo
asc subscriptions list --group "GROUP_ID" --output table
2. Verificar localizaciones existentes
asc subscriptions localizations list --subscription-id "SUB_ID" --paginate --output table
Esto muestra qué idiomas ya tienen un nombre establecido. Solo crea localizaciones para los idiomas que faltan.
3. Crear localizaciones para todos los idiomas faltantes
Para cada idioma que aún no tenga una localización, ejecuta:
asc subscriptions localizations create \
--subscription-id "SUB_ID" \
--locale "LOCALE" \
--name "Nombre visible"
Por ejemplo, para establecer "Mensual Pro" en todos los idiomas:
# Un comando por idioma (salta los que ya existan)
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ar-SA" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ca" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "cs" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "da" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "de-DE" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "el" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-AU" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-CA" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-GB" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "es-ES" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "es-MX" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fi" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fr-CA" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fr-FR" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "he" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hi" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hr" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hu" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "id" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "it" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ja" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ko" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ms" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "nl-NL" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "no" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pl" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pt-BR" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pt-PT" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ro" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ru" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "sk" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "sv" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "th" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "tr" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "uk" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "vi" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "zh-Hans" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "zh-Hant" --name "Mensual Pro"
4. Verificar
asc subscriptions localizations list --subscription-id "SUB_ID" --paginate --output table
Flujo de trabajo: Localización masiva de un grupo de suscripciones
Los grupos de suscripciones también tienen su propio nombre visible por idioma (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 los idiomas faltantes
asc subscriptions groups localizations create \
--group-id "GROUP_ID" \
--locale "LOCALE" \
--name "Nombre visible del grupo"
Opcional: establecer un nombre de aplicación personalizado para el grupo:
asc subscriptions groups localizations create \
--group-id "GROUP_ID" \
--locale "LOCALE" \
--name "Nombre visible del grupo" \
--custom-app-name "Mi 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 (IAP)
Las compras integradas tienen sus propios comandos de localización con el mismo patrón.
1. Resolver ID de 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 los idiomas faltantes
asc iap localizations create \
--iap-id "IAP_ID" \
--locale "LOCALE" \
--name "Nombre visible"
Descripción opcional:
asc iap localizations create \
--iap-id "IAP_ID" \
--locale "LOCALE" \
--name "Desbloquear todas las funciones" \
--description "Compra única para desbloquear todas las funciones premium"
4. Verificar
asc iap localizations list --iap-id "IAP_ID" --paginate --output table
Actualizar localizaciones existentes
Para cambiar el nombre visible de localizaciones existentes:
Suscripciones
asc subscriptions localizations update --id "LOC_ID" --name "Nuevo nombre"
Grupos de suscripciones
asc subscriptions groups localizations update --id "LOC_ID" --name "Nuevo nombre del grupo"
Compras integradas
asc iap localizations update --id "LOC_ID" --name "Nuevo nombre"
Para actualizar de forma masiva, primero lista las localizaciones existentes, extrae los IDs y luego actualiza cada uno.
Localización masiva de todas las suscripciones en una aplicación
Para una aplicación completa con múltiples grupos de suscripciones y suscripciones:
# 1. Listar todos los grupos
asc subscriptions groups list --app "APP_ID" --paginate
# 2. Para cada grupo, localizar el propio grupo
# (repetir el flujo de trabajo de localización de grupos anterior)
# 3. Para cada grupo, listar suscripciones
asc subscriptions list --group "GROUP_ID" --paginate
# 4. Para cada suscripción, localizarla
# (repetir el flujo de trabajo de localización de suscripciones anterior)
Comportamiento del agente
- Siempre lista primero las localizaciones existentes para evitar errores de creación duplicados.
- Omite los idiomas que ya tienen una localización; solo crea las que faltan.
- Cuando el usuario proporciona un único nombre visible, úsalo para todos los idiomas (mismo nombre en todas partes).
- Cuando el usuario proporciona nombres traducidos por idioma, usa el nombre específico del idioma para cada uno.
- Si se proporciona una descripción, pasa
--descriptional crear. En caso contrario, omítelo. - Usa
--output tablepara 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 integridad.
- Para aplicaciones con muchas suscripciones, procésalas secuencialmente por grupo para mantener la salida legible.
- Si una llamada de creación falla para un idioma, registra el idioma y el error, luego continúa con los idiomas restantes. Después de que el lote se complete, informa todos los fallos juntos para que el usuario pueda solucionarlos.
Notas
- Los nombres visibles 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 un idioma que ya existe fallará; siempre verifica primero.
- No existe una API masiva; cada idioma requiere una llamada de creación separada.
- Usa
--paginateen los comandos list para asegurar que se devuelvan todas las localizaciones existentes. - Usa la habilidad
asc-id-resolversi solo tienes nombres de aplicaciones en lugar de IDs.