Localisation des abonnements avec asc
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 locales d'App Store Connect. Cela élimine le processus manuel fastidieux qui consiste à cliquer sur chaque langue dans App Store Connect pour définir le même nom d'affichage.
Prérequis
- Authentification configurée (
asc auth loginou variables d'environnementASC_*). - Connaître votre ID d'application (
ASC_APP_IDou--app). - Les groupes d'abonnements et les abonnements doivent déjà exister.
Locales prises en charge par l'App Store
Voici les locales prises en charge par App Store Connect pour la localisation des abonnements et des 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
Workflow : Localisation en masse d'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 "GROUP_ID" --output table
2. Vérifier les localisations existantes
asc subscriptions localizations list --subscription-id "SUB_ID" --paginate --output table
Cela montre quelles locales ont déjà un nom défini. Créez uniquement des localisations pour les locales manquantes.
3. Créer des localisations pour toutes les locales manquantes
Pour chaque locale qui n'a pas encore 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 locales :
# Une commande par locale (ignorez 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
Workflow : Localisation en masse d'un groupe d'abonnements
Les groupes d'abonnements ont aussi leur propre nom d'affichage par locale (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 locales 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
Workflow : Localisation en masse d'un achat intégré
Les achats intégrés (IAP) 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 locales 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
Mise à jour des localisations existantes
Pour modifier le nom d'affichage de 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 chacun.
Localiser en masse tous les abonnements d'une application
Pour une application 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 workflow de localisation du groupe ci-dessus)
# 3. Pour chaque groupe, lister les abonnements
asc subscriptions list --group "GROUP_ID" --paginate
# 4. Pour chaque abonnement, le localiser
# (répéter le workflow de localisation de l'abonnement ci-dessus)
Comportement de l'agent
- Listez toujours les localisations existantes en premier pour éviter les erreurs de création en double.
- Ignorez les locales qui ont déjà une localisation ; créez uniquement celles qui manquent.
- Lorsque l'utilisateur fournit un seul nom d'affichage, utilisez-le pour toutes les locales (même nom partout).
- Lorsque l'utilisateur fournit des noms traduits par locale, utilisez le nom spécifique à chaque locale.
- Si une description est fournie, transmettez
--descriptionlors de la création. Sinon, omettez-la. - Utilisez
--output tablepour les étapes de vérification afin que l'utilisateur puisse confirmer visuellement. - Utilisez la sortie JSON par défaut pour les étapes d'automatisation intermédiaires.
- Après une création en masse, exécutez toujours la commande list pour vérifier l'intégralité.
- Pour les applications avec de nombreux abonnements, traitez-les séquentiellement par groupe pour garder la sortie lisible.
- Si un appel de création échoue pour une locale, enregistrez la locale et l'erreur, puis continuez avec les locales restantes. Une fois le lot terminé, signalez tous les échecs ensemble afin que l'utilisateur puisse les traiter.
Remarques
- Les noms d'affichage des abonnements sont ceux que les utilisateurs voient dans la feuille de gestion des abonnements et dans les boîtes de dialogue d'achat.
- Créer une localisation pour une locale qui existe déjà échouera ; vérifiez toujours d'abord.
- Il n'existe pas d'API de traitement par lots ; chaque locale nécessite un appel de création séparé.
- Utilisez
--paginateavec les commandes list pour garantir que toutes les localisations existantes sont renvoyées. - Utilisez la compétence
asc-id-resolversi vous n'avez que des noms d'applications au lieu d'IDs.