Google Play Echtzeit-Entwicklerbenachrichtigungen im Jahr 2026
Echtzeit-Entwicklerbenachrichtigungen (RTDN) sind der Weg, über den Google Play Ihrem Backend mitteilt, dass bei einem Kauf etwas passiert ist. Es gibt kein Webhook-Dashboard und keinen API-Schlüssel pro App: Play veröffentlicht eine Nachricht in einem Cloud Pub/Sub-Topic innerhalb Ihres eigenen Google Cloud-Projekts, und Ihr Server empfängt sie entweder per HTTPS-Push oder ruft sie ab. Wenn Ihr Umsatzbetrieb noch von geplanten Jobs abhängt, die die Developer API abfragen, ist RTDN das Upgrade – die Dokumentation von Google weist darauf hin, dass eine ineffiziente Nutzung der Play Developer API „zu Einschränkungen des API-Kontingents führen kann".
Dieses Tutorial folgt der Reihenfolge, in der Sie die Arbeit tatsächlich erledigen: Thema erstellen, Veröffentlichungsrechte für Play erteilen, Push oder Pull wählen, Benachrichtigungen in der Play Console aktivieren, dann die Payload dekodieren und darauf reagieren. Jeder Feldname, jeder Benachrichtigungstyp und jeder Konsolenschritt unten stammt aus den beiden offiziellen Seiten von Google, die am Ende zitiert werden.
Was RTDN in einer Zeile ist: eine Nachricht bei jeder Änderung des Kaufstatus — rund 1 KB pro Benachrichtigung, etwa 2 KB pro Veröffentlichung plus Abruf — und die dauerhafte Pflicht, danach die Google Play Developer API aufzurufen, denn die Benachrichtigung „liefert Ihnen keine vollständigen Informationen über den Kauf".
Schritt 1 — Pub/Sub-Topic im eigenen GCP-Projekt erstellen
RTDN wird pro Android-App konfiguriert, aber die Messaging-Ebene gehört Ihnen. Sie benötigen ein Google Cloud-Projekt mit aktivierter Cloud Pub/Sub API und ein Topic, an das Play veröffentlichen wird. Sie können das Projekt weiterverwenden, das Sie bereits für die Play Developer API nutzen, oder ein separates anlegen: Bei mehreren Apps müssen Sie dasselbe Google Cloud-Projekt für die Play Developer API verwenden, jede einzelne App kann jedoch in ihr eigenes Projekt veröffentlichen.
Kalkulieren Sie die Größe, bevor Sie bauen. Der Datenteil einer Benachrichtigung beträgt etwa 1 KB pro Anfrage, und jedes Publish plus Pull ist eine separate Anfrage — rund 2 KB pro Benachrichtigung. Das monatliche Volumen hängt von Ihren Abrechnungszyklen und dem Nutzerverhalten ab, aber planen Sie mindestens eine Benachrichtigung pro Nutzer und Abrechnungszyklus ein und prüfen Sie dann die Pub/Sub-Preise und -Quotas für diesen Wert.
Schritt 2 — Erteilen Sie Google Play die Berechtigung zur Veröffentlichung
Ein brandneues Topic lehnt Plays Veröffentlichungen stillschweigend ab, bis Sie den Zugriff gewähren – und genau diesen Schritt übersehen die meisten. In der Google Cloud Console: Projekt auswählen, Pub/Sub öffnen, Ihr Topic suchen, die Berechtigungsdetails öffnen und dann das Dienstkonto hinzufügen
google-play-developer-notifications@system.gserviceaccount.com
und weisen Sie ihm die Rolle Pub/Sub Publisher zu. Speichern Sie, um die Einrichtung des Topics abzuschließen. Eine Besonderheit im Enterprise-Umfeld: Wenn die domainbeschränkte Freigabekonfiguration Ihrer Organisation die Zuweisung blockiert, müssen Sie eine Ausnahme für dieses Google Play-Dienstkonto hinzufügen, bevor Play irgendetwas veröffentlichen kann.
Schritt 3 — Wählen Sie Push oder Pull für das Abo
Ein Topic ist kein Postfach, das Sie lesen können; Sie benötigen ein daran angehängtes Abo. Ein Push-Abo lässt Cloud Pub/Sub HTTPS-Anfragen an Ihr sicheres Backend senden. Ein Pull-Abo erfordert, dass Ihr Backend Anfragen an Pub/Sub initiiert und Nachrichten abruft. Die Empfehlung von Google für RTDN: Wenn Sie unsicher sind, verwenden Sie Push, „da es in der Regel einfacher zu implementieren ist“; Pull wird häufig genutzt, um die Ressourcennutzung zu optimieren, wenn eine große Zahl von Nachrichten verarbeitet wird.
Aus der Wahl folgen zwei operative Regeln. Beim Pull bestätigen Sie jede abgerufene Nachricht, sonst stellt Pub/Sub sie immer wieder zu. Beim Push gilt ein erfolgreicher Antwortcode Ihres Endpunkts als Bestätigung – ein langsamer oder fehlerhafter Endpunkt bedeutet wiederholte Zustellung.
Schritt 4 — RTDN in der Play Console aktivieren und einen Test senden
- Öffnen Sie den Google Play Console, wählen Sie Ihre App aus und gehen Sie zu Monetarisieren → Monetarisierungs-Setup.
- Aktivieren Sie im Abschnitt Echtzeit-Entwicklerbenachrichtigungen oben auf dieser Seite das Kontrollkästchen Echtzeit-Benachrichtigungen aktivieren.
- Geben Sie im Feld Themenname den vollständigen Themennamen im Format
projects/{project_id}/topics/{topic_name}ein. - Klicken Sie auf Testnachricht senden. Bei Pull öffnen Sie das Abo in der Cloud Console, klicken auf Nachrichten anzeigen und rufen ab; bestätigen Sie anschließend. Bei Push prüfen Sie, ob die Testnachricht Ihren Endpunkt erreicht hat.
- Wählen Sie den Benachrichtigungsumfang. Abos und alle stornierten Käufe liefert Ihnen nur Ereignisse zu Abos und stornierten Käufen. Alle Benachrichtigungen für Abos und Einmalkäufe sendet zusätzlich Ereignisse zu Einmalkäufen wie
ONE_TIME_PRODUCT_PURCHASEDundONE_TIME_PRODUCT_CANCELED. - Klicken Sie auf Änderungen speichern.
Wenn die Testveröffentlichung fehlschlägt, zeigt die Console einen Fehler an, und es gibt nur zwei realistische Ursachen: Der Topic-Name ist falsch, oder google-play-developer-notifications@system.gserviceaccount.com hat keine Pub/Sub-Publisher-Rolle für das Topic. Korrigieren Sie die Berechtigung, nicht die App.
Was eine Nachricht tatsächlich enthält
Jede Veröffentlichung zum Topic hat denselben Aufbau: eine attributes-Map, ein base64-kodiertes data-Feld, eine messageId und den subscription-Pfad. Dekodieren Sie data, erhalten Sie eine DeveloperNotification mit vier Fakten – version, packageName, eventTimeMillis – plus genau einem Payload-Feld. Diese Payload-Felder sind gegenseitig ausschließend: subscriptionNotification, oneTimeProductNotification, voidedPurchaseNotification oder testNotification.
messageId ist eine eindeutige Kennung für die Benachrichtigung, und der Referenzleitfaden empfiehlt, diese Eindeutigkeit zu prüfen, damit Sie keine doppelten Benachrichtigungen verarbeiten und überflüssige Backend-API-Aufrufe auslösen – was genau das API-Kontingent verschwendet, das RTDN schützen soll.
Benachrichtigungstypen für Abos
Eine subscriptionNotification enthält eine Ganzzahl notificationType, ein purchaseToken und eine eigene version. Der aktuelle Satz:
- 1 — SUBSCRIPTION_RECOVERED: aus dem Account Hold wiederhergestellt oder aus der Pause fortgesetzt.
- 2 — SUBSCRIPTION_RENEWED: Ein aktives Abo wurde verlängert.
- 3 — SUBSCRIPTION_CANCELED: freiwillig oder unfreiwillig gekündigt; bei einer freiwilligen Kündigung wird es gesendet, wenn der Nutzer kündigt.
- 4 — SUBSCRIPTION_PURCHASED: Ein neues Abo wurde gekauft.
- 5 — SUBSCRIPTION_ON_HOLD: Kontosperre eingetreten, falls Sie diese aktiviert haben.
- 6 – SUBSCRIPTION_IN_GRACE_PERIOD: Karenzzeit begonnen, sofern Sie diese aktiviert haben.
- 7 — SUBSCRIPTION_RESTARTED: Der Nutzer hat ein gekündigtes Abo über Play → Konto → Abos wiederhergestellt, bevor es abgelaufen ist.
- 9 — SUBSCRIPTION_DEFERRED: Der Wiederholungszeitpunkt wurde verlängert.
- 10 – SUBSCRIPTION_PAUSED / 11 – SUBSCRIPTION_PAUSE_SCHEDULE_CHANGED: pausiert oder der Pausierungsplan wurde geändert.
- 12 — SUBSCRIPTION_REVOKED: vor dem Ablaufzeitpunkt widerrufen.
- 13 — SUBSCRIPTION_EXPIRED: Das Abo ist abgelaufen.
- 17 – SUBSCRIPTION_ITEMS_CHANGED: Ein Element in einem Abo-Bundle wurde geändert.
- 18 — SUBSCRIPTION_CANCELLATION_SCHEDULED: Kündigung zum Ende einer Ratenzahlungsverpflichtung geplant.
- 19 — SUBSCRIPTION_PRICE_CHANGE_UPDATED: Die Angaben zur Preisänderung eines Abo-Artikels wurden aktualisiert.
- 20 — SUBSCRIPTION_PENDING_PURCHASE_CANCELED: Eine ausstehende Abo-Transaktion wurde storniert.
- 22 — SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED: Die Zustimmungsfrist für die Preiserhöhung hat begonnen oder der Nutzer hat zugestimmt; wird nur in Regionen gesendet, in denen eine Preiserhöhungszustimmung erforderlich ist.
Der Typ 8 (SUBSCRIPTION_PRICE_CHANGE_CONFIRMED) ist in der Referenz als veraltet markiert, bauen Sie also keine neue Logik darauf auf. Beachten Sie außerdem, dass diese Nummern kein Lebenszyklus sind, den Sie ableiten können – das Ereignis sagt Ihnen, dass sich der Zustand geändert hat, nie den resultierenden Zustand.
Benachrichtigungen für Einmalprodukte
Wird nur gesendet, wenn Sie den erweiterten Umfang gewählt haben. Eine oneTimeProductNotification fügt dem Token ein Feld sku hinzu, mit zwei Typen: 1 — ONE_TIME_PRODUCT_PURCHASED (ein Einmalkauf wurde erfolgreich abgeschlossen) und 2 — ONE_TIME_PRODUCT_CANCELED (ein ausstehender Einmalkauf wurde vom Nutzer storniert). In beiden Fällen ist weiterhin ein Aufruf der Developer API erforderlich, denn eine Kaufbenachrichtigung sagt nichts darüber aus, ob Sie das Produkt bereits verbraucht oder bestätigt haben.
Stornierte Käufe und das Feld refundType
Eine voidedPurchaseNotification ist die RTDN, die die meisten Revenue-Teams interessiert, und 2026 steckt darin mehr als ein Token. Die Payload besteht aus purchaseToken, orderId, productType und refundType. productType ist 1 für ein Abo oder 2 für einen Einmalkauf. refundType ist 1 — REFUND_TYPE_FULL_REFUND oder 2 — REFUND_TYPE_QUANTITY_BASED_PARTIAL_REFUND, wobei Letzteres nur für Käufe mit mehreren Einheiten gilt, die mehrfach teilweise storniert werden können; sobald die verbleibende Gesamtmenge erstattet ist, wird der Typ als vollständige Erstattung gemeldet.
Der Referenzleitfaden stellt ausdrücklich klar, dass für das Auffinden des richtigen Kaufs und der richtigen Bestellung zur Anpassung von Berechtigungen die Benachrichtigung selbst ausreicht – und dass die Google Play Voided Purchases API die Pull-Modell-Ergänzung ist, die stornierte Kaufsdaten für einen Zeitstempelbereich zurückgibt. Bei teilweisen Rückerstattungen über mehrere Mengen sagt Ihnen das Feld refundableQuantity aus purchases.productsv2, wie viele gekaufte Produkte noch nicht storniert sind. Das passt direkt zu den Änderungen bei der Buchhaltung von Chargebacks und Rückerstattungen, die wir in dem Play-Leitfaden 2026 zu Rückerstattungen und Chargebacks behandelt haben.
Serverregeln, die die Pipeline korrekt halten
- Behandeln Sie die Benachrichtigung als Frage, nicht als Antwort. Rufen Sie die Developer API nach jeder RTDN auf, um den vollständigen Status abzurufen, bevor Sie eine Berechtigung gewähren, verlängern oder entziehen.
- Deduplizieren Sie anhand von
messageId. Pub/Sub liefert mindestens einmal; doppelte Verarbeitung bedeutet doppelte API-Aufrufe und doppelte Statusübergänge. - Immer zuerst bestätigen, dann verarbeiten. Pull: Bestätigen Sie abgerufene Nachrichten. Push: Geben Sie einen Erfolgscode zurück. Dauert die Verarbeitung länger als die Bestätigung, akzeptieren Sie erneute Zustellungen und gestalten Sie den Handler idempotent.
- Rechnen Sie mit mehreren Ereignissen pro Nutzer. Ein
purchaseTokenkann für denselben Abonnenten die Benachrichtigungen „purchased", dann „cancelled" und schließlich „expired" erzeugen – der Handler muss mehrfach sicher ausführbar sein. - Nicht durch Polling kompensieren. Polling der Developer API parallel zu RTDN ist genau das Fehlermuster, das Kontingentbeschränkungen auslöst.
Ihre Konfiguration wird überprüft
Die Funktion Testnachricht senden in der Console ist der schnellste End-to-End-Nachweis: Wenn Sie ein Abo angehängt haben, sollten Sie die Nachricht erhalten. Ein testNotification-Body enthält nur ein Feld version, ist also eine sichere Payload für Assertions in der Testsuite Ihres Handlers. Ohne Backend ziehen Sie die Nachricht mit der gcloud-Kommandozeile aus dem Abo – und denken Sie daran, sie zu bestätigen. Eine gesunde Pipeline zeigt sich als Strom von Events, deren packageName zu Ihrer App passt und deren eventTimeMillis die Aktivität aktiver Abonnenten abbildet.
Ein Hinweis zur Zeitplanung: Die serverseitige RTDN-Arbeit steht neben der Frist für die clientseitige Billing Library. Alle neuen Apps und Updates müssen Billing Library Version 8 oder höher verwenden, mit einem Verlängerungspfad bis zum 1. November 2026 — und die Serververifizierung, die RTDN verarbeitet, sollte zeitgleich bereit sein.
Quellen
Sie verwalten Entwicklerkonten im großen Stil? Wir übernehmen die operative Seite.
Wir haben Ihre Nachricht erhalten und antworten innerhalb von 24 Stunden.
← Zurück zum Bearbeiten