שנתחיל?

התוכנית 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 ושל Device Access Sandbox, בתוספת עמלה חד-פעמית שלא ניתן לקבל עליה החזר כספי (5 דולר ארה"ב) לכל חשבון.

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

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

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

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

למידע נוסף, ראו Device Access רישום.

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

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

• כל מכשירי Google Nest Thermostat
• כל המצלמות של Google Nest
• כל פעמוני הדלת של Google Nest
• Google Nest Hub Max

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

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

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

הגדרה של Google Cloud Platform

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

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

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

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

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

1. מפעילים את Smart Device Management API בדף API להפעלה.
2. מקבלים Client-ID של OAuth 2.0 בדף Credentials.

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

חזרה למסוף Device Access .

1. במסך הבית של המסוף, בוחרים באפשרות יצירת פרויקט.
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.