התחל בעבודה

התוכנית 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$לחשבון (התשלום לא ניתן להחזרה).

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

אם עדיין לא נרשמתם ל-Console, עליכם לעשות זאת: Device Access

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

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

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

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

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

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

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

הגדרת 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. כשמופיעה השאלה 'מאיפה מתקשרים?', בוחרים באפשרות Web Server (שרת אינטרנט).
3. מזינים את הערך https://www.google.com בשדה Authorized redirect URIs. כדי לקבל קוד הרשאה באמצעות PCM, צריך להזין כתובת URI להפניה אוטומטית.
4. אחרי שמסיימים את ההגדרה, מעתיקים את הערכים של מזהה הלקוח וסוד הלקוח של OAuth 2.0 ומורידים את קובץ ה-JSON של פרטי הכניסה למחשב המקומי.

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

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

1. בדף API Enablement (הפעלת API), מפעילים את Smart Device Management API.
2. מקבלים מזהה לקוח OAuth 2.0 בדף פרטי כניסה.

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

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

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

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