Jetzt starten

Das Device Access Programm ermöglicht Nutzern den Zugriff auf Google Nest-Geräte sowie deren Steuerung und Verwaltung über die SDM API.

Für die Verwendung von Device Accessmüssen Sie die folgenden Aufgaben ausführen:

  1. Registrieren Sie sich für das Device Access Programm.
  2. Aktivieren Sie 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 zu erhalten.
  4. Erstellen Sie ein Device Access Projekt, um eine Projekt-ID zu erhalten.

Für den Gerätezugriff registrieren

Bevor Sie Ihr erstes Projekt erstellen, müssen Sie sich für Device Accessregistrieren. Die Registrierung umfasst die Annahme der Google API und der Device Access Sandbox Nutzungsbedingungen sowie eine einmalige, nicht erstattungsfähige Gebühr in Höhe von 5$pro Konto.

Sie können erst ein Projekt erstellen, wenn Sie beiden Nutzungsbedingungen zugestimmt und die Registrierungsgebühr bezahlt haben. Dies gilt für alle Nutzer, sowohl für Einzelnutzer als auch für Nutzer, die ein kommerzielles Angebot erstellen möchten.

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

Zur Device Access Console

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-Türklingeln
  • Google Nest Hub Max

Eine Liste der einzelnen Gerätemodelle finden Sie auf der Seite Unterstützte Geräte.

Informationen zum Aktivieren Ihres unterstützten Geräts finden Sie in den Gerätehandbüchern.

Google Cloud Platform einrichten

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

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

  1. Wenn Sie ein vorhandenes Google Cloud-Projekt verwenden möchten für Device Access, melden Sie sich zuerst im Administratorkonto für dieses Projekt an. Wählen Sie dann nach dem Klicken auf die Schaltfläche das vorhandene Projekt aus der Liste der verfügbaren Projekte aus. Andernfalls erstellen Sie ein neues Projekt.
  2. Wählen Sie bei der Frage „Wo rufen Sie an?“ die Option Webserver aus.
  3. Geben Sie https://www.google.com als Wert für Autorisierte Weiterleitungs-URIs ein. Ein Weiterleitungs-URI ist erforderlich, um mit PCM einen Autorisierungscode zu erhalten.
  4. Nach Abschluss der Einrichtung kopieren Sie die Werte für die OAuth 2.0-Client-ID und das Client-Secret und laden Sie die JSON-Datei mit den Anmeldedaten auf Ihren lokalen Computer herunter.
API aktivieren und OAuth 2.0-Client-ID abrufen

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

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

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ühren Sie die einzelnen Schritte des Erstellungsprozesses aus:
    1. Geben Sie einen Namen für Ihr Projekt an.
    2. Geben Sie die OAuth 2.0-Client-ID ein, die bei der Einrichtung der Google Cloud Platform generiert wurde. Wenn Sie Ihre OAuth-Client-ID zuvor nicht kopiert haben, finden Sie sie in der heruntergeladenen Datei credentials.json.
    3. Aktivieren oder deaktivieren Sie Ereignisse. Ereignisse werden von Google Cloud Pub/Sub verwaltet und stellen asynchrone Updates für alle Geräte und Gebäude bereit, die für Ihr Projekt autorisiert sind. Wenn Sie Ereignisse verwenden möchten, wählen Sie Ereignisse aktivieren und dann Projekt erstellen aus. Bearbeiten Sie dann das Pub/Sub Thema und geben Sie eine Themen-ID an. Wenn Sie sich nicht sicher sind, wählen Sie Deaktivieren aus. Sie können Ereignisse jederzeit später aktivieren.
  3. Nach Abschluss der Einrichtung wird Ihrem Projekt eine Projekt-ID in Form einer UUID zugewiesen, z. B. 32c4c2bc-fe0d-461b-b51c-f3885afff2f0. Notieren Sie sich diese ID. Sie benötigen sie für alle SDM API-Aufrufe.

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

Weiter
2. Konto autorisieren