Erste Schritte

Mit dem Programm Device Access können Nutzer mithilfe der SDM API auf Google Nest-Geräte zugreifen, sie steuern und verwalten.

Bevor Sie Device Accessverwenden können, müssen Sie die folgenden Aufgaben ausführen:

  1. Registrieren Sie sich für das Programm Device Access .
  2. Aktiviere ein unterstütztes Nest-Gerät mit einem Google-Konto.
  3. Erstellen Sie ein Google Cloud-Projekt, um die SDM API zu aktivieren und eine OAuth 2.0-Client-ID abzurufen.
  4. Erstellen Sie ein Device Access -Projekt, um eine Projekt-ID zu erhalten.

Für Gerätezugriff registrieren

Bevor Sie Ihr erstes Projekt erstellen, müssen Sie sich für Device Accessregistrieren. Wenn Sie sich registrieren, akzeptieren Sie die Nutzungsbedingungen der Google API und der Device Access Sandbox sowie eine einmalige, nicht erstattungsfähige Gebühr von 5$pro Konto.

Du kannst erst dann ein Projekt erstellen, wenn du die Nutzungsbedingungen akzeptiert und die Registrierungsgebühr bezahlt hast. Dies gilt für alle Nutzer, sowohl einzelne Nutzer als auch Nutzer, die ein kommerzielles Angebot erstellen möchten.

Registrieren Sie sich in der Device Access Console, falls noch nicht geschehen:

Rufen Sie die Device Access Console auf.

Weitere Informationen finden Sie unter Device Access Registrierung.

Unterstütztes Gerät aktivieren

Die folgenden Geräte werden im Device Access -Programm unterstützt:

  • Alle Google Nest Thermostate
  • Alle Google Nest-Kameras
  • Alle Google Nest Doorbells
  • Google Nest Hub Max

Auf der Seite Unterstützte Geräte finden Sie eine Liste der einzelnen Gerätemodelle.

Informationen zur Aktivierung deines unterstützten Geräts findest du in den Gerätehandbüchern.

Google Cloud Platform einrichten

Der Zugriff auf die SDM API erfolgt über Google Cloud. Sie benötigen ein Google Cloud-Projekt, um die API zu aktivieren und ein Google-Konto mit einem unterstützten Nest-Gerät zu autorisieren.

Verwenden Sie die Schaltfläche API aktivieren und OAuth 2.0-Client-ID abrufen unten, um die Smart Device Management API zu aktivieren und eine OAuth 2.0-Client-ID abzurufen:

  1. Wenn Sie bereits ein Google Cloud-Projekt haben, das Sie für Device Accessverwenden möchten, müssen Sie zuerst im Administratorkonto für dieses Projekt angemeldet sein. Klicken Sie dann auf die Schaltfläche und wählen Sie das vorhandene Projekt aus der Liste der verfügbaren Projekte aus. Erstellen Sie andernfalls ein neues Projekt.
  2. Wählen Sie Webserver aus, wenn die Meldung „Von wo aus rufen Sie an?“ angezeigt wird.
  3. Geben Sie https://www.google.com als Wert für Autorisierte Weiterleitungs-URIs ein. Ein Weiterleitungs-URI ist erforderlich, um einen Autorisierungscode mithilfe von PCM abzurufen.
  4. Sobald die Einrichtung abgeschlossen ist, kopieren Sie die Werte für die OAuth 2.0-Client-ID und den Clientschlüssel und laden Sie die JSON-Datei mit den Anmeldedaten auf Ihren lokalen Computer herunter.
API aktivieren und OAuth 2.0-Client-ID anfordern

Wenn Sie Ihr Google Cloud-Projekt manuell einrichten oder die Einrichtung prüfen und Ihre Anmeldedaten noch einmal abrufen möchten:

  1. Aktivieren Sie die Smart Device Management API auf der Seite API-Aktivierung.
  2. Fordern Sie auf der Seite Anmeldedaten eine OAuth 2.0-Client-ID an.

Gerätezugriffsprojekt erstellen

Kehren Sie zur Device Access Console zurück.

  1. Wählen Sie auf dem Startbildschirm der Console Projekt erstellen aus.
  2. Füllen Sie jeden Bildschirm während der Erstellung aus:
    1. Geben Sie einen Namen für Ihr Projekt an.
    2. Geben Sie die OAuth 2.0-Client-ID ein, die während der Einrichtung der Google Cloud Platform generiert wurde. Wenn du deine OAuth-Client-ID zuvor noch nicht kopiert hast, findest du sie in der heruntergeladenen Datei credentials.json.
    3. Ereignisse aktivieren oder deaktivieren Ereignisse werden von Google Cloud Pub/Sub verwaltet und bieten asynchrone Updates für alle Geräte und Strukturen, die für Ihr Projekt autorisiert sind. Wählen Sie Aktivieren aus, wenn Sie Ereignisse sehen möchten. Wenn Sie sich nicht sicher sind, wählen Sie Deaktivieren aus. Sie können später jederzeit wieder aktiviert werden.
  3. Nach Abschluss wird Ihrem Projekt eine Projekt-ID in Form einer UUID wie 32c4c2bc-fe0d-461b-b51c-f3885afff2f0 zugewiesen. Notieren Sie sich diese ID, da Sie sie für alle SDM API-Aufrufe benötigen.

Diese Projekt-ID wird in OAuth- und API-Aufrufen verwendet. Sie ist spezifisch für IhrDevice Access -Projekt und nicht mit einer Google Cloud-Projekt-ID.