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.
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.
Workflow
In diesem Abschnitt wird beschrieben, wie du mit den Bearbeitungsmethoden der Google Play Developer Publishing API Änderungen an einer App vornimmst.
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.
Ä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.
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.