מתחילים

התוכנית Device Access מאפשרת למשתמשים לגשת למכשירי Google Nest, לשלוט בהם ולנהל אותם באמצעות SDM API.

כדי להתחיל להשתמש ב- Device Access, עליך להשלים את המשימות הבאות:

1. עליך להירשם Device Access לתוכנית.
2. הפעלת מכשיר Nest נתמך באמצעות חשבון Google.
3. יוצרים פרויקט ב-Google Cloud כדי להפעיל את SDM API ולקבל מזהה לקוח ב-OAuth 2.0.
4. יצירת Device Access פרויקט כדי לקבל מזהה פרויקט.

הרשמה לקבלת גישה למכשיר

לפני יצירת הפרויקט הראשון שלך עליך להירשם ל- Device Access. ההרשמה כוללת הסכמה לתנאים ולהגבלות של Google API ושל ארגז החול לגישה למכשירים, בתוספת עמלה חד-פעמית שאינה ניתנת להחזר (5 דולר ארה"ב) לכל חשבון.

תוכלו ליצור פרויקט רק אחרי שתאשרו את שני התנאים וההגבלות ותשלמו את דמי הרישום. האיסור הזה רלוונטי לכל המשתמשים, גם למשתמשים פרטיים וגם למשתמשים שרוצים ליצור מבצע מסחרי.

אם עדיין לא עשית זאת, עליך להירשם Device Access במסוף:

כניסה ל Device Access מסוף

אזהרה: אם אתם עובדים בארגון, הקפידו להירשם באמצעות כתובת אימייל גנרית של הצוות ולא באמצעות כתובת אימייל אישית או אישית. אי אפשר לשנות את כתובת האימייל של Device Access המסוף אחרי יצירת החשבון. לפני המשך התהליך, חשוב לוודא שנכנסת לכתובת האימייל הנכונה.

מידע נוסף זמין במאמר Device Access רישום.

הפעלת מכשיר נתמך

המכשירים הבאים נתמכים בתוכנית Device Access :

• כל מכשירי Google Nest Thermostat
• כל מצלמות Google Nest
• כל מכשירי Google Nest Doorbell
• Google Nest Hub Max

רשימה של דגמי מכשירים ספציפיים מופיעה בדף מכשירים נתמכים.

הערה: צריך להפעיל מכשיר נתמך באמצעות חשבון Google. ב- Device Accessאין תמיכה בחשבונות Nest מדור קודם. לקבלת מידע נוסף על העברת חשבון Nest מדור קודם, אפשר לעיין בשאלות נפוצות על חשבונות באפליקציית Nest.

מידע על הפעלת המכשיר הנתמך מופיע במדריכים של המכשיר.

הגדרת Google Cloud Platform

הגישה ל-SDM API ניתנת דרך Google Cloud. כדי להפעיל את ה-API ולאשר חשבון Google עם מכשיר Nest נתמך, צריך פרויקט ב-Google Cloud.

השתמשו בלחצן הפעלת ה-API וקבלת מזהה לקוח של OAuth 2.0 שלמטה כדי להפעיל את Smart Device Management API ולקבל מזהה לקוח של OAuth 2.0:

1. אם יש לכם פרויקט ב-Google Cloud שאתם רוצים להשתמש בו בשביל Device Access, אתם צריכים קודם לוודא שאתם מחוברים לחשבון האדמין של הפרויקט הזה. אחרי שלוחצים על הלחצן, בוחרים את הפרויקט הקיים מרשימת הפרויקטים הזמינים. אחרת, יוצרים פרויקט חדש.
2. בוחרים באפשרות שרת אינטרנט כשמוצגת השאלה "Where are you call from?".
3. מזינים את הערך https://www.google.com בשדה Authorized References. כדי לקבל קוד הרשאה באמצעות PCM, יש צורך ב-URI להפניה אוטומטית.
4. בסיום ההגדרה, מעתיקים את מזהה הלקוח של OAuth 2.0 ואת הערכים של סוד הלקוח ומורידים את ה-JSON של פרטי הכניסה למכונה המקומית.

מפעילים את ה-API ומקבלים מזהה לקוח ב-OAuth 2.0

אם רוצים להגדיר את הפרויקט ב-Google Cloud באופן ידני, או לאמת את ההגדרה ולאחזר את פרטי הכניסה שוב:

1. מפעילים את Smart Device Management API בדף הפעלת ה-API.
2. מקבלים מזהה לקוח מסוג OAuth 2.0 בדף Credentials.

יצירת פרויקט גישה למכשירים

חוזרים Device Access למסוף.

1. במסך הבית של המסוף בוחרים באפשרות Create project.
2. ממלאים כל מסך בתהליך היצירה:
   1. נותנים שם לפרויקט.
   2. מזינים את מזהה הלקוח ב-OAuth 2.0 שנוצר במהלך הגדרת Google Cloud Platform. אם לא העתקתם את מזהה הלקוח של OAuth קודם לכן, אפשר למצוא אותו בקובץ credentials.json שהורדתם.
      הערה: כדי להשתמש בפרויקט עם SDM API:

      • צריך לציין מזהה לקוח חוקי של OAuth עבור הפרויקט.
      • מזהה הלקוח של OAuth צריך להיות חוקי וייחודי ל- project, ואי אפשר לשתף אותו עם חשבונות projectאחרים.
   3. להפעיל או להשבית אירועים. האירועים מנוהלים על ידי Google Cloud Pub/Sub, ומספקים עדכונים אסינכרוניים לכל המכשירים והמבנים שמורשים לפרויקט. אם רוצים להשתמש באירועים, בוחרים באפשרות הפעלה. אם לא בטוחים, בוחרים באפשרות Disable. תמיד אפשר להפעיל אותן בשלב מאוחר יותר.
3. בסיום התהליך, המערכת מקצה לפרויקט מזהה פרויקט בצורת UUID, למשל 32c4c2bc-fe0d-461b-b51c-f3885afff2f0. שימו לב למזהה הזה, אתם צריכים אותו לכל הקריאות ל-SDM API.

המערכת משתמשת במזהה הפרויקט הזה בקריאות ל-OAuth ול-API. הוא ספציפיDevice Access לפרויקט שלכם, ולא קשור למזהה הפרויקט ב-Google Cloud.