Änderungen

Mit den Bearbeitungsmethoden der Google Play Developer Publishing API kannst du eine Reihe von Änderungen an deiner Google Play-App vorbereiten und alle gleichzeitig bereitstellen. Dazu erstellen Sie eine Änderung mit allen Änderungen, die Sie an der Anwendung vornehmen möchten. Die Änderung enthält folgende Informationen:

• Die mit der App verknüpften APKs und ein "Track" für jedes APK.

  Jeder ist mit einem „Track“ verknüpft, der bestimmt, welche Nutzer sie sehen. So können Sie Ihren Testern Alpha- und Betaversionen der App zur Verfügung stellen. Darüber hinaus können Sie eine Version der App mit gestaffeltem Roll-out mit begrenzter Veröffentlichung bereitstellen. Diese App wird automatisch für eine begrenzte Anzahl von Nutzern der App bereitgestellt (basierend auf dem von Ihnen festgelegten Einführungsprozentsatz), sodass Sie eine neue Produktionsversion der App schrittweise bereitstellen können.

• Sprach- und sprachspezifische Versionen des Google Play Store-Eintrags

  Jede länderspezifische Version des Store-Eintrags kann Screenshots und andere Werbegrafiken, lokalisierten beschreibenden Text usw. enthalten.

Hinweis :Nicht alle von der Google Play Developer API bereitgestellten Methoden verwenden die neue, transaktionale „Bearbeitungsfunktion“. Methoden für die Ressourcen inappproducts, products und subscriptions werden sofort wirksam, unabhängig davon, ob für die Anwendung eine offene Änderung vorliegt. Auf der API-Referenzseite jeder Ressource wird angegeben, ob für die Methoden für diese Ressource das Modell „Edits“ verwendet wird.

Wenn Sie zum ersten Mal eine Änderung erstellen, ist die Änderung eine Kopie des aktuellen bereitgestellten Status der Anwendung. Sie können die Änderung dann ändern, indem Sie die Bearbeitungsmethoden aufrufen. Wenn die Änderung fertig ist, führen Sie einen Commit durch, wodurch die Änderungen live geschaltet werden. Sie können die Bearbeitung auch jederzeit abbrechen, indem Sie die Änderungen verwerfen und die Anwendung unverändert lassen.

Sie können diese API nur verwenden, um Änderungen an einer vorhandenen App vorzunehmen, für die mindestens ein APK hochgeladen wurde. Sie müssen daher mindestens ein APK über die Play Console hochladen, bevor Sie diese API verwenden können. Außerdem können Sie diese API nicht verwenden, um den Status einer App von „veröffentlicht“ zu „nicht veröffentlicht“ zu ändern oder um die für die Veröffentlichung erforderlichen rechtlichen Einwilligungen auszufüllen. Zum Veröffentlichen der App musst du die Play Console verwenden.

Achtung :Wenn jemand über die Google Play Console Änderungen an der App vornimmt, während eine Bearbeitung läuft, wird Ihre Änderung verworfen und die Änderungen in der Play Console werden wirksam.

Workflow

In diesem Abschnitt wird beschrieben, wie du mit den Bearbeitungsmethoden der Google Play Developer Publishing API Änderungen an einer App vornimmst.

1. Erstellen Sie eine neue Änderung, indem Sie Bearbeitungen: Einfügen aufrufen und die Anwendung angeben, die Sie ändern möchten.

   Dadurch wird eine neue Bearbeitung der angegebenen App erstellt. Die Anfangseinstellungen der App, also APKs, Store-Einträge, Erweiterungsdateien usw., werden alle aus der bereitgestellten Version der App kopiert.

2. Ändern Sie die Bearbeitung wie gewünscht.

   Die meisten Änderungen kannst du über die Google Play Console vornehmen. Dazu rufen Sie die entsprechende Google Play Developer API-Methode auf und übergeben die IDs der App und der Bearbeitung, die Sie ändern möchten. Insbesondere:

   • Sie können neue APKs durch Aufrufen von Edits.apks: upload hochladen. Dadurch wird das APK in einem Speicherbereich gespeichert, sodass es in dieser oder einer späteren Bearbeitung einem Track zugewiesen werden kann.
   • Sie können APKs zu Tracks zuweisen, indem Sie Edits.tracks: update aufrufen. Sie können die Trackzuweisungen für vorhandene APKs auch ändern, indem Sie Edits.tracks: patch aufrufen.
   • Sie können einen neuen lokalisierten Store-Eintrag erstellen, indem Sie Edits.listings: update aufrufen. Sie können einen vorhandenen Store-Eintrag ändern, indem Sie Edits.listings: patch aufrufen.
   • Sie können Erweiterungsdateien hinzufügen oder ändern, indem Sie die Ressourcenmethoden "Edits.expansionfiles" aufrufen.

   Mit diesen Methoden werden zwar Änderungen an der laufenden Bearbeitung vorgenommen, jedoch nicht die Live-Version der App. Sie können weitere Änderungen vornehmen oder die laufende Änderung verwerfen, ohne die Nutzererfahrung zu beeinträchtigen.

   Hinweis :Für jeden Nutzer kann jeweils nur eine Bearbeitung geöffnet sein. Wenn Sie eine neue Änderung erstellen, werden alle bereits geöffneten Änderungen ungültig. Wenn außerdem jemand über die Play Console eine Änderung vornimmt oder Änderungen an einer App vornimmt, werden alle anderen Änderungen an der App (die einem Nutzer gehören) ungültig. Wenn Sie versuchen, eine ungültige Änderung mit einem Commit zu speichern, löst der Vorgang eine Ausnahme aus und hat keine Auswirkungen.

3. Führen Sie einen Commit für die Änderung durch.

   Wenn Sie Edits: commit aufrufen und keine Validierungsfehler vorliegen, werden alle in der Bearbeitungsressource angegebenen Änderungen aktiviert und ersetzt den aktuellen Status der Anwendung. Es kann mehrere Stunden dauern, bis diese Änderungen wirksam werden, genau wie wenn Sie Änderungen über die Play Console vornehmen.