با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
را Device Access این برنامه به کاربران امکان می دهد با استفاده از SDM API به دستگاه های Google Nest دسترسی، کنترل و مدیریت کنند.
برای شروع با Device Access، باید کارهای زیر را انجام دهید:
ثبت نام برای Device Access برنامه
یک دستگاه Nest پشتیبانی شده را با حساب Google فعال کنید.
برای فعال کردن SDM API و دریافت شناسه مشتری OAuth 2.0، یک پروژه Google Cloud ایجاد کنید.
ایجاد یک Device Access پروژه برای دریافت شناسه پروژه
برای دسترسی به دستگاه ثبت نام کنید
قبل از ایجاد اولین پروژه خود، باید در آن ثبت نام کنید Device Access. ثبت نام شامل پذیرش Google API و شرایط سرویس Sandbox دسترسی به دستگاه ، همراه با یک بار هزینه غیرقابل استرداد (5 دلار آمریکا) برای هر حساب است.
تا زمانی که هر دو شرایط خدمات را نپذیرفته باشید و هزینه ثبت نام را پرداخت نکرده باشید، نمی توانید پروژه ای ایجاد کنید. این برای همه کاربران، چه کاربران فردی و چه کسانی که به دنبال ایجاد یک پیشنهاد تجاری هستند، صدق می کند.
ثبت نام در Device Access کنسول، اگر قبلاً این کار را نکرده اید:
برای اطلاعات در مورد نحوه فعال کردن دستگاه پشتیبانی شده خود، به دفترچه راهنمای دستگاه مراجعه کنید.
Google Cloud Platform را راه اندازی کنید
دسترسی به SDM API از طریق Google Cloud ارائه می شود. برای فعال کردن API و مجوز یک حساب Google با یک دستگاه Nest پشتیبانی شده، به یک پروژه Google Cloud نیاز دارید.
برای فعال کردن API مدیریت دستگاه هوشمند و دریافت شناسه مشتری OAuth 2.0 از Enable the API استفاده کنید و یک دکمه OAuth 2.0 Client ID در زیر دریافت کنید:
اگر یک پروژه Google Cloud موجود دارید که می‌خواهید از آن استفاده کنید Device Access، مطمئن شوید که ابتدا به حساب مدیریت آن پروژه وارد شده اید. سپس پس از کلیک روی دکمه، پروژه موجود را از لیست پروژه های موجود انتخاب کنید. در غیر این صورت، یک پروژه جدید ایجاد کنید.
وقتی از شما می پرسد "از کجا تماس می گیری؟" سرور وب را انتخاب کنید.
https://www.google.com را به عنوان مقدار URIهای مجاز تغییر مسیر وارد کنید. یک URI تغییر مسیر برای به دست آوردن کد مجوز با استفاده از PCM مورد نیاز است.
پس از تکمیل راه‌اندازی، OAuth 2.0 Client ID و مقادیر Client Secret را کپی کنید و Credentials JSON را در دستگاه محلی خود دانلود کنید .
اگر می‌خواهید پروژه Google Cloud خود را به صورت دستی راه‌اندازی کنید، یا تنظیمات را تأیید کنید و دوباره اعتبار خود را بازیابی کنید:
API مدیریت دستگاه هوشمند را در صفحه فعال سازی API فعال کنید.
شناسه مشتری OAuth 2.0 را در صفحه اعتبارنامه دریافت کنید.
یک پروژه دسترسی به دستگاه ایجاد کنید
بازگشت به Device Access کنسول.
در صفحه اصلی کنسول، add_circle_outline ایجاد پروژه را انتخاب کنید.
هر صفحه را در فرآیند ایجاد پر کنید:
یک نام برای پروژه خود وارد کنید.
شناسه مشتری OAuth 2.0 ایجاد شده در حین راه اندازی Google Cloud Platform را وارد کنید. اگر قبلاً شناسه مشتری OAuth خود را کپی نکرده‌اید، می‌توانید آن را در فایل credentials.json که دانلود کرده‌اید پیدا کنید.
فعال یا غیرفعال کردن رویدادها رویدادها توسط Google Cloud Pub/Sub مدیریت می‌شوند و به‌روزرسانی‌های ناهمزمان را برای همه دستگاه‌ها و ساختارهای مجاز برای پروژه شما ارائه می‌دهند. اگر رویدادها را می خواهید، فعال کردن رویدادها ، سپس ایجاد پروژه را انتخاب کنید، و سپس موضوع Pub/Sub را ویرایش کنید و شناسه موضوع ارائه دهید. اگر مطمئن نیستید، Disable را انتخاب کنید. آنها همیشه می توانند بعداً فعال شوند.
پس از تکمیل، به پروژه شما یک شناسه پروژه، به شکل UUID، مانند 32c4c2bc-fe0d-461b-b51c-f3885afff2f0 اختصاص داده می شود. این شناسه را یادداشت کنید، برای همه تماس‌های SDM API به آن نیاز دارید.
این شناسه پروژه در تماس‌های OAuth و API استفاده می‌شود. مخصوص شماستDevice Access پروژه، و به شناسه پروژه 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."]]
