KappS Wissensdatenbank · FAQ

Erklärung eingeschränkter Berechtigungen auf Google Play

FAQ Berechtigungen & API

1. Eingeschränkte Berechtigungen sind Plays zusätzliche Hürde für gefährliche, spezielle und Signatur-Berechtigungen sowie für die Familien, die unter Berechtigungen und APIs mit Zugriff auf sensible Informationen dokumentiert sind. Daten, die über diese Berechtigungen erreicht werden, sind personenbezogen und sensibel: Fordern Sie nur an, was ein aktuelles, im Store gelistetes Feature benötigt, fragen Sie schrittweise ab, respektieren Sie eine Ablehnung und verkaufen Sie die Daten niemals oder nutzen Sie sie für einen nicht offengelegten Zweck. Über das Berechtigungserklärungsformular erfasst die Play Console diese Begründung und Genehmigung, bevor eine Hochrisiko-Berechtigung in einem veröffentlichten Artefakt verbleibt. Primärrichtlinie: Play Console Help, „Permissions and APIs that Access Sensitive Information" (https://support.google.com/googleplay/android-developer/answer/16558241). Formular-Workflow: „Declare permissions for your app" (https://support.google.com/googleplay/android-developer/answer/9214102).

2. Das Formular wird durch das Binary ausgelöst, nicht durch ein Kontrollkästchen, an das Sie sich erinnern müssen. Nachdem Sie ein Android App Bundle hinzugefügt haben, bewertet Play die angeforderten Berechtigungen während „Release vorbereiten und ausrollen" (https://support.google.com/googleplay/android-developer/answer/9859348). Wenn das Bundle Berechtigungen mit hohem Risiko oder sensible Berechtigungen anfordert – die Beispiele in der Hilfe sind SMS oder Anrufprotokoll – und keine Erklärung vorliegt, erscheint das Formular zur Berechtigungserklärung in diesem Release-Ablauf. Richtlinie → App-Inhalte → Berechtigungen und APIs (oder die Erklärung zu Berechtigungen mit hohem Risiko bzw. sensiblen Berechtigungen, die Play anzeigt, wenn die Berechtigung bereits im zusammengeführten Manifest steht) ist der feste Ort, um dasselbe Formular zu starten oder zu verwalten. Ein aktives Bundle in Produktion, offenem, geschlossenem oder internem Test, das weiterhin eine nicht erklärte Berechtigung mit hohem Risiko anfordert, löst eine Warnung zu App-Inhalten aus und kann die Veröffentlichung blockieren, einschließlich Änderungen am Store-Eintrag, bis Sie die Berechtigung erklären oder entfernen. Rollouts über die Publishing API schlagen mit Fehler fehl, bis Play die Verwendung genehmigt hat; laut Hilfe schließen Sie das Formular in der Play Console im Web-UI ab und führen dann das Rollout dort zu Ende. Wann immer die App eine neue eingeschränkte Berechtigung anfordert, müssen Sie ein überarbeitetes Formular einreichen, das diese Berechtigung abdeckt.

3. Betrachten Sie dies als einen Formularprozess, der mehrere Berechtigungsfamilien abdeckt – kein Ersatz für die speziellen Einträge zu QUERY_ALL_PACKAGES oder den Accessibility-FAQ. Familien, die dieses Formular häufig erforderlich machen: SMS- und Anruflisten-Gruppen (READ_SMS, SEND_SMS, RECEIVE_SMS, READ_CALL_LOG und verwandte; Standard-Handler für SMS, Telefon oder Assistant erforderlich – https://support.google.com/googleplay/android-developer/answer/10208820); AccessibilityService (Accessibility-Erklärung ausfüllen; nur echte Hilfsmittel für Menschen mit Behinderung dürfen isAccessibilityTool=true setzen); QUERY_ALL_PACKAGES (zusammen mit allen anderen Hochrisiko-Berechtigungen deklarieren; bevorzugen Sie ein gezieltes <queries>-Manifest, wenn das ausreicht); Foto und Video READ_MEDIA_IMAGES / READ_MEDIA_VIDEO, wenn die App auf API 33+ abzielt und der Android Photo Picker für die Kernfunktion nicht ausreicht (https://support.google.com/googleplay/android-developer/answer/14115180 und https://support.google.com/googleplay/android-developer/answer/15800983); Zugriff auf alle Dateien (MANAGE_EXTERNAL_STORAGE); REQUEST_INSTALL_PACKAGES; sowie Health Connect / granulare Gesundheitsberechtigungen. Prüfen Sie das zusammengeführte Manifest, einschließlich der durch SDKs eingefügten Verwendungen. Wenn eine Alternative mit minimalem Umfang die Funktion abdeckt – Photo Picker, SMS Retriever API, gezielte <queries>, Storage Access Framework oder MediaStore –, entfernen Sie die eingeschränkte Berechtigung, statt sie zu deklarieren.

4. Der Weg in der Konsole und die sieben Hilfe-Schritte: App öffnen → Richtlinie → App-Inhalte → Berechtigungen und APIs → Start (oder Verwalten). Oder Sie durchlaufen denselben Assistenten, wenn der Release-Ablauf ihn nach dem Upload anzeigt. Schritt 1: Prüfen Sie die Berechtigungen, die Play im Artefakt erkannt hat – an dieser Liste werden Prüfer Sie messen, nicht an einem älteren Entwurf. Schritt 2: Legen Sie die Kernfunktion aus der Liste der unterstützten Einsatzzwecke fest; setzen Sie nur die zutreffenden Kontrollkästchen. Schritt 3: Verfassen Sie Prüfhinweise, die einen Fremden zu dem Bildschirm führen, der die Berechtigung benötigt. Schritt 4: Stellen Sie ein kurzes Video bereit, das diese Kernfunktion zeigt (und jede erforderliche In-App-Offenlegung). Schritt 5: Ist die Funktion durch eine Anmeldung geschützt, geben Sie funktionierende App-Zugangsdaten und eine Navigationsanleitung an. Schritt 6 (nur bei mehreren APKs): Beantragen Sie eine Ausnahme für alte APKs, die Sie nicht mehr ändern können – die Hilfe dokumentiert dieses Feld für SMS-/Anruflisten-Altlasten; listen Sie die Versionscodes auf. Schritt 7: Bestätigen Sie, dass die Erklärung korrekt ist und dass Sie den Bedingungen für die zulässige Verwendung zustimmen. Schließen Sie dann die Vorbereitung des Releases ab. Dieselben Schritte: https://support.google.com/googleplay/android-developer/answer/9214102.

5. Deklarieren Sie korrekt. Play definiert Kernfunktionalität als den Hauptzweck der App: Ohne die Funktion, die die Berechtigung erfordert, ist das Produkt „defekt“ oder unbrauchbar, und dieser Zweck samt seiner Kernfunktionen muss im Store-Eintrag deutlich dokumentiert sein. Formular, Store-Eintrag und Code müssen dieselbe Geschichte erzählen. Wählen Sie keinen nahegelegenen genehmigten Anwendungsfall, nur weil er leichter durch die Prüfung kommt. Lassen Sie keinen Platzhaltertext für Berechtigungen im Manifest. Wenn Sie die Nutzung einer eingeschränkten Berechtigung ändern, reichen Sie das Formular erneut mit aktuellen Angaben ein. Daten aus eingeschränkten Berechtigungen dürfen nur für die deklarierten Kernfunktionen verwendet werden – nicht für Werbung, Marketing oder die Verbesserung nicht zugehöriger Apps. Wenn ein Nutzer eine nicht kritische Berechtigung ablehnt, respektieren Sie diese Entscheidung und bieten Sie eine sinnvolle Alternative an (etwa manuelle Eingabe statt Auslesen eines Protokolls).

6. Häufige Ablehnungen und die üblichen Korrekturen: (a) Ein SDK hat still und leise SMS, Anrufliste, QUERY_ALL_PACKAGES, READ_MEDIA_IMAGES oder MANAGE_EXTERNAL_STORAGE hinzugefügt – entfernen oder ersetzen Sie das SDK oder entfernen Sie die Berechtigung mit tools:node="remove" und laden Sie dann ein neues Bundle hoch; (b) Das Formular fehlt, ist veraltet oder beschreibt eine andere Nutzung als der Code – aktualisieren Sie Richtlinien → App-Inhalte und reichen Sie erneut ein; (c) Der Store-Eintrag beschreibt ein Utility mit einem einzigen Zweck, während das Binary eine Default-Handler- oder breite Zugriffsberechtigung anfordert – entweder der Store-Eintrag oder die Berechtigung ist falsch; (d) Foto/Video oder Paketsichtbarkeit deklariert, obwohl Photo Picker oder <queries> ausreicht – entfernen Sie die Berechtigung; (e) Fehlendes, veraltetes oder nicht funktionsbezogenes Video bzw. fehlende Prüfhinweise; (f) Eine zentrale Funktion hinter einem Login ohne App-Zugang; (g) Ein altes APK, das noch auf einem Test-Track liegt und die Berechtigung enthält; (h) Ein Rollout über die Publishing API, bevor das Formular in der Web-Oberfläche genehmigt wurde; (i) Die Nutzung hat sich geändert und das Formular wurde nicht erneut eingereicht. Apps, die den Richtlinientest nicht bestehen oder kein Berechtigungsdeklarationsformular haben, können aus Google Play entfernt werden. Täuschende oder nicht deklarierte Nutzung kann zur Sperrung der App oder zur Kontokündigung des Entwicklerkontos führen.

7. Planen Sie die zusätzliche Prüfung ein. Help bewertet die Erklärung im Rahmen der Release-Prüfung; eine Berechtigung mit hohem Risiko kann das neue Artefakt in der ausstehenden Veröffentlichung halten, bis der Anwendungsfall genehmigt ist. Versuchen Sie nicht, das Formular zu umgehen, indem Sie ein weiteres Release über ein ausstehendes legen – Help warnt, dass das Überschreiben einer ausstehenden Veröffentlichung zu Verzögerungen führen kann. Wenn Sie einen dringenden, richtlinienunabhängigen Fix brauchen, liefern Sie ein Bundle, das die nicht deklarierte Berechtigung nicht mehr anfordert. Halten Sie jeden aktiven Track ehrlich: Play liest das zusammengeführte Manifest bei Internem Test, Geschlossenem Test, Offenem Test und Produktions-Track, nicht nur den Build, den die Prüfer sehen sollten.

8. Checkliste vor Einreichung: (a) Merged Manifest auf jedem Track ausgeben und jede eingeschränkte Berechtigung auflisten, auch solche, die ein SDK hinzugefügt hat; (b) jede Berechtigung entfernen, die eine Alternative mit minimalem Umfang ersetzen kann; (c) Richtlinien → App-Inhalte → Berechtigungen und APIs mit Anwendungsfällen ausfüllen, die zu Store-Eintrag und Code passen; (d) ein aktuelles Video sowie Prüfhinweise bzw. App-Zugriffsanweisungen beifügen, die die Funktion tatsächlich erreichen; (e) das Formular nach jeder Änderung des Anwendungsfalls erneut einreichen; (f) eine neue Berechtigung mit hohem Risiko nicht über die Publishing API ausrollen, bevor das Formular in der Web-Oberfläche genehmigt ist; (g) https://support.google.com/googleplay/android-developer/answer/16558241, https://support.google.com/googleplay/android-developer/answer/9214102, https://support.google.com/googleplay/android-developer/answer/10208820, und https://support.google.com/googleplay/android-developer/answer/14115180 nach jeder Änderung an Manifest, SDK oder Handler-Rolle erneut lesen.