تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يتيح Device Access البرنامج للمستخدمين الوصول إلى أجهزة Google Nest والتحكّم فيها وإدارتها باستخدام واجهة برمجة التطبيقات لمجموعة أدوات Smart Device Management.
لبدء استخدام Device Access، عليك إكمال المهام التالية:
سجِّل في Device Access البرنامج.
فعِّل جهاز Nest متوافقًا باستخدام حساب Google.
أنشئ مشروعًا على Google Cloud لتفعيل
واجهة برمجة التطبيقات لمجموعة أدوات SDM والحصول على معرّف عميل OAuth 2.0.
أنشئ Device Access مشروعًا للحصول على معرّف مشروع.
التسجيل في ميزة "الوصول إلى الجهاز"
قبل إنشاء مشروعك الأول، عليك التسجيل في Device Access.
يتضمّن التسجيل قبول بنود خدمة Google API ووضع الحماية لميزة "الوصول إلى الجهاز"، بالإضافة إلى دفع رسوم مُجدوَلة لمرة واحدة (5 دولار أمريكي) لكل حساب.
لن تتمكّن من إنشاء مشروع إلا بعد قبول بنود الخدمة ودفع رسوم التسجيل. ينطبق ذلك على جميع المستخدمين، سواءً
المستخدمين الفرديين أو المستخدمين الذين يريدون إنشاء عرض تجاري.
سجِّل في Device Access Console إذا لم يسبق لك ذلك:
يُرجى الاطّلاع على صفحة الأجهزة المتوافقة للاطّلاع على قائمة بموديلات الأجهزة الفردية.
اطّلِع على أدلة الأجهزة للحصول على معلومات عن كيفية تفعيل جهازك المتوافق.
إعداد Google Cloud Platform
يتم توفير إمكانية الوصول إلى واجهة برمجة التطبيقات لمجموعة أدوات Smart Device Management من خلال
Google Cloud. لتفعيل واجهة برمجة التطبيقات وتفويض حساب Google باستخدام
جهاز Nest متوافق، ستحتاج إلى
مشروع على Google Cloud.
استخدِم الزر تفعيل واجهة برمجة التطبيقات والحصول على معرّف عميل OAuth 2.0 أدناه لتفعيل
Smart Device Management API والحصول على معرّف عميل OAuth 2.0:
إذا كان لديك مشروع حالي على Google Cloud تريد
استخدامه مع Device Access، تأكَّد من تسجيل الدخول إلى حساب المشرف
لهذا المشروع أولاً. بعد النقر على الزر، اختَر المشروع الحالي من قائمة projects المتاحة. بخلاف ذلك، أنشئ
مشروعًا جديدًا.
اختَر خادم الويب عندما يُطلب منك الإجابة عن السؤال "من أين تتصل؟".
أدخِل https://www.google.com كقيمة لعناوين URI المُصرَّح بها
لإعادة التوجيه. يجب إدخال معرّف موارد منتظم لإعادة التوجيه من أجل الحصول على رمز تفويض باستخدام
PCM.
بعد اكتمال عملية الإعداد، انسخ قيم معرّف العميل وسر العميل لبروتوكول OAuth 2.0
، ثم نزِّل ملف JSON الخاص ببيانات الاعتماد على جهازك.
في الشاشة الرئيسية لـ Console، انقر على
add_circle_outline إنشاء
مشروع.
املأ كل شاشة في عملية الإنشاء:
أدخِل اسمًا لمشروعك.
أدخِل معرِّف عميل OAuth 2.0 الذي تم إنشاؤه أثناء
إعداد Google Cloud Platform. إذا
لم تنسخ رقم تعريف عميل OAuth في وقت سابق، يمكنك العثور عليه فيملف
credentials.json الذي نزّلته.
تفعيل الأحداث أو إيقافها تتم إدارة الأحداث من خلال خدمة Google Cloud Pub/Sub
وتوفّر تحديثات غير متزامنة لجميع الأجهزة والتركيبات
المفوَّضة لمشروعك. إذا كنت تريد الأحداث، اختَر
تفعيل الأحداث، ثم إنشاء مشروع، ثم عدِّلموضوع Pub/Sub
وقدِّم معرّف الموضوع. إذا لم تكن متأكدًا، اختَر إيقاف.
ويمكن تفعيلها في أي وقت لاحق.
عند اكتمال المشروع، يتمّ منحه معرّف مشروع على شكل رمز صعِد UUID، مثل 32c4c2bc-fe0d-461b-b51c-f3885afff2f0. دوِّن هذا المعرّف،
فأنت بحاجة إليه لجميع طلبات البيانات من واجهة برمجة التطبيقات لمجموعة أدوات SDM.
يُستخدَم رقم تعريف المشروع هذا في طلبات البيانات من واجهة برمجة التطبيقات وOAuth. وهو خاص بمشروعك على
Device Access Google Cloud، ولا يرتبط برقم تعريف
مشروع على Google Cloud.
تاريخ التعديل الأخير: 2025-06-03 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-06-03 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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."]]
