התחל בעבודה

התוכנית 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 Console:

כניסה ל 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, לוחצים על הלחצן Enable the API and get an OAuth 2.0 Client ID (הפעלת ה-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. מפעילים את Smart Device Management API בדף API Enablement.
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. בסיום, לפרויקט מוקצה מזהה פרויקט (Project ID) בצורה של UUID, כמו 32c4c2bc-fe0d-461b-b51c-f3885afff2f0. חשוב לרשום את המזהה הזה, כי הוא נדרש לכל הקריאות ל-SDM API.

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