Erste Schritte

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

Für den Einstieg in Device Accessmüssen Sie die folgenden Aufgaben ausführen:

1. Registrieren Sie sich für das Device Access Programm.
2. Ein unterstütztes Nest-Gerät mit einem Google-Konto aktivieren.
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. Für die Registrierung gelten die Nutzungsbedingungen der Google API und der Gerätezugriffs-Sandbox sowie eine einmalige, nicht erstattungsfähige Gebühr von 5$pro Konto.

Sie können erst dann ein Projekt erstellen, wenn Sie die Nutzungsbedingungen akzeptiert und die Registrierungsgebühr bezahlt haben. Dies gilt für alle Nutzer, sowohl für einzelne Nutzer 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 Console Device Access

Warnung :Wenn Sie für eine Organisation arbeiten, verwenden Sie für die Registrierung eine allgemeine Team-E-Mail-Adresse statt einer persönlichen oder individuellen E-Mail-Adresse. Die E-Mail-Adresse für die Device Access Console kann nach dem Erstellen des Kontos nicht mehr geändert werden. Prüfen Sie, ob Sie mit der richtigen E-Mail-Adresse angemeldet sind, bevor Sie fortfahren.

Weitere Informationen findest du unter Device Access Registrierung.

Unterstütztes Gerät aktivieren

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

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

Eine Liste der einzelnen Gerätemodelle findest du auf der Seite Unterstützte Geräte.

Hinweis :Ein unterstütztes Gerät muss mit einem Google-Konto aktiviert werden. Alte Nest-Konten werden für Device Accessnicht unterstützt. Weitere Informationen zur Migration eines alten Nest-Kontos findest du in den FAQ zu Nest App-Konten.

Informationen dazu, wie du dein unterstütztes Gerät aktivierst, 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, 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. Wählen Sie dann das vorhandene Projekt aus der Liste der verfügbaren Projekte aus, nachdem Sie auf die Schaltfläche geklickt haben. Erstellen Sie andernfalls ein neues Projekt.
2. Wenn Sie gefragt werden, von wo aus Sie anrufen, Webserver auswählen.
3. Geben Sie https://www.google.com als Wert für Autorisierte Weiterleitungs-URIs ein. Ein Weiterleitungs-URI ist erforderlich, um einen Autorisierungscode mit 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 abrufen

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. Rufen Sie eine OAuth 2.0-Client-ID auf der Seite Anmeldedaten ab.

Gerätezugriff-Projekt 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 die einzelnen Bildschirme des Erstellungsvorgangs 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 du deine OAuth-Client-ID noch nicht kopiert hast, findest du sie in der credentials.json-Datei, die du heruntergeladen hast.
      Hinweis:So verwenden Sie ein Projekt mit der SDM API:

      • Sie müssen eine gültige OAuth-Client-ID für das Projekt angeben.
      • Eine OAuth-Client-ID muss gültig und für ein projecteindeutig sein. Sie darf nicht für andere projects freigegeben werden.
   3. Ereignisse aktivieren oder deaktivieren Ereignisse werden von Google Cloud Pub/Sub verwaltet und bieten asynchrone Updates für alle für Ihr Projekt autorisierten Geräte und Strukturen. Wählen Sie Aktivieren aus, wenn Sie Ereignisse verwenden 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 zugewiesen, z. B. 32c4c2bc-fe0d-461b-b51c-f3885afff2f0. 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 bezieht sich nicht auf eine Google Cloud-Projekt-ID.