מתחילים

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

כדי להתחיל להשתמש ב- 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 :

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

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

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

הגדרת Google Cloud Platform

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

כדי להפעיל את Smart Device Management API ולקבל מזהה לקוח של OAuth 2.0, לוחצים על הלחצן Enable the API and get an OAuth 2.0 Client ID (הפעלת ה-API וקבלת מזהה לקוח של OAuth 2.0):

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

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

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

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

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

  1. במסך הבית של מסוף Google Cloud, בוחרים באפשרות יצירת פרויקט.
  2. ממלאים את כל המסכים בתהליך היצירה:
    1. נותנים שם לפרויקט.
    2. מזינים את מזהה הלקוח ב-OAuth 2.0 שנוצר במהלך הגדרת Google Cloud Platform. אם לא העתקתם קודם את מזהה הלקוח ב-OAuth, תוכלו למצוא אותו בקובץ credentials.json שהורדתם.
    3. מפעילים או משביתים אירועים. האירועים מנוהלים על ידי Google Cloud Pub/Sub ומספקים עדכונים אסינכרוניים לכל המכשירים והמבנים שמוסמכים לפרויקט. בוחרים באפשרות הפעלה אם רוצים אירועים. אם אתם לא בטוחים, בוחרים באפשרות השבתה. תמיד אפשר להפעיל אותם מאוחר יותר.
  3. בסיום, יוקצה לפרויקט מזהה פרויקט (Project ID) בצורת מזהה UUID, למשל 32c4c2bc-fe0d-461b-b51c-f3885afff2f0. חשוב לזכור את המזהה הזה, כי הוא נדרש בכל הקריאות ל-SDM API.

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

הבא
2. אישור חשבון