OAuth für Ihre Android-App einrichten

Die Home APIs verwenden OAuth 2.0, um den Zugriff auf Geräte in der Struktur zu gewähren. OAuth ermöglicht es einem Benutzer, einer App oder einem Dienst Berechtigungen zu erteilen, ohne seine Anmeldedaten preiszugeben.

Wenn Sie bereits einen verifizierten OAuth-Client besitzen (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 Vorhandener OAuth-Client.

Melden Sie sich bei der App an.

Generieren Sie zunächst 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 generiert, das für die Entwicklung und das Debugging bestimmt ist. Eine vollständige Erklärung finden Sie unter Android Studio: Sign your debug build.

Sobald die App läuft:

1. Verbinden Sie Ihr Mobilgerät mit Ihrem lokalen Rechner. Android Studio listet Ihre angeschlossenen Geräte nach Modellnummer auf. 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 detailliertere Anleitung finden Sie unter Apps auf einem Hardwaregerät ausführen auf der Android Developers-Website.

2. Beenden Sie die laufende App.

3. Den SHA-1-Fingerabdruck des Debug-Zertifikats erhalten Sie, indem Sie den Anweisungen unter Einrichten von OAuth 2.0 / Native Anwendungen / Android auf der Hilfeseite der Google Cloud Console folgen.

OAuth-Zustimmungsbildschirm einrichten

1. Gehen Sie in der Google Cloud Console zum Dashboard Projektauswahl und wählen Sie das Projekt aus, das Sie zum Erstellen von OAuth-Anmeldeinformationen 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. 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 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 Audience und anschließend auf die Schaltfläche + ADD USERS.
   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.

Ausführliche Informationen finden Sie unter Einrichten Ihres OAuth-Zustimmungsbildschirms auf der Hilfeseite der Google Cloud Console.

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 verifizierten OAuth-Client für eine veröffentlichte App besitzen, können Sie Ihren bestehenden OAuth-Client verwenden, um die Home-APIs zu testen.

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:

• Bei Verwendung eines bestehenden OAuth-Clients gilt eine Beschränkung auf 100 Benutzer. Informationen zum Hinzufügen von Testnutzern finden Sie unterOAuth-Zustimmungsbildschirm einrichten Unabhängig von der OAuth-Bestätigung 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 ConsoleRegistrierung sollte zur Genehmigung gesendet 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 folgendem Fehler fehl:

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