כדי להשתמש בפרויקט עם SDM API, צריך לציין מזהה לקוח ב-OAuth עבור הפרויקט.
הרשמה לגישה למכשירים
לפני שיוצרים את הפרויקט הראשון, צריך להירשם ל- Device Access.
ההרשמה כוללת אישור של התנאים וההגבלות של Google API ושל Device Access Sandbox, וכן תשלום חד-פעמי של עמלה שלא ניתן לקבל עליה החזר (5$) לכל חשבון.
לא תוכלו ליצור פרויקט עד שתאשרו את התנאים וההגבלות ותשלמו את דמי ההרשמה. הדרישה הזו חלה על כל המשתמשים, גם על משתמשים פרטיים וגם על משתמשים שרוצים ליצור מוצר מסחרי.
אם עדיין לא עשיתם זאת, נרשמים ב- Device Access Console:
במסך הבית של המסוף, בוחרים באפשרות add_circle_outline יצירת פרויקט. אם האפשרות הזו לא מופיעה, סימן שהגעתם למגבלת הפרויקטים בחשבון ואי אפשר ליצור פרויקט נוסף.
ממלאים את כל המסכים בתהליך היצירה:
מזינים שם לפרויקט.
אופציונלי. מזינים את מזהה הלקוח ב-OAuth 2.0 מפרויקט Google Cloud. אם עדיין אין לכם Client-ID, אתם יכולים לדלג על השלב הזה ולעדכן אותו מאוחר יותר. הוראות לקבלת מזהה לקוח מופיעות במאמר הגדרת Google Cloud Platform.
הפעלה או השבתה של אירועים. האירועים מנוהלים על ידי Google Cloud Pub/Sub ומספקים עדכונים אסינכרוניים לכל המכשירים והמבנים שהורשו לפרויקט שלכם. אם רוצים להגדיר אירועים, בוחרים באפשרות הפעלת אירועים, ואז באפשרות יצירת פרויקט. לאחר מכן עורכים את נושא ה-Pub/Sub ומזינים מזהה נושא. אם לא בטוחים, בוחרים באפשרות השבתה.
תמיד אפשר יהיה להפעיל אותן מאוחר יותר.
בסיום, לפרויקט מוקצה מזהה פרויקט (Project ID) בצורה של UUID, כמו 32c4c2bc-fe0d-461b-b51c-f3885afff2f0. חשוב לשמור את המזהה הזה, כי תצטרכו אותו לכל הקריאות ל-SDM API.
מזהה הפרויקט הזה משמש ב-OAuth ובקריאות ל-API. הוא ספציפי לפרויקטDevice Access שלכם, ולא קשור למזהה פרויקט ב-Google Cloud.
סביבת הפרויקט
אחרי שיוצרים את הפרויקט, הסביבה מוגדרת כ Sandbox . כל הפרויקטים מתחילים בסביבה הזו.
אם אתם מתכננים להשתמש ב- Device Access לשימוש אישי, אתם לא צריכים לעשות שום דבר נוסף. הפרויקט יישאר בסביבת הארגז.
אם אתם מתכננים להשתמש ב- Device Access כחלק מפתרון לבית חכם מסחרי, כדאי לעיין במאמר הגשת בקשה לפיתוח מסחרי כדי להבין מהם השלבים הבאים.
[[["התוכן קל להבנה","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-07-29 (שעון UTC)."],[[["\u003cp\u003eDevice Access projects are created within the Sandbox environment and require a one-time registration fee of US$5 per Google Account.\u003c/p\u003e\n"],["\u003cp\u003eEach Google Account can have up to 3 projects, with each project needing a unique OAuth 2.0 Client ID for SDM API usage.\u003c/p\u003e\n"],["\u003cp\u003eProjects can be used for personal use in the Sandbox environment indefinitely or transitioned to commercial use by applying through a separate process.\u003c/p\u003e\n"],["\u003cp\u003eDuring project creation, you can optionally enable Google Cloud Pub/Sub for asynchronous device and structure updates, but it can also be enabled later.\u003c/p\u003e\n"],["\u003cp\u003eWhen registering for Device Access, ensure you use a consumer Google Account and understand it cannot be changed once associated with a project.\u003c/p\u003e\n"]]],[],null,["All new projects created have access to the Device Access Sandbox\nenvironment by default.\n\n- You can create up to 3 projects for a single account.\n- Multiple projects can use the same Project Name, which is displayed during the [Authorization process](/nest/device-access/authorize).\n- Each account is subject to [rate and user\n limits](/nest/device-access/project/limits).\n\nTo use a project with the SDM API, you must specify an OAuth\nClient ID for the project.\n\nRegister for Device Access\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\nCreate your project\n\nOnce registered, create a project:\n\n1. At the Console home screen, select **add_circle_outline Create\n project**. If you don't see this option, you're already at your account's limit and cannot create another project.\n2. Fill out each screen in the creation process:\n 1. Enter a name for your project.\n 2. *Optional.* Enter the OAuth 2.0 Client ID from your Google Cloud project. You can skip this and update it later if you don't have a Client ID yet. See [Set up Google Cloud Platform](/nest/device-access/get-started#set_up_google_cloud_platform) for instructions on how to obtain a Client ID. **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.\n| **Caution:** Exiting the project creation flow at any time during the process will discard all data you have entered.\n\nProject environment\n\nOnce your project is created, the environment is set to Sandbox . All\nprojects start in this environment.\n\nIf you plan to use Device Access for personal use, you don't need to do anything\nelse. Your project will remain in the Sandbox.\n\nIf you plan to use Device Access as part of a Commercial smart home\noffering, see [Apply for Commercial Development](/nest/device-access/project/apply) for next\nsteps."]]
