Google is committed to advancing racial equity for Black communities. See how.

Autorisierungsübersicht

Die Nest API stellt Informationen bereit, mit denen Sie Ihr Zuhause gestalten können. Die Informationen sind letztendlich Eigentum der Nutzer und Nutzer können diese Informationen explizit mit Works with Nest-Produkten teilen.

Der Zweck der Autorisierung besteht darin, Ihren Kunden eine sichere Möglichkeit zu geben, Zugriff auf ihre Nest-Gerätedaten zu gewähren.

Der Ablauf sieht so aus:

Autorisierungsübersicht

Produktwebsite oder App vor der Autorisierung

Auf Ihrer Produktwebsite oder App können Sie Kunden ermöglichen, Ihrem Produkt Zugriff auf ihre Nest-Gerätedaten zu gewähren. Erstellen Sie dazu eine Schaltfläche oder ein anderes UI-Element, um den OAuth-Flow zu initiieren.

Wenn Sie die Benutzerberechtigung in Ihre App integrieren, können Sie entweder:

  • Verwenden Sie einen externen Browser, um eine App zu autorisieren
  • Verwenden Sie eine neue Seite, um eine Webapp zu authentifizieren

Für weitere Designführung finden Sie im Nest Design Richtlinien .

iFrames

iFrames präsentieren Informationen, entweder eingebettet in eine Webseite oder als Webansicht in einer nativen App. Der OAuth Fluss unterstützt nicht in iFrames Einbettung .

Nest-Login

Wenn der Benutzer noch nicht angemeldet ist, fordern wir den Benutzer auf, sich anzumelden.

Verbindungsbenachrichtigung (nur Nicht-Eigentümer)

Wenn der Benutzer Mitglied eines Familienkontos ist und nicht alle Strukturen im Konto besitzt, wird nach der Anmeldung eine Verbindungsbenachrichtigung angezeigt. In dieser Benachrichtigung ist aufgeführt, mit welchen Strukturen der Nutzer Ihr Works with Nest-Produkt autorisieren kann.

Wenn der Benutzer der Kontoinhaber ist, wird die Verbindungsbenachrichtigung nicht angezeigt und die Berechtigungsseite wird sofort nach der Anmeldung angezeigt.

Weitere Informationen finden Sie Familienkonten .

Benutzerberechtigung

Nest-Berechtigungen

Wir werden den Benutzer auffordern, Zugriff auf Ihr Produkt zu gewähren. Auf dieser Seite werden die Berechtigungen und Beschreibungen angezeigt, die Sie beim Erstellen Ihres Clients eingegeben haben.

Weitere Informationen finden Sie im siehe Berechtigungen Übersicht .

Benutzerberechtigung

Produktseite oder App nach Autorisierung

Nachdem Ihr Kunde Ihr Works with Nest-Produkt autorisiert hat, senden wir einen Autorisierungscode, den Ihr Produkt gegen ein Zugriffstoken eintauschen kann. Ihr Works with Nest-Produkt kann dann das Zugriffstoken mit API-Aufrufen senden, um auf Nest-Daten zuzugreifen.

Ihre Kunden können den Zugriff jederzeit widerrufen. Dadurch wird Ihr Works with Nest-Produkt daran gehindert, weitere Anfragen nach den Gerätedaten des Kunden zu stellen.

Um zu erfahren , wie man eine Autorisierungsablauf für einen Benutzer einzurichten und ein Zugriffstoken erhalten, findet Authentifizierung und Autorisierung mit OAuth 2.0 .