لاستخدام مشروع مع واجهة برمجة التطبيقات لمجموعة أدوات SDM، يجب تحديد معرّف عميل OAuth للمشروع.
التسجيل في برنامج Device Access
قبل إنشاء مشروعك الأول، يجب التسجيل في Device Access.
يتضمّن التسجيل قبول بنود خدمة Google API ووضع الحماية للوصول إلى الأجهزة، بالإضافة إلى رسوم غير قابلة للاسترداد تُدفع لمرة واحدة (5 دولار أمريكي) لكل حساب.
لن تتمكّن من إنشاء مشروع إلى أن توافق على بنود الخدمة وتدفع رسوم التسجيل. ينطبق ذلك على جميع المستخدمين، سواء كانوا أفرادًا أو يبحثون عن إنشاء عرض تجاري.
سجِّل في Device Access Console إذا لم يسبق لك ذلك:
بعد التسجيل، أنشئ مشروعًا باتّباع الخطوات التالية:
في الشاشة الرئيسية لوحدة التحكّم، انقر على
add_circle_outline إنشاء
مشروع. إذا لم يظهر لك
هذا الخيار، يعني ذلك أنّك بلغت الحدّ الأقصى المسموح به في حسابك ولا يمكنك إنشاء
مشروع آخر.
املأ كل شاشة في عملية الإنشاء:
أدخِل اسمًا لمشروعك.
اختياري: أدخِل معرّف عميل OAuth 2.0 من مشروعك على Google Cloud. يمكنك تخطّي هذه الخطوة وتعديلها لاحقًا إذا لم يكن لديك معرّف عميل بعد. راجِع مقالة
إعداد Google Cloud Platform
للحصول على تعليمات حول كيفية الحصول على معرّف العميل.
تفعيل الأحداث أو إيقافها تتم إدارة الأحداث من خلال خدمة Google Cloud Pub/Sub، وتتيح تحديثات غير متزامنة لجميع الأجهزة والتركيبات المصرّح بها لمشروعك. إذا كنت تريد الأحداث، انقر على
تفعيل الأحداث، ثم على إنشاء مشروع، ثم عدِّل موضوع Pub/Sub وقدِّم معرّف موضوع. إذا لم تكن متأكدًا، انقر على إيقاف.
ويمكن تفعيلها في أي وقت لاحق.
عند اكتمال مشروعك، يتم تعيين معرّف مشروع له، ويكون على شكل معرّف فريد عالميًا (UUID)، مثل 32c4c2bc-fe0d-461b-b51c-f3885afff2f0. دوِّن هذا المعرّف،
لأنّك ستحتاج إليه في جميع طلبات البيانات من واجهة برمجة التطبيقات لمجموعة أدوات SDM.
يُستخدَم رقم تعريف المشروع هذا في طلبات البيانات من واجهة برمجة التطبيقات وعبر بروتوكول OAuth. وهو خاص
Device Access بمشروعك، ولا يرتبط بمعرّف مشروع على Google Cloud.
بيئة المشروع
بعد إنشاء مشروعك، يتم ضبط البيئة على Sandbox . تبدأ جميع المشاريع في هذه البيئة.
إذا كنت تخطّط لاستخدام Device Access للاستخدام الشخصي، ليس عليك اتّخاذ أي إجراء آخر. سيظل مشروعك في "وضع الحماية".
تاريخ التعديل الأخير: 2025-07-29 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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."]]
