Änderungen

Mit den Edits-Methoden der Google Play Developer Publishing API können Sie eine Reihe von Änderungen an Ihrer Google Play-App vorbereiten und dann alle gleichzeitig bereitstellen. Dazu erstellen Sie eine Bearbeitung, die alle Änderungen enthält, die Sie an der App vornehmen möchten. Die Bearbeitung enthält unter anderem folgende Informationen:

• Welche APKs der App zugeordnet sind und ein „Track“ für jedes APK.

  Jede ist mit einem „Track“ verknüpft, der bestimmt, welche Nutzer sie sehen. So können Sie Alpha- und Betaversionen der App für Ihre Tester bereitstellen. Außerdem können Sie eine Version der App für die gestaffelte Einführung bereitstellen. Diese App wird automatisch einer begrenzten Anzahl von Nutzern der App bereitgestellt (die Anzahl wird durch den von Ihnen festgelegten Prozentsatz für den Roll-out bestimmt). So können Sie eine neue Produktionsversion der App nach und nach bereitstellen.

• Sprach- und gebietsspezifische Versionen des Google Play Store-Eintrags der App

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

Hinweis: Nicht alle Methoden der Google Play Developer API verwenden die neue transaktionale „Edits“-Funktion. Methoden für die Ressourcen inappproducts, products und subscriptions werden sofort wirksam, unabhängig davon, ob für die App eine offene Bearbeitung vorhanden ist. Auf der API-Referenzseite der jeweiligen Ressource wird ausdrücklich darauf hingewiesen, ob die Methoden für diese Ressource das „edits“-Modell verwenden.

Wenn Sie eine Bearbeitung erstellen, ist sie eine Kopie des aktuellen bereitgestellten Status der App. Sie können die Bearbeitung dann durch Aufrufen der Edits-Methoden ändern. Wenn die Bearbeitung abgeschlossen ist, übernehmen Sie sie, damit die Änderungen live gehen. Sie können die Bearbeitung auch jederzeit abbrechen. In diesem Fall werden die Änderungen verworfen und Ihre App bleibt unverändert.

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 also mindestens ein APK über die Play Console hochladen, bevor Sie diese API verwenden können. Außerdem können Sie mit dieser API den Status einer App nicht von „veröffentlicht“ in „nicht veröffentlicht“ ändern oder die für die Veröffentlichung erforderlichen rechtlichen Einwilligungen ausfüllen. Wenn Sie die App veröffentlichen möchten, müssen Sie die Play Console verwenden.

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

Workflow

In diesem Abschnitt wird beschrieben, wie Sie die Edits-Methoden der Google Play Developer Publishing API verwenden, um Änderungen an einer App vorzunehmen.

1. Erstellen Sie eine neue Änderung, indem Sie Edits:Insert aufrufen und die App angeben, die Sie ändern möchten.

   Dadurch wird eine neue Bearbeitung der angegebenen App erstellt. Die ursprünglichen Einstellungen der App, z. B. die APKs, Store-Einträge und Erweiterungsdateien, werden alle aus der bereitgestellten Version der App kopiert.

2. Nehmen Sie die gewünschten Änderungen vor.

   Die meisten Änderungen, die über die Google Play Console vorgenommen werden können, sind auch hier möglich. 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. Im Detail:

   • Sie können neue APKs hochladen, indem Sie Edits.apks: upload aufrufen. Dadurch wird das APK in einem Speicherbereich abgelegt, sodass es diesem oder einem nachfolgenden Release-Track zugewiesen werden kann.
   • Sie können APKs Tracks zuweisen, indem Sie Edits.tracks:update aufrufen. Sie können die Zuweisungen von Tracks 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 ein vorhandenes Store-Eintrag bearbeiten, indem Sie Edits.listings: patch aufrufen.
   • Sie können Erweiterungsdateien hinzufügen oder ändern, indem Sie die Methoden der Edits.expansionfiles-Ressource aufrufen.

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

   Hinweis :Jeder Nutzer kann jeweils nur eine offene Bearbeitung haben. Wenn Sie eine neue Bearbeitung erstellen, wird jede vorhandene Bearbeitung, die Sie möglicherweise geöffnet haben, ungültig. Wenn jemand über die Play Console Änderungen an einer App vornimmt, werden alle anderen Änderungen für die App (die einem beliebigen Nutzer gehören) ungültig. Wenn Sie versuchen, eine ungültige Änderung zu übernehmen, wird eine Ausnahme ausgelöst und der Vorgang hat keine Auswirkungen.

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

   Wenn Sie Edits: commit aufrufen und keine Validierungsfehler vorliegen, werden alle in der Ressource „Edits“ angegebenen Änderungen „live“ geschaltet und ersetzen den aktuellen Status der App. Es kann mehrere Stunden dauern, bis diese Änderungen wirksam werden, genau wie bei Änderungen über die Play Console.