asc subscription localization
Mit dieser Fähigkeit können Sie Anzeigenamen (und Beschreibungen) für Abonnements, Abonnementgruppen und In-App-Käufe in allen App Store Connect Locales massenerstellen oder -aktualisieren. Das mühsame manuelle Durchklicken jeder Sprache in App Store Connect entfällt.
Voraussetzungen
- Authentifizierung konfiguriert (
asc auth loginoderASC_*-Umgebungsvariablen). - Ihre App-ID kennen (
ASC_APP_IDoder--app). - Abonnementgruppen und Abonnements müssen bereits existieren.
Unterstützte App Store Locales
Dies sind die von App Store Connect für Abonnement- und IAP-Lokalisierungen unterstützten Locales:
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: Abonnement massenlokalisieren
1. IDs auflösen
# Abonnementgruppen finden
asc subscriptions groups list --app "APP_ID" --output table
# Abonnements innerhalb einer Gruppe finden
asc subscriptions list --group-id "GROUP_ID" --output table
2. Vorhandene Lokalisierungen prüfen
asc subscriptions localizations list --subscription-id "SUB_ID" --paginate --output table
Dies zeigt, für welche Locales bereits ein Name gesetzt ist. Erstellen Sie Lokalisierungen nur für fehlende Locales.
3. Lokalisierungen für alle fehlenden Locales erstellen
Führen Sie für jedes Locale, das noch keine Lokalisierung hat, Folgendes aus:
asc subscriptions localizations create \
--subscription-id "SUB_ID" \
--locale "LOCALE" \
--name "Anzeigename"
Um z. B. "Monthly Pro" in allen Locales zu setzen:
# Ein Befehl pro Locale (überspringen, falls bereits vorhanden)
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. Überprüfen
asc subscriptions localizations list --subscription-id "SUB_ID" --paginate --output table
Workflow: Abonnementgruppe massenlokalisieren
Abonnementgruppen haben ebenfalls einen eigenen Anzeigenamen pro Locale (der "Gruppenname", der dem Benutzer im Abonnementverwaltungsblatt angezeigt wird).
1. Vorhandene Gruppenlokalisierungen prüfen
asc subscriptions groups localizations list --group-id "GROUP_ID" --paginate --output table
2. Für fehlende Locales erstellen
asc subscriptions groups localizations create \
--group-id "GROUP_ID" \
--locale "LOCALE" \
--name "Gruppenanzeigename"
Optional: einen benutzerdefinierten App-Namen für die Gruppe festlegen:
asc subscriptions groups localizations create \
--group-id "GROUP_ID" \
--locale "LOCALE" \
--name "Gruppenanzeigename" \
--custom-app-name "Meine App"
3. Überprüfen
asc subscriptions groups localizations list --group-id "GROUP_ID" --paginate --output table
Workflow: In-App-Kauf massenlokalisieren
IAPs haben eigene Lokalisierungsbefehle mit demselben Muster.
1. IAP-ID auflösen
asc iap list --app "APP_ID" --output table
2. Vorhandene Lokalisierungen prüfen
asc iap localizations list --iap-id "IAP_ID" --paginate --output table
3. Für fehlende Locales erstellen
asc iap localizations create \
--iap-id "IAP_ID" \
--locale "LOCALE" \
--name "Anzeigename"
Optionale Beschreibung:
asc iap localizations create \
--iap-id "IAP_ID" \
--locale "LOCALE" \
--name "Alle Funktionen freischalten" \
--description "Einmaliger Kauf, um alle Premium-Funktionen freizuschalten"
4. Überprüfen
asc iap localizations list --iap-id "IAP_ID" --paginate --output table
Vorhandene Lokalisierungen aktualisieren
So ändern Sie den Anzeigenamen für vorhandene Lokalisierungen:
Abonnements
asc subscriptions localizations update --id "LOC_ID" --name "Neuer Name"
Abonnementgruppen
asc subscriptions groups localizations update --id "LOC_ID" --name "Neuer Gruppenname"
In-App-Käufe
asc iap localizations update --id "LOC_ID" --name "Neuer Name"
Um massenhaft zu aktualisieren, listen Sie zuerst die vorhandenen Lokalisierungen auf, extrahieren Sie die IDs und aktualisieren Sie dann jede einzelne.
Alle Abonnements einer App massenlokalisieren
Für eine vollständige App mit mehreren Abonnementgruppen und Abonnements:
# 1. Alle Gruppen auflisten
asc subscriptions groups list --app "APP_ID" --paginate
# 2. Für jede Gruppe die Gruppe selbst lokalisieren
# (Wiederholen Sie den Workflow zur Gruppenlokalisierung oben)
# 3. Für jede Gruppe die Abonnements auflisten
asc subscriptions list --group-id "GROUP_ID" --paginate
# 4. Jedes Abonnement lokalisieren
# (Wiederholen Sie den Workflow zur Abonnementlokalisierung oben)
Agentenverhalten
- Listen Sie immer zuerst die vorhandenen Lokalisierungen auf, um doppelte Erstellungsfehler zu vermeiden.
- Überspringen Sie Locales, die bereits eine Lokalisierung haben; erstellen Sie nur fehlende.
- Wenn der Benutzer einen einzelnen Anzeigenamen angibt, verwenden Sie ihn für alle Locales (gleicher Name überall).
- Wenn der Benutzer übersetzte Namen pro Locale angibt, verwenden Sie den localespezifischen Namen für jedes.
- Wenn eine Beschreibung angegeben ist, übergeben Sie
--descriptionbei der Erstellung. Andernfalls lassen Sie ihn weg. - Verwenden Sie
--output tablefür Überprüfungsschritte, damit der Benutzer visuell bestätigen kann. - Verwenden Sie die Standard-JSON-Ausgabe für automatisierte Zwischenschritte.
- Führen Sie nach der Massenerstellung immer den List-Befehl aus, um die Vollständigkeit zu überprüfen.
- Verarbeiten Sie bei Apps mit vielen Abonnements diese nacheinander pro Gruppe, um die Ausgabe lesbar zu halten.
- Wenn ein Create-Aufruf für ein Locale fehlschlägt, protokollieren Sie das Locale und den Fehler und fahren Sie mit den verbleibenden Locales fort. Melden Sie nach Abschluss des Batches alle Fehler gemeinsam, damit der Benutzer sie beheben kann.
Hinweise
- Anzeigenamen von Abonnements werden dem Benutzer im Abonnementverwaltungsblatt und in Kaufdialogen angezeigt.
- Das Erstellen einer Lokalisierung für ein bereits vorhandenes Locale schlägt fehl; prüfen Sie immer zuerst.
- Es gibt keine Bulk-API; jedes Locale erfordert einen separaten Create-Aufruf.
- Verwenden Sie
--paginatebei List-Befehlen, um sicherzustellen, dass alle vorhandenen Lokalisierungen zurückgegeben werden. - Verwenden Sie die Fähigkeit
asc-id-resolver, wenn Sie nur App-Namen anstelle von IDs haben.