OAuth für Ihre Android-App einrichten

Die Home APIs verwenden OAuth 2.0, um Zugriff auf Geräte in der Struktur zu gewähren. Mit OAuth kann ein Nutzer einer App oder einem Dienst Berechtigungen erteilen, ohne seine Anmeldedaten preisgeben 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 einrichten zu müssen. Weitere Informationen finden Sie unter Wenn Sie bereits einen 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 Debug-Zertifikat für die Entwicklung und das Debugging generiert. Eine vollständige Erklärung finden Sie unter Android Studio: Sign your debug build.

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

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

   Eine detailliertere Anleitung finden Sie auf der Website für Android-Entwickler unter Run apps on a hardware device on the Android Developers site.

2. Beenden Sie die laufende App.

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

OAuth-Zustimmungsbildschirm einrichten

1. Rufen Sie in der Google Cloud Console das Dashboard der Projektauswahl auf und wählen Sie das Projekt aus, mit dem Sie OAuth-Anmeldedaten erstellen 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. Andernfalls fahren Sie 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 die 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 Ihres 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 zum OAuth-Zustimmungsbildschirm und klicken Sie dann auf Zurück zum Dashboard.

Ausführliche Informationen finden Sie auf der Google Cloud Console-Hilfeseite 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 einrichten / Native Anwendungen auf der Google Cloud Console-Hilfeseite.

Wenn Ihr Mobilgerät mit Ihrem lokalen Computer verbunden ist, wählen Sie Ihr Gerät 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 bereits einen OAuth-Client haben

Wenn Sie bereits einen bestätigten OAuth-Client für eine veröffentlichte App haben, können Sie diesen OAuth-Client verwenden, um die Home APIs zu testen.

Für das Testen und Verwenden der Home APIs ist keine Google Home Developer Console Registrierung erforderlich. 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:

• Bei Verwendung eines vorhandenen OAuth-Clients gilt eine Beschränkung von 100 Nutzern. Informationen zum Hinzufügen von Testnutzern finden Sie unter OAuth-Zustimmungsbildschirm einrichten. Unabhängig von der OAuth-Überprüfung gilt für die Home APIs eine Beschränkung von 100 Nutzern, die Ihrer Anwendung Berechtigungen erteilen können. Diese Beschränkung wird aufgehoben, sobald die Developer Console Registrierung abgeschlossen ist.

• Developer Console Registrierung sollte zur Genehmigung eingereicht werden, wenn Sie die Berechtigungen für Gerätetypen über OAuth einschränken möchten, um Ihre App mit den Home APIs zu aktualisieren.

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

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