asc subscription localization
Utilisez cette compétence pour créer ou mettre à jour en masse les noms d'affichage (et descriptions) des abonnements, groupes d'abonnements et achats intégrés dans toutes les langues d'App Store Connect. Cela élimine le processus manuel fastidieux de cliquer sur chaque langue dans App Store Connect pour définir le même nom d'affichage.
Prérequis
- Auth configurée (
asc auth loginou variables d'environnementASC_*). - Connaître votre ID d'app (
ASC_APP_IDou--app). - Les groupes d'abonnements et abonnements existent déjà.
Langues supportées par l'App Store
Voici les langues supportées par App Store Connect pour les localisations d'abonnements et d'achats intégrés :
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
Flux de travail : Localiser en masse un abonnement
1. Résoudre les IDs
# Trouver les groupes d'abonnements
asc subscriptions groups list --app "APP_ID" --output table
# Trouver les abonnements dans un groupe
asc subscriptions list --group-id "GROUP_ID" --output table
2. Vérifier les localisations existantes
asc subscriptions localizations list --subscription-id "SUB_ID" --paginate --output table
Ceci montre quelles langues ont déjà un nom défini. Créez uniquement des localisations pour les langues manquantes.
3. Créer les localisations pour toutes les langues manquantes
Pour chaque langue qui n'a pas déjà de localisation, exécutez :
asc subscriptions localizations create \
--subscription-id "SUB_ID" \
--locale "LOCALE" \
--name "Nom d'affichage"
Par exemple, pour définir "Monthly Pro" dans toutes les langues :
# Une commande par langue (ignorer celles qui existent déjà)
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. Vérifier
asc subscriptions localizations list --subscription-id "SUB_ID" --paginate --output table
Flux de travail : Localiser en masse un groupe d'abonnements
Les groupes d'abonnements ont également leur propre nom d'affichage par langue (c'est le « nom du groupe » affiché aux utilisateurs dans la feuille de gestion des abonnements).
1. Vérifier les localisations existantes du groupe
asc subscriptions groups localizations list --group-id "GROUP_ID" --paginate --output table
2. Créer pour les langues manquantes
asc subscriptions groups localizations create \
--group-id "GROUP_ID" \
--locale "LOCALE" \
--name "Nom d'affichage du groupe"
Optionnel : définir un nom d'application personnalisé pour le groupe :
asc subscriptions groups localizations create \
--group-id "GROUP_ID" \
--locale "LOCALE" \
--name "Nom d'affichage du groupe" \
--custom-app-name "Mon App"
3. Vérifier
asc subscriptions groups localizations list --group-id "GROUP_ID" --paginate --output table
Flux de travail : Localiser en masse un achat intégré
Les achats intégrés ont leurs propres commandes de localisation avec le même modèle.
1. Résoudre l'ID de l'IAP
asc iap list --app "APP_ID" --output table
2. Vérifier les localisations existantes
asc iap localizations list --iap-id "IAP_ID" --paginate --output table
3. Créer pour les langues manquantes
asc iap localizations create \
--iap-id "IAP_ID" \
--locale "LOCALE" \
--name "Nom d'affichage"
Description optionnelle :
asc iap localizations create \
--iap-id "IAP_ID" \
--locale "LOCALE" \
--name "Débloquer toutes les fonctionnalités" \
--description "Achat unique pour débloquer toutes les fonctionnalités premium"
4. Vérifier
asc iap localizations list --iap-id "IAP_ID" --paginate --output table
Mettre à jour les localisations existantes
Pour modifier le nom d'affichage des localisations existantes :
Abonnements
asc subscriptions localizations update --id "LOC_ID" --name "Nouveau nom"
Groupes d'abonnements
asc subscriptions groups localizations update --id "LOC_ID" --name "Nouveau nom du groupe"
Achats intégrés
asc iap localizations update --id "LOC_ID" --name "Nouveau nom"
Pour une mise à jour en masse, listez d'abord les localisations existantes, extrayez les IDs, puis mettez à jour chacune.
Localiser en masse tous les abonnements d'une app
Pour une app complète avec plusieurs groupes d'abonnements et abonnements :
# 1. Lister tous les groupes
asc subscriptions groups list --app "APP_ID" --paginate
# 2. Pour chaque groupe, localiser le groupe lui-même
# (répéter le flux de travail de localisation de groupe ci-dessus)
# 3. Pour chaque groupe, lister les abonnements
asc subscriptions list --group-id "GROUP_ID" --paginate
# 4. Pour chaque abonnement, le localiser
# (répéter le flux de travail de localisation d'abonnement ci-dessus)
Comportement de l'agent
- Lister toujours les localisations existantes en premier pour éviter les erreurs de création en double.
- Ignorer les langues qui ont déjà une localisation ; créer uniquement celles manquantes.
- Lorsque l'utilisateur fournit un seul nom d'affichage, l'utiliser pour toutes les langues (même nom partout).
- Lorsque l'utilisateur fournit des noms traduits par langue, utiliser le nom spécifique à la langue pour chaque.
- Si une description est fournie, passer
--descriptionlors de la création. Sinon, l'omettre. - Utiliser
--output tablepour les étapes de vérification afin que l'utilisateur puisse confirmer visuellement. - Utiliser la sortie JSON par défaut pour les étapes d'automatisation intermédiaires.
- Après la création en masse, toujours exécuter la commande list pour vérifier l'exhaustivité.
- Pour les applications avec de nombreux abonnements, les traiter séquentiellement par groupe pour garder la sortie lisible.
- Si un appel de création échoue pour une langue, enregistrer la langue et l'erreur, puis continuer avec les langues restantes. Après la fin du lot, signaler tous les échecs ensemble afin que l'utilisateur puisse y remédier.
Remarques
- Les noms d'affichage des abonnements sont ce que les utilisateurs voient dans la feuille de gestion des abonnements et dans les dialogues d'achat.
- Créer une localisation pour une langue qui existe déjà échouera ; vérifiez toujours d'abord.
- Il n'y a pas d'API de création en masse ; chaque langue nécessite un appel de création séparé.
- Utilisez
--paginatesur les commandes list pour vous assurer que toutes les localisations existantes sont renvoyées. - Utilisez la compétence
asc-id-resolversi vous n'avez que des noms d'app au lieu d'IDs.