Google Play einrichten

Refund Sensor verbindet sich mit Google Play über ein Dienstkonto, das Sie in Ihrem eigenen Google-Cloud-Projekt erstellen. Es läuft nie ab und muss nicht neu autorisiert werden. Sie brauchen:

• Ein Google-Cloud-Projekt im Konto, dem Ihre Play Console gehört (ein kostenloses genügt).
• Ein Dienstkonto mit einem JSON-Schlüssel, den Sie herunterladen können.
• Play-Console-Zugriff sowie die Rolle Pub/Sub Admin für dieses Konto.
• Die Paketnamen oder Play-Store-URLs, die Sie verteidigen wollen.

1. Öffnen Sie die Google Cloud Console mit dem Konto, dem Ihre Play Console gehört, und wählen oder erstellen Sie ein Projekt. Öffnen Sie im linken Menü IAM & Admin und klicken Sie auf Service accounts.
2. Klicken Sie auf + Create service account, geben Sie einen Namen wie RefundSensor Google Play API ein und klicken Sie auf Create and continue und Done. Die optionalen Rollen können Sie hier überspringen.
3. Kopieren Sie die E-Mail-Adresse des Dienstkontos (sie endet auf .iam.gserviceaccount.com). Sie brauchen sie in den nächsten Schritten.
4. Öffnen Sie das Dienstkonto, wechseln Sie zum Tab Keys, klicken Sie auf Add key → Create new key, wählen Sie JSON und klicken Sie auf Create. Google lädt eine .json-Datei herunter. Bewahren Sie sie sicher auf; Google lässt Sie sie nicht erneut herunterladen.

Ihr Projekt braucht zwei aktivierte Google-APIs (ein einmaliger Schritt pro Projekt). Suchen Sie in der Google Cloud Console mit ausgewähltem Projekt nach beiden und aktivieren Sie sie:

• Google Play Android Developer API, damit das Dienstkonto Ihre Erstattungs- und Bestelldaten lesen kann.
• Cloud Pub/Sub API, die die Echtzeit-Erstattungsbenachrichtigungen antreibt. Achten Sie darauf, dass es Cloud Pub/Sub ist und nicht Pub/Sub Lite, ein anderes Produkt.

Öffnen Sie in Refund Sensor Add app, wählen Sie Google Play und laden Sie die .json-Schlüsseldatei hoch. Wir prüfen sie bei Google und speichern sie im Ruhezustand mit AES-256-GCM verschlüsselt.

Laden Sie das Dienstkonto in die Play Console ein und geben Sie ihm an zwei Stellen Finanzzugriff, denn Erstattungsdaten (stornierte Käufe) werden auf Kontoebene gelesen:

1. Öffnen Sie in der Google Play Console Users and permissions → Invite new users und fügen Sie die E-Mail-Adresse des Dienstkontos ein. Ein Dienstkonto ist aktiv, sobald Sie speichern; es nimmt die Einladung nicht selbst an.
2. Fügen Sie unter App permissions jede App hinzu, die Sie verteidigen wollen, und aktivieren Sie View financial data und Manage orders and subscriptions.
3. Wechseln Sie zum Tab Account permissions (leicht zu übersehen) und aktivieren Sie unter Financial data die Punkte View financial data, orders and cancellation survey responses und Manage orders and subscriptions, dann speichern.

Echtzeit-Benachrichtigungen erreichen Refund Sensor über ein Pub/Sub-Thema, das wir für Sie erstellen und einrichten, es ist also nichts in die Play Console einzufügen. Es braucht nur die Berechtigung, Pub/Sub zu verwalten. Klicken Sie unter IAM & Admin → IAM auf Grant access, fügen Sie die E-Mail-Adresse Ihres Dienstkontos als Principal ein, wählen Sie die Rolle Pub/Sub Admin (roles/pubsub.admin) und speichern Sie. Nehmen Sie Pub/Sub Admin, nicht Pub/Sub Lite Admin; die Lite-Rolle funktioniert nicht und ist der häufigste Grund, warum die automatische Einrichtung scheitert.

Fügen Sie im Schritt Add apps eine Play-Store-URL oder einen Paketnamen pro Zeile ein (der Paketname ist der Wert nach ?id= in einem Play-Store-Link, zum Beispiel com.yourcompany.app). Refund Sensor prüft jeden Eintrag vor dem Import gegen den Play-Console-Zugriff des verbundenen Kontos und markiert alles, was es nicht sehen kann.

Mit aktivierten APIs und erteiltem Pub/Sub Admin erzeugt der Import einer App automatisch das Thema und das Push-Abonnement und registriert es als RTDN-Endpunkt der App. Die App zeigt dann Awaiting first refund event, bis Google das erste echte Ereignis liefert (auf Googles Seite gibt es keinen Testknopf). Sollte die automatische Einrichtung scheitern, zeigt die App-Karte Real-time notifications not set up mit einem Link zurück auf diese Anleitung.

Nicht jede Google-Play-Erstattung lässt sich bestreiten. Eine gewöhnliche Nutzererstattung entscheidet Google allein, diese werden also zur Sichtbarkeit aufgezeichnet, aber nicht bestritten.

Die eine Erstattung, auf die Sie wirklich antworten können, ist eine Rückbuchung in Prüfung (Googles pendingRefundReviewNotification). Sie gibt Ihnen etwa 24 Stunden und berücksichtigt die erste Antwort. Refund Sensor beantwortet sie automatisch mit einer Ablehnungsempfehlung, deutlich innerhalb des Fensters.

Als Absicherung gleicht Refund Sensor zusätzlich mit Googles Voided Purchases API ab, sodass jede Erstattung und jeder stornierte Kauf in Ihrem Dashboard erfasst ist, auch wenn es nichts zu bestreiten gab.