Localização de assinaturas com asc
Use esta habilidade para criar ou atualizar em massa nomes de exibição (e descrições) para assinaturas, grupos de assinaturas e compras dentro do aplicativo em todos os idiomas do App Store Connect. Isso elimina o tedioso processo manual de clicar em cada idioma no App Store Connect para definir o mesmo nome de exibição.
Pré-condições
- Autenticação configurada (
asc auth loginou variáveis de ambienteASC_*). - Saiba o ID do seu aplicativo (
ASC_APP_IDou--app). - Grupos de assinaturas e assinaturas já existem.
Idiomas suportados pela App Store
Estes são os idiomas suportados pelo App Store Connect para localizações de assinaturas e IAPs:
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
Fluxo de trabalho: Localizar em massa uma assinatura
1. Resolver IDs
# Encontrar grupos de assinaturas
asc subscriptions groups list --app "APP_ID" --output table
# Encontrar assinaturas dentro de um grupo
asc subscriptions list --group "GROUP_ID" --output table
2. Verificar localizações existentes
asc subscriptions localizations list --subscription-id "SUB_ID" --paginate --output table
Isso mostra quais idiomas já possuem um nome definido. Crie localizações apenas para os idiomas ausentes.
3. Criar localizações para todos os idiomas ausentes
Para cada idioma que ainda não possui uma localização, execute:
asc subscriptions localizations create \
--subscription-id "SUB_ID" \
--locale "LOCALE" \
--name "Display Name"
Por exemplo, para definir "Monthly Pro" em todos os idiomas:
# Um comando por idioma (pule qualquer um que já exista)
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
Fluxo de trabalho: Localizar em massa um grupo de assinaturas
Grupos de assinaturas também têm seu próprio nome de exibição por idioma (este é o "nome do grupo" mostrado aos usuários na folha de gerenciamento de assinaturas).
1. Verificar localizações existentes do grupo
asc subscriptions groups localizations list --group-id "GROUP_ID" --paginate --output table
2. Criar para idiomas ausentes
asc subscriptions groups localizations create \
--group-id "GROUP_ID" \
--locale "LOCALE" \
--name "Group Display Name"
Opcional: definir um nome de aplicativo personalizado para o 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
Fluxo de trabalho: Localizar em massa uma compra dentro do aplicativo
Compras dentro do aplicativo (IAPs) têm seus próprios comandos de localização com o mesmo padrão.
1. Resolver ID da IAP
asc iap list --app "APP_ID" --output table
2. Verificar localizações existentes
asc iap localizations list --iap-id "IAP_ID" --paginate --output table
3. Criar para idiomas ausentes
asc iap localizations create \
--iap-id "IAP_ID" \
--locale "LOCALE" \
--name "Display Name"
Descrição opcional:
asc iap localizations create \
--iap-id "IAP_ID" \
--locale "LOCALE" \
--name "Desbloquear Todos os Recursos" \
--description "Compra única para desbloquear todos os recursos premium"
4. Verificar
asc iap localizations list --iap-id "IAP_ID" --paginate --output table
Atualizando Localizações Existentes
Para alterar o nome de exibição de localizações existentes:
Assinaturas
asc subscriptions localizations update --id "LOC_ID" --name "Novo Nome"
Grupos de Assinaturas
asc subscriptions groups localizations update --id "LOC_ID" --name "Novo Nome do Grupo"
Compras Dentro do Aplicativo
asc iap localizations update --id "LOC_ID" --name "Novo Nome"
Para atualizar em massa, primeiro liste as localizações existentes, extraia os IDs e depois atualize cada um.
Localizar em massa todas as assinaturas em um aplicativo
Para um aplicativo completo com vários grupos de assinaturas e assinaturas:
# 1. Listar todos os grupos
asc subscriptions groups list --app "APP_ID" --paginate
# 2. Para cada grupo, localize o próprio grupo
# (repita o fluxo de trabalho de localização do grupo acima)
# 3. Para cada grupo, liste as assinaturas
asc subscriptions list --group "GROUP_ID" --paginate
# 4. Para cada assinatura, localize-a
# (repita o fluxo de trabalho de localização de assinatura acima)
Comportamento do Agente
- Sempre liste as localizações existentes primeiro para evitar erros de criação duplicada.
- Pule idiomas que já possuem uma localização; crie apenas os ausentes.
- Quando o usuário fornecer um único nome de exibição, use-o para todos os idiomas (mesmo nome em todos os lugares).
- Quando o usuário fornecer nomes traduzidos por idioma, use o nome específico do idioma para cada um.
- Se uma descrição for fornecida, passe
--descriptionna criação. Caso contrário, omita-a. - Use
--output tablenas etapas de verificação para que o usuário possa confirmar visualmente. - Use a saída JSON padrão para etapas intermediárias de automação.
- Após a criação em massa, sempre execute o comando de lista para verificar a completude.
- Para aplicativos com muitas assinaturas, processe-as sequencialmente por grupo para manter a saída legível.
- Se uma chamada de criação falhar para um idioma, registre o idioma e o erro e continue com os idiomas restantes. Após o lote ser concluído, relate todas as falhas juntas para que o usuário possa resolvê-las.
Notas
- Os nomes de exibição das assinaturas são o que os usuários veem na folha de gerenciamento de assinaturas e nos diálogos de compra.
- Criar uma localização para um idioma que já existe falhará; sempre verifique primeiro.
- Não há API em lote; cada idioma requer uma chamada de criação separada.
- Use
--paginatenos comandos de lista para garantir que todas as localizações existentes sejam retornadas. - Use a habilidade
asc-id-resolverse você tiver apenas nomes de aplicativos em vez de IDs.