OAuth für Ihre Android-App einrichten

Die Home APIs verwenden OAuth 2.0, um Zugriff auf Geräte im Gebäude zu gewähren. Mit OAuth können Nutzer einer App oder einem Dienst Berechtigungen erteilen, ohne ihre Anmeldedaten weitergeben zu müssen.

Wenn Sie bereits einen bestätigten OAuth-Client haben (z. B. von einer bereits veröffentlichten App), können Sie diesen Client verwenden, um die Home-APIs zu testen, ohne einen neuen einzurichten. Weitere Informationen finden Sie unter Vorhandener OAuth-Client.

App signieren

Generieren Sie zuerst ein Debug-Zertifikat, indem Sie Ihre App in Android Studio ausführen. Wenn Sie eine App in Android Studio ausführen oder debuggen, wird automatisch ein Debugzertifikat für die Entwicklung und das Debugging generiert. Eine ausführliche Erklärung finden Sie unter Android Studio: Sign your debug build.

Wenn die App ausgeführt wird, gehen Sie so vor:

1. Verbinden Sie Ihr Mobilgerät mit Ihrem lokalen Computer. Unter Android Studio werden Ihre verbundenen Geräte nach Modellnummer aufgeführt. Wählen Sie Ihr Gerät aus der Liste aus und klicken Sie dann auf Projekt ausführen. Dadurch wird die Beispiel-App erstellt und auf Ihrem Mobilgerät installiert.

   Eine ausführliche Anleitung finden Sie auf der Website für Android-Entwickler unter Run apps on a hardware device.

2. Beenden Sie die laufende App.

3. Rufen Sie den SHA‑1-Fingerabdruck des Debug-Zertifikats ab, indem Sie der Anleitung unter OAuth 2.0 einrichten / Native Anwendungen / Android auf der Google Cloud Console-Hilfeseite folgen.

OAuth-Zustimmungsbildschirm einrichten

1. Rufen Sie in der Google Cloud Console das Dashboard für die Projektauswahl auf und wählen Sie das Projekt aus, das Sie zum Erstellen von OAuth-Anmeldedaten verwenden möchten.
2. Rufen Sie die Seite APIs und Dienste auf und klicken Sie im Navigationsmenü auf Anmeldedaten.

3. Wenn Sie den Zustimmungsbildschirm für dieses Google Cloud-Projekt noch nicht konfiguriert haben, wird die Schaltfläche Zustimmungsbildschirm konfigurieren angezeigt. Konfigurieren Sie in diesem Fall den Zustimmungsbildschirm mit der folgenden Anleitung. Fahren Sie andernfalls mit dem nächsten Abschnitt fort.

   1. Klicken Sie auf Zustimmungsbildschirm konfigurieren. Die Seite OAuth-Zustimmungsbildschirm wird angezeigt.
   2. Wählen Sie je nach Anwendungsfall Intern oder Extern aus und klicken Sie dann auf Erstellen. Der Bereich OAuth-Zustimmungsbildschirm wird angezeigt.
   3. Geben Sie auf der Seite App-Informationen Informationen gemäß der Anleitung auf dem Bildschirm ein und klicken Sie dann auf Speichern und fortfahren. Der Bereich Bereiche wird angezeigt.
   4. Sie müssen keine Bereiche hinzufügen. Klicken Sie daher auf Speichern und fortfahren. Der Bereich Testnutzer wird angezeigt.
   5. Klicken Sie auf Zielgruppe und dann auf die Schaltfläche + NUTZER HINZUFÜGEN.
   6. Geben Sie die E‑Mail-Adresse des Testnutzers ein und klicken Sie auf die Schaltfläche SPEICHERN.
   7. Klicken Sie auf Speichern und fortfahren. Der Bereich Zusammenfassung wird angezeigt.
   8. Prüfen Sie die Informationen auf dem OAuth-Zustimmungsbildschirm und klicken Sie dann auf Zurück zum Dashboard.

Weitere Informationen finden Sie in der Google Cloud Console-Hilfe unter OAuth-Zustimmungsbildschirm einrichten.

App registrieren und Anmeldedaten erstellen

Folgen Sie der Anleitung unter OAuth 2.0 einrichten, um die App für OAuth 2.0 zu registrieren und OAuth-Anmeldedaten zu erstellen. Sie müssen den App-Typ angeben, der native/Android-App ist.

Fügen Sie den SHA‑1-Fingerabdruck, den Sie beim Signieren der App erhalten haben, dem OAuth-Client hinzu, den Sie in der Google Cloud Console eingerichtet haben. Folgen Sie dazu der Anleitung unter OAuth 2.0 für native Anwendungen einrichten auf der Google Cloud Console-Hilfeseite.

Wenn Ihr Mobilgerät mit Ihrem lokalen Computer verbunden ist, wählen Sie es in der Liste aus und klicken Sie noch einmal auf Projekt ausführen, um es auszuführen. Eine detailliertere Anleitung finden Sie auf der Website für Android-Entwickler unter Run apps on a hardware device.

Wenn Sie einen vorhandenen OAuth-Client haben

Wenn Sie bereits einen bestätigten OAuth-Client für eine veröffentlichte App haben, können Sie ihn zum Testen der Home-APIs verwenden.

Die Registrierung von Google Home Developer Console ist nicht erforderlich, um die Home-APIs zu testen und zu verwenden. Sie benötigen jedoch weiterhin eine genehmigte Developer Console-Registrierung, um Ihre App zu veröffentlichen, auch wenn Sie einen bestätigten OAuth-Client aus einer anderen Integration haben.

Dabei gilt Folgendes:

• Wenn Sie einen vorhandenen OAuth-Client verwenden, gilt eine Beschränkung von 100 Nutzern. Informationen zum Hinzufügen von Testnutzern finden Sie unterOAuth-Zustimmungsbildschirm einrichten Unabhängig von der OAuth-Überprüfung gilt für die Home-APIs ein Limit von 100 Nutzern, die Ihrer Anwendung Berechtigungen erteilen können. Diese Einschränkung wird aufgehoben, sobald die Registrierung für Developer Console abgeschlossen ist.

• DieDeveloper Console sollte zur Genehmigung eingereicht werden, wenn Sie bereit sind, die Gewährung von Gerätetypen über OAuth einzuschränken, um Ihre App mit den Home-APIs zu aktualisieren.

Bei Google Cloud-Apps, bei denen die OAuth-Prüfung noch aussteht, können Nutzer den OAuth-Ablauf erst abschließen, wenn die Prüfung abgeschlossen ist. Versuche, Berechtigungen zu erteilen, schlagen mit dem folgenden Fehler fehl:

Access blocked: <Project Name> has not completed the Google verification process.