Erste Schritte

Mit dem Device Access -Programm können Nutzer auf die Inhalte zugreifen, diese steuern und verwalten Google Nest-Geräte, die die SDM API verwenden

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 und rufen Sie eine OAuth 2.0-Client-ID ab.
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. Die Registrierung umfasst die Annahme der Google API und des Geräts Zugriff auf die Nutzungsbedingungen für die Sandbox sowie einmalig nicht erstattbare Gebühr (5 US-Dollar) pro Konto.

Sie können erst ein Projekt erstellen, wenn Sie beide Nutzungsbedingungen Service und die Registrierungsgebühr bezahlt. Dies gilt für alle Nutzer, sowohl und für diejenigen, die ein kommerzielles zu bieten.

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

Zur Console Device Access

Warnung :Wenn Sie für eine Organisation arbeiten, registrieren Sie sich mit einer allgemeinen Team-E-Mail-Adresse. und nicht mit einer persönlichen oder individuellen E-Mail-Adresse. 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. Informationen.

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

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

Hinweis :Ein unterstütztes Gerät muss mit einem Google-Konto aktiviert werden. Altes Nest-Gerät Konten werden nicht für Device Accessunterstützt. Weitere Informationen finden Sie in den häufig gestellten Fragen (FAQs) zu Konten für die Nest App zur Migration eines alten Nest-Kontos.

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 Um die API zu aktivieren und ein Google-Konto mit ein unterstütztes Nest-Gerät haben, benötigen Sie eine Google Cloud Projekt arbeiten.

Klicken Sie zum Aktivieren unten auf die Schaltfläche API aktivieren und OAuth 2.0-Client-ID abrufen. die Smart Device Management API und rufen Sie eine OAuth 2.0-Client-ID ab:

1. Wenn Sie bereits ein Google Cloud-Projekt haben, zur Verwendung für Device Access, prüfen Sie, ob Sie im Administratorkonto angemeldet sind für dieses Projekt erstellen. Wählen Sie dann das vorhandene Projekt aus der Liste der nach dem Klicken auf die Schaltfläche verfügbar. Andernfalls erstellen Sie ein neues Projekt arbeiten.
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 Weiterleitung ein. URIs. Ein Weiterleitungs-URI ist erforderlich, um einen Autorisierungscode mithilfe von PCM.
4. Sobald die Einrichtung abgeschlossen ist, kopieren Sie die OAuth 2.0-Client-ID und den Clientschlüssel und laden Sie die JSON-Datei für die Anmeldedaten auf Ihren lokalen Computer herunter.

API aktivieren und OAuth 2.0-Client-ID abrufen

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

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

Gerätezugriff-Projekt erstellen

Kehren Sie zur Device Access Console zurück.

1. Wählen Sie auf dem Startbildschirm der Console Erstellen
2. Füllen Sie jeden Bildschirm im Erstellungsprozess aus:
   1. Geben Sie einen Namen für Ihr Projekt an.
   2. OAuth 2.0-Client-ID eingeben, die generiert wurde während Google Cloud Platform einrichten Wenn Sie OAuth-Client-ID zuvor nicht kopiert haben, finden Sie sie im credentials.json heruntergeladene Datei.
      Hinweis: Wenn Sie ein Projekt mit der Methode SDM-API:

      • Sie müssen eine gültige OAuth-Client-ID für das Projekt angeben.
      • Eine OAuth-Client-ID muss gültig und eindeutig für projectund kann nicht mit anderen projects geteilt werden.
   3. Ereignisse aktivieren oder deaktivieren Ereignisse werden von Google Cloud Pub/Sub verwaltet und bieten asynchrone Updates für alle Geräte und Gebäude an. die für Ihr Projekt autorisiert sind. Wählen Sie Aktivieren aus, wenn Sie Ereignisse verwenden möchten. Wenn 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, z. B. 32c4c2bc-fe0d-461b-b51c-f3885afff2f0. Notieren Sie sich die ID, Sie benötigen ihn für alle SDM-API-Aufrufe.

Diese Projekt-ID wird in OAuth- und API-Aufrufen verwendet. Sie gilt speziell für Ihre Device Access -Projekt festgelegt und ist nicht mit einer Google Cloud verknüpft Projekt-ID.