Nema Crew ist ein Team aus KI-Agents, das rund um die Uhr für Ihr Unternehmen arbeitet. Mit der Google-Play-Integration kümmern sich Ihre Agents um Ihre Android-Apps: Bewertungen lesen und beantworten, Releases und Rollouts im Blick behalten und steuern, Release-Notes pflegen und Absturz- und ANR-Raten überwachen.
Das Modul nutzt die offiziellen Schnittstellen von Google, die Google Play Android Developer API und die Google Play Developer Reporting API. Sie verbinden es mit einem eigenen Dienstkonto (Service Account) in Ihrem Google-Cloud-Projekt. Ein Google-Login oder Ihr Passwort braucht Nema nicht.
Was Agents damit tun
- Apps und Store-Eintrag. Ihre Apps auflisten, Standardsprache, Kontaktangaben und Titel und Kurzbeschreibung je Sprache lesen.
- Tracks und Releases. Alle Tracks (Produktion, offene und geschlossene Tests, interner Test, Formfaktor-Tracks) mit ihren Releases: Name, Versionscodes, Status (Entwurf, wird ausgerollt, angehalten, vollständig ausgerollt), Ausrollanteil und Release-Notes.
- Bewertungen. Bewertungen mit Text lesen und filtern (Sterne, Sprache, unbeantwortet), auf Wunsch von Google übersetzt; öffentlich antworten oder eine Antwort ersetzen.
- Android vitals. Tägliche Absturz- und ANR-Rate (gesamt und nutzerbezogen) über einen Zeitraum bis 90 Tage, auf Wunsch je Versionscode, verglichen mit den Schwellen von Google für schlechtes Verhalten (1,09 % bzw. 0,47 %).
- Releases steuern. Release-Notes je Sprache setzen, den Ausrollanteil ändern, einen Rollout anhalten, fortsetzen oder abschließen und ein Release in einen anderen Track übernehmen (etwa intern → Beta → Produktion).
Alles, was etwas ändert, zeigt der Agent zuerst als Vorschau (etwa Bewertung und Antwort, Release vorher und nachher). Erst wenn Sie zustimmen, führt er es aus. Änderungen an Releases laufen bei Google als eine Bearbeitung: Sie wird geprüft und erst dann übernommen; schlägt etwas fehl, verwirft das Modul sie, und es bleibt alles, wie es war.
App-Pakete (AAB/APK) lädt das Modul nicht hoch. Ein Upload ist groß, braucht Ihre Signatur und lässt sich nach der Veröffentlichung nicht zurücknehmen; das gehört in Ihre Build-Pipeline (CI) oder die Play Console. Der Agent kann ein dort hochgeladenes Release danach befördern und ausrollen.
Auslöser
Google bietet für Bewertungen und Releases keine Webhooks. Nema Crew fragt deshalb sparsam nach:
| Auslöser | Wie oft | Was |
|---|---|---|
| Neue Bewertung | alle 30 Minuten | neue oder geänderte Bewertung mit Text in einer Ihrer Apps |
| Release-Status geändert | alle 30 Minuten | neues Release in einem Track, anderer Status oder anderer Ausrollanteil |
| Vitals-Warnung | alle 3 Stunden | neueste tägliche nutzerbezogene Absturz- oder ANR-Rate über Ihrer Schwelle |
Jedes Ereignis startet den Agent einmal. Beim ersten Lauf merken sich „Neue Bewertung“ und „Release-Status geändert“ nur den aktuellen Stand und melden noch nichts. Die Vitals-Warnung meldet je App, Kennzahl und Tag höchstens einmal, auch schon beim ersten Lauf.
Einrichten
1. APIs aktivieren. In der Google Cloud Console ein Projekt wählen (oder anlegen). Unter APIs und Dienste → Bibliothek nacheinander Google Play Android Developer API und Google Play Developer Reporting API suchen und jeweils Aktivieren klicken.
2. Dienstkonto anlegen. Unter IAM und Verwaltung → Dienstkonten → Dienstkonto erstellen einen Namen eingeben, etwa „Nema Crew“. Rollen im Cloud-Projekt braucht es nicht. Danach das Dienstkonto öffnen, Schlüssel → Schlüssel hinzufügen → Neuen Schlüssel erstellen → JSON. Die JSON-Datei wird heruntergeladen. Sie ist ein Zugang: nicht weitergeben und nicht in ein Repository legen.
Kann Ihre Organisation keine Schlüssel erstellen, verbietet eine Organisationsrichtlinie das (iam.disableServiceAccountKeyCreation); dann muss ein Administrator von Google Cloud eine Ausnahme für das Projekt einrichten.
3. Dienstkonto in der Play Console einladen. In der Play Console unter Nutzer und Berechtigungen → Neue Nutzer einladen die E-Mail-Adresse des Dienstkontos eintragen (sie endet auf .iam.gserviceaccount.com und steht auch in der JSON-Datei unter client_email). Dann die Apps wählen (oder Kontoberechtigungen für alle Apps vergeben) und die Rechte setzen:
| Damit der Agent … | braucht das Dienstkonto |
|---|---|
| Apps, Releases, Bewertungen und Kennzahlen lesen kann | App-Informationen ansehen und Sammelberichte herunterladen (schreibgeschützt) – immer nötig |
| auf Bewertungen antworten kann | Auf Rezensionen antworten |
| Release-Notes, Rollouts und Beförderungen in Test-Tracks ändern kann | Apps für Test-Tracks veröffentlichen (bzw. Test-Tracks verwalten) |
| dasselbe in der Produktion kann | In der Produktion veröffentlichen, Geräte ausschließen und die Play App-Signatur verwenden |
Finanzdaten, Bestellungen und Abonnements braucht das Modul nicht. Geben Sie nur, was Sie nutzen wollen. Die englischen Namen in der Play Console lauten „View app information and download bulk reports (read-only)“, „Reply to reviews“, „Release apps to testing tracks“ und „Release to production, exclude devices, and use Play App Signing“.
4. In Nema Crew verbinden. In der App Nema Crew Module → Google Play öffnen und den ganzen Inhalt der JSON-Datei einfügen. Optional:
- Apps (Package-Namen): z. B.
com.example.app, com.example.other. Leer lassen = alle Apps, die das Dienstkonto sieht (ermittelt über die Reporting API). - Warnung Absturzrate (%) und Warnung ANR-Rate (%): Schwellen für die Vitals-Warnung, Standard 1,09 und 0,47.
5. Speichern und testen. Nema meldet sich mit dem Schlüssel bei Google an und prüft je App, ob Releases, Bewertungen und Kennzahlen lesbar sind. Fehlt etwas, nennt der Test genau, was: eine nicht aktivierte API, ein fehlendes Recht in der Play Console oder ein ungültiger Schlüssel. Ob das Dienstkonto antworten oder Releases ändern darf, lässt sich ohne eine echte Änderung nicht prüfen; fehlt das Recht, sagt der Agent es beim ersten Versuch.
Geduld bei neuen Rechten. Neue Berechtigungen für ein Dienstkonto greifen bei Google oft nicht sofort. Google nennt dafür keine Frist; erfahrungsgemäß dauert es meist bis zu 24 Stunden, gelegentlich auch länger (Anbieter ähnlicher Dienste berichten von bis zu 36 Stunden). Meldet der Test „Recht fehlt“, obwohl es gesetzt ist, später erneut testen. Den Schlüssel neu einzufügen beschleunigt das nicht.
Grenzen der Google-Schnittstellen
- Bewertungen: Die API liefert nur Bewertungen mit Text, die in den letzten 7 Tagen geschrieben oder geändert wurden, und nur für die Produktion. Reine Sterne-Bewertungen, ältere Bewertungen und Feedback aus Tests gibt es nur in der Play Console (oder als CSV-Export). Eine Antwort hat höchstens 350 Zeichen, nur Text. Google erlaubt je App 200 Lese-Aufrufe pro Stunde und 2.000 Antworten pro Tag.
- Kennzahlen: Android vitals kommen mit 1–2 Tagen Verzögerung, als Tageswerte in der Zeitzone von Los Angeles.
- Release-Notes: höchstens 500 Zeichen je Sprache.
- Rollouts: Google prüft jeden Wechsel selbst; einen kleineren Ausrollanteil als bisher lehnt Google unter Umständen ab, dann sagt der Agent es. Hat Ihr Konto „Verwaltete Veröffentlichung“ aktiv oder wurde ein Update abgelehnt, kann Google eine Änderung nicht automatisch zur Prüfung senden; dann fragt der Agent, ob er sie ohne Prüfung speichern soll, und Sie senden sie in der Play Console unter „Veröffentlichungsübersicht“ ab.
- Änderungen werden nicht sofort sichtbar: Nach dem Übernehmen kann es dauern, bis Google Play sie zeigt.
Wenn etwas nicht klappt
| Meldung | Was zu tun ist |
|---|---|
| API nicht aktiviert | In der Google Cloud Console im Projekt des Dienstkontos die genannte API aktivieren, einige Minuten warten, erneut testen. |
| Recht fehlt | In der Play Console unter Nutzer und Berechtigungen dem Dienstkonto das genannte Recht für die App geben; danach kann es dauern (siehe oben). |
| Schlüssel abgelehnt | Der Schlüssel wurde gelöscht oder das Dienstkonto deaktiviert: neuen JSON-Schlüssel erstellen und einfügen. |
| Kein JSON / OAuth-Client | Nicht die Client-ID-Datei, sondern den Schlüssel eines Dienstkontos verwenden. |
| App unbekannt | Package-Namen prüfen und die App für das Dienstkonto freigeben. |
| Kontingent erreicht | Google begrenzt die Anfragen; später erneut versuchen. |
Daten
Den Schlüssel speichert Nema verschlüsselt. Er wird nur verwendet, um bei Google ein Zugangs-Token zu holen, und erscheint in keinem Protokoll. Inhalte aus Google Play speichert das Modul nicht; es ruft sie bei jeder Aufgabe neu ab. Für die Auslöser merkt sich Nema nur den letzten Stand (Zeitpunkt der neuesten Bewertung, Status der Releases, Datum der letzten Kennzahlen) und Kennungen gemeldeter Ereignisse. Einzelheiten: Datenschutzhinweis zum Google-Play-Modul.
Trennen
In Nema Crew unter Module → Google Play → Trennen. Damit löscht Nema den gespeicherten Schlüssel. Den Schlüssel selbst löschen Sie bei Google in der Google Cloud Console unter IAM und Verwaltung → Dienstkonten → Schlüssel; die Rechte entziehen Sie in der Play Console unter Nutzer und Berechtigungen. Wir empfehlen beides.
Support
Fragen und Probleme: support@nema.im.
Änderungen
- 1.0 · 5. November 2026 – Erste Fassung: Apps, Tracks und Releases, Bewertungen und Android vitals lesen; auf Bewertungen antworten, Release-Notes setzen, Rollouts steuern und Releases befördern (jeweils mit Vorschau); Auslöser „Neue Bewertung“, „Release-Status geändert“ und „Vitals-Warnung“.