localização de assinatura asc
Use esta skill para criar ou atualizar em massa nomes de exibição (e descrições) para assinaturas, grupos de assinaturas e compras dentro do aplicativo em todas as localidades do App Store Connect. Isso elimina o processo manual tedioso 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á existentes.
Localidades suportadas pelo App Store
Estas são as localidades suportadas 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-id "GROUP_ID" --output table
2. Verificar localizações existentes
asc subscriptions localizations list --subscription-id "SUB_ID" --paginate --output table
Isso mostra quais localidades já possuem um nome definido. Crie localizações apenas para as localidades ausentes.
3. Criar localizações para todas as localidades ausentes
Para cada localidade 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 todas as localidades:
# Um comando por localidade (pule qualquer uma 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 possuem seu próprio nome de exibição por localidade (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 localidades 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 (IAP)
IAPs possuem seus próprios comandos de localização com o mesmo padrão.
1. Resolver o ID do 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 localidades 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 "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
Atualizando Localizações Existentes
Para alterar o nome de exibição de localizações existentes:
Assinaturas
asc subscriptions localizations update --id "LOC_ID" --name "New Name"
Grupos de Assinaturas
asc subscriptions groups localizations update --id "LOC_ID" --name "New Group Name"
Compras Dentro do Aplicativo
asc iap localizations update --id "LOC_ID" --name "New Name"
Para atualizar em massa, primeiro liste as localizações existentes, extraia os IDs e depois atualize cada uma.
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, localizar o próprio grupo
# (repita o fluxo de trabalho de localização de grupo acima)
# 3. Para cada grupo, listar assinaturas
asc subscriptions list --group-id "GROUP_ID" --paginate
# 4. Para cada assinatura, localizá-la
# (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 as localidades que já possuem uma localização; crie apenas as que estão faltando.
- Quando o usuário fornecer um único nome de exibição, use-o para todas as localidades (mesmo nome em todos os lugares).
- Quando o usuário fornecer nomes traduzidos por localidade, use o nome específico da localidade para cada uma.
- Se uma descrição for fornecida, passe
--descriptionna criação. Caso contrário, omita. - Use
--output tablepara etapas de verificação para que o usuário possa confirmar visualmente. - Use a saída JSON padrão para etapas automatizadas intermediárias.
- Após a criação em massa, sempre execute o comando de listagem 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 uma localidade, registre a localidade e o erro e continue com as localidades restantes. Após o lote ser concluído, reporte 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 uma localidade que já existe falhará; sempre verifique primeiro.
- Não há uma API em massa; cada localidade requer uma chamada de criação separada.
- Use
--paginatenos comandos de listagem para garantir que todas as localizações existentes sejam retornadas. - Use a skill
asc-id-resolverse você tiver apenas nomes de aplicativos em vez de IDs.