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 kann ein Nutzer einer App oder einem Dienst Berechtigungen erteilen, ohne seine Anmeldedaten preisgeben zu müssen.

Wenn du bereits einen bestätigten OAuth-Client hast (z. B. von einer bereits veröffentlichten App), kannst du diesen Client zum Testen der Home APIs verwenden, ohne einen neuen einrichten zu müssen. Weitere Informationen finden Sie unter Wenn Sie einen vorhandenen OAuth-Client haben.

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 ausführliche Erklärung finden Sie unter Android Studio: Debug-Build signieren.

Sobald die App ausgeführt wird:

1. Verbinden Sie Ihr Mobilgerät mit Ihrem lokalen Computer. Android Studio listet deine verbundenen 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 auf deinem Mobilgerät erstellt und 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 Anwendung.

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 Hilfeseite der Google Cloud Console.

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, 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 dem folgenden Verfahren. 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 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 also auf Speichern und fortfahren. Der Bereich Testnutzer wird angezeigt.
   5. Klicken Sie auf Zielgruppe und dann auf den Button + NUTZER HINZUFÜGEN.
   6. Geben Sie die E‑Mail-Adresse Ihres Testnutzers ein und klicken Sie auf 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 auf der Hilfeseite der Google Cloud Console 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 / Native Anwendungen einrichten auf der Hilfeseite der Google Cloud Console.

Wählen Sie Ihr Mobilgerät aus der Liste aus, während es mit Ihrem lokalen Computer verbunden ist, und klicken Sie dann noch einmal auf Projekt ausführen, um es auszuführen. Eine ausführlichere Anleitung finden Sie auf der Website für Android-Entwickler unter Apps auf einem Hardwaregerät ausführen.

Wenn Sie einen vorhandenen OAuth-Client haben

Wenn du bereits einen bestätigten OAuth-Client für eine veröffentlichte App hast, kannst du diesen zum Testen der Home APIs verwenden.

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 ein Limit von 100 Nutzern. Informationen zum Hinzufügen von Testnutzern finden Sie unterOAuth-Zustimmungsbildschirm einrichten Unabhängig von der OAuth-Überprüfung gibt es ein von den Home APIs auferlegtes Limit von 100 Nutzern, die deiner Anwendung Berechtigungen erteilen können. Diese Einschränkung wird nach Abschluss der Developer Console-Registrierung aufgehoben.

• DieDeveloper Console-Registrierung sollte zur Genehmigung gesendet werden, wenn du bereit bist, die Berechtigungen für Gerätetypen über OAuth einzuschränken, um deine App mit den Home APIs zu aktualisieren.

Bei Google Cloud-Apps, für die die OAuth-Überprüfung noch aussteht, können Nutzer den OAuth-Vorgang erst abschließen, wenn die Überprüfung abgeschlossen ist. Versuche, Berechtigungen zu gewähren, schlagen mit dem folgenden Fehler fehl:

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