קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
Device Access התוכנית מאפשרת למשתמשים לגשת למכשירי Google Nest, לשלוט בהם ולנהל אותם באמצעות ה-API של SDM.
כדי להתחיל להשתמש ב- Device Access, צריך לבצע את המשימות הבאות:
נרשמים ל Device Access תוכנית.
מפעילים מכשיר Nest נתמך באמצעות חשבון Google.
יוצרים פרויקט ב-Google Cloud כדי להפעיל את SDM API ולקבל מזהה לקוח ב-OAuth 2.0.
יוצרים פרויקט Device Access כדי לקבל מזהה פרויקט.
הרשמה לקבלת גישה למכשירים
לפני שיוצרים את הפרויקט הראשון, צריך להירשם ל- Device Access.
ההרשמה כוללת אישור של התנאים וההגבלות של Google API ושל Device Access Sandbox, וכן תשלום חד-פעמי בסך 5$ לאחד החשבונות (לא ניתן לקבל החזר על התשלום).
לא תוכלו ליצור פרויקט עד שתאשרו את התנאים וההגבלות ותשלמו את דמי ההרשמה. המדיניות הזו חלה על כל המשתמשים, גם על משתמשים פרטיים וגם על משתמשים שרוצים ליצור מוצר מסחרי.
נרשמים ל- Device Access מסוף, אם עדיין לא עשיתם זאת:
במדריכי המכשירים מוסבר איך להפעיל את המכשיר הנתמך.
הגדרת 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):
אם יש לכם פרויקט קיים ב-Google Cloud שאתם רוצים להשתמש בו ל- Device Access, עליכם לוודא שאתם מחוברים לחשבון האדמין של הפרויקט הזה. לאחר מכן, לוחצים על הלחצן ובוחרים את הפרויקט הקיים מרשימת הפרויקטים הזמינים. אחרת, יוצרים פרויקט חדש.
בוחרים באפשרות Web Server (שרת אינטרנט) כשמופיעה השאלה 'Where are you calling from?' (מאיפה אתם מתקשרים?).
מזינים את הערך https://www.google.com בשדה URIs מורשים להפניה אוטומטית. כדי לקבל קוד הרשאה באמצעות PCM, נדרש מזהה URI להפניה אוטומטית.
בסיום ההגדרה, מעתיקים את הערכים של מזהה הלקוח וסודות הלקוח ב-OAuth 2.0 ומורידים את קובץ ה-JSON של פרטי הכניסה למחשב המקומי.
במסך הבית של מסוף Google Cloud, בוחרים באפשרות add_circle_outline יצירת פרויקט.
ממלאים את כל המסכים בתהליך היצירה:
נותנים שם לפרויקט.
מזינים את מזהה הלקוח ב-OAuth 2.0 שנוצר במהלך הגדרת Google Cloud Platform. אם לא העתקתם קודם את מזהה הלקוח ב-OAuth, תוכלו למצוא אותו בקובץ credentials.json שהורדתם.
מפעילים או משביתים אירועים. האירועים מנוהלים על ידי Google Cloud Pub/Sub, ומספקים עדכונים אסינכרוניים לכל המכשירים והמבנים המורשים בפרויקט. אם רוצים להשתמש באירועים, בוחרים באפשרות Enable events (הפעלת אירועים), ואז באפשרות Create Project (יצירת פרויקט). לאחר מכן עורכים את נושא Pub/Sub ומספקים מזהה נושא. אם אתם לא בטוחים, בוחרים באפשרות השבתה.
תמיד אפשר להפעיל אותם מאוחר יותר.
בסיום, לפרויקט יוקצה מזהה פרויקט, בצורת מזהה UUID, כמו 32c4c2bc-fe0d-461b-b51c-f3885afff2f0. חשוב לזכור את המזהה הזה, כי הוא נדרש בכל הקריאות ל-SDM API.
מזהה הפרויקט הזה משמש בקריאות ל-OAuth ול-API. הוא ספציפי לפרויקטDevice Access ולא קשור למזהה הפרויקט ב-Google Cloud.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-06-03 (שעון UTC)."],[[["\u003cp\u003eThe Device Access program enables users to access and manage Google Nest devices via the SDM API.\u003c/p\u003e\n"],["\u003cp\u003eTo utilize Device Access, users must register for the program, activate a supported Nest device with a Google account, and set up a Google Cloud project for API access.\u003c/p\u003e\n"],["\u003cp\u003eA Device Access project needs to be created, requiring a unique Project ID for all SDM API calls, and users must use a consumer Google Account for registration.\u003c/p\u003e\n"],["\u003cp\u003eSupported devices include all Google Nest Thermostats, Cameras, Doorbells, and Google Nest Hub Max.\u003c/p\u003e\n"]]],[],null,["# Get Started\n\nThe Device Access program allows users to access, control, and manage\nGoogle Nest devices using the SDM API.\n\nTo get started with Device Access, you need to complete the following tasks:\n\n1. Register for the Device Access program.\n2. Activate a supported Nest device with a Google account.\n3. Create a Google Cloud project to enable the SDM API and get an OAuth 2.0 client ID.\n4. Create a Device Access project to receive a Project ID.\n\nRegister for Device Access\n--------------------------\n\nBefore creating your first project, you must register for Device Access.\nRegistration consists of the acceptance of the [Google API](/terms) and [Device\nAccess Sandbox](/nest/device-access/tos) Terms of Service, along with a one-time,\nnon-refundable fee (US$5) per account.\n\nYou will not be able to create a project until you have accepted both Terms of\nService and paid the registration fee. This applies to all users, both\nindividual users and those looking to create a commercial\noffering.\n\nRegister in the Device Access Console, if you haven't already:\n\n[Go to the Device Access Console](https://console.nest.google.com/device-access)\n| **Warning:** You must use a [consumer Google Account](https://support.google.com/work/android/answer/6371476) (for example, a gmail.com account) to register for Device Access. You cannot use a Google Workspace account. If you work for an organization, we suggest registering for Device Access using an account for your team.\n| **Warning:** Once a Google Account is associated with your Device Access Project **it cannot be changed**, be sure you are signed into the correct Google Account before continuing.\n\nSee [Device Access Registration](/nest/device-access/registration) for more\ninformation.\n\nActivate a supported device\n---------------------------\n\nThe following devices are supported in the Device Access program:\n\n- All Google Nest Thermostats\n- All Google Nest Cameras\n- All Google Nest Doorbells\n- Google Nest Hub Max\n\nSee the [Supported Devices](/nest/device-access/supported-devices) page for a\nlisting of individual device models.\n| **Note:** A supported device must be activated with a Google account. Legacy Nest accounts are **not** supported for Device Access. See the [FAQs\n| about accounts for the Nest app](https://support.google.com/googlenest/answer/9297676) for more information on migrating a legacy Nest account.\n\nSee the device manuals for information on how to activate your supported device.\n\nSet up Google Cloud Platform\n----------------------------\n\nAccess to the SDM API is provided through\nGoogle Cloud. To enable the API and authorize a Google account with\na supported Nest device, you'll need a Google Cloud\nproject.\n\nUse the **Enable the API and get an OAuth 2.0 Client ID** button below to enable\nthe **Smart Device Management API** and get an OAuth 2.0 Client ID:\n\n1. If you have an existing Google Cloud project that you would like to use for Device Access, make sure you are logged into the admin account for that project first. Then select the existing project from the list of available projects after clicking the button. Otherwise, create a new project.\n2. Select **Web Server** when it asks \"Where are you calling from?\".\n3. Enter *https://www.google.com* as the value for **Authorized redirect\n URIs**. A redirect URI is required to obtain an Authorization Code using PCM.\n4. Once setup is complete, **copy the OAuth 2.0 Client ID and Client Secret\n values, and download the Credentials JSON to your local machine**.\n\nEnable the API and get an OAuth 2.0 Client ID\n\nIf you want to manually set up your Google Cloud project, or verify\nthe setup and retrieve your credentials again:\n\n1. Enable **Smart Device Management API** on the [API Enablement](https://console.developers.google.com/apis/library/smartdevicemanagement.googleapis.com) page.\n2. Get an OAuth 2.0 Client ID on the [Credentials](https://console.developers.google.com/apis/credentials) page.\n\nCreate a Device Access project\n------------------------------\n\nReturn to the Device Access Console.\n\n1. At the Console home screen, select **add_circle_outline Create\n project**.\n2. Fill out each screen in the creation process:\n 1. Enter a name for your project.\n 2. Enter the OAuth 2.0 Client ID generated during [Set up Google Cloud Platform](#set_up_google_cloud_platform). If you didn't copy your OAuth Client ID earlier, you can find it in the `credentials.json` file you downloaded. **Note:** To use a project with the SDM API:\n | - You must specify a valid OAuth Client ID for the project.\n | - An OAuth Client ID must be valid and unique to a project, and cannot be shared with other projects.\n 3. Enable or disable events. Events are managed by Google Cloud Pub/Sub and provide asynchronous updates for all devices and structures authorized for your project. If you want events, select **Enable events** , then **Create Project** , and then edit the Pub/Sub topic and provide a Topic ID. If you're not sure, select **Disable**. They can always be enabled later.\n3. Upon completion, your project is assigned a Project ID, in the form of a UUID, such as `32c4c2bc-fe0d-461b-b51c-f3885afff2f0`. Make note of this ID, you need it for all SDM API calls.\n\nThis Project ID is used in OAuth and API calls. It is specific to your\nDevice Access project, and is not related to a Google Cloud\nProject ID."]]
