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 eine Berechtigung gewähren, ohne ihre 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 einzurichten. Weitere Informationen finden Sie unter Vorhandener OAuth-Client.

App signieren

Erstellen Sie zuerst einen OAuth-Schlüssel, indem Sie Ihre App in Android Studio ausführen. Wenn Sie eine App in Android Studio ausführen oder beheben, wird automatisch ein OAuth-Schlüssel für die Entwicklung und Fehlerbehebung generiert. Eine vollständige 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. Auf 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 Apps auf einem Hardwaregerät ausführen.

  2. Beenden Sie die laufende App.

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

  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 Einwilligungsbildschirm für dieses Google Cloud-Projekt noch nicht konfiguriert haben, wird die Schaltfläche Zustimmungsbildschirm konfigurieren angezeigt. Konfigurieren Sie in diesem Fall den Zustimmungsbildschirm mithilfe der folgenden Schritte. 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 mit den 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. Wenn Sie Nutzer hinzufügen möchten, um den Zugriff auf Ihre App zu testen, klicken Sie auf Nutzer hinzufügen. Der Bereich Nutzer hinzufügen wird angezeigt. Testnutzer haben die Berechtigung, Berechtigungen in Ihrer App zu gewähren.
    6. Fügen Sie im leeren Feld eine oder mehrere E-Mail-Adressen von Google-Konten hinzu und klicken Sie dann auf Hinzufügen.
    7. Klicken Sie auf Speichern und fortfahren. Der Bereich Summary (Zusammenfassung) wird angezeigt.
    8. Überprüfen Sie die Informationen auf dem OAuth-Zustimmungsbildschirm und klicken Sie dann auf Zurück zum Dashboard.

Ausführliche Informationen finden Sie in der Google Cloud Console-Hilfe unter OAuth-Zustimmungsbildschirm einrichten.

App registrieren und Anmeldedaten erstellen

Wenn Sie die App für OAuth 2.0 registrieren und OAuth-Anmeldedaten erstellen möchten, folgen Sie der Anleitung unter OAuth 2.0 einrichten. Sie müssen den App-Typ angeben, also native/Android-App.

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.

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 ausführlichere Anleitung finden Sie auf der Website für Android-Entwickler unter Apps auf einem Hardwaregerät ausführen.

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.

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 der Verwendung eines vorhandenen OAuth-Clients ist die Anzahl der Nutzer auf 100 beschränkt. Informationen zum Hinzufügen von Testnutzern finden Sie unter OAuth-Zustimmungsbildschirm einrichten. Unabhängig von der OAuth-Bestätigung gilt für Home APIs eine Beschränkung auf 100 Nutzer, die Ihrer Anwendung Berechtigungen gewähren können. Diese Einschränkung wird aufgehoben, sobald die Developer Console-Registrierung abgeschlossen ist.

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

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

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