شروع کنید

Device Access این برنامه به کاربران اجازه می‌دهد تا با استفاده از SDM API به دستگاه‌های Google Nest دسترسی داشته باشند، آنها را کنترل و مدیریت کنند.

برای شروع با Device Access، شما باید وظایف زیر را انجام دهید:

  1. ثبت نام برای Device Access برنامه.
  2. یک دستگاه Nest پشتیبانی‌شده را با یک حساب Google فعال کنید.
  3. یک پروژه Google Cloud ایجاد کنید تا SDM API را فعال کنید و یک شناسه کلاینت OAuth 2.0 دریافت کنید.
  4. ایجاد یک Device Access پروژه برای دریافت شناسه پروژه.

برای دسترسی به دستگاه ثبت نام کنید

قبل از ایجاد اولین پروژه خود، باید ثبت نام کنید Device Accessثبت‌نام شامل پذیرش API گوگل و شرایط خدمات دسترسی به دستگاه (Device Access Sandbox ) به همراه هزینه‌ای یک‌باره و غیرقابل استرداد (۵ دلار آمریکا) برای هر حساب کاربری است.

تا زمانی که هر دو شرایط خدمات را نپذیرید و هزینه ثبت نام را پرداخت نکنید، نمی‌توانید پروژه‌ای ایجاد کنید. این موضوع برای همه کاربران، چه کاربران شخصی و چه کسانی که به دنبال ایجاد یک پیشنهاد تجاری هستند، صدق می‌کند.

ثبت نام در Device Access کنسول، اگر هنوز این کار را نکرده‌اید:

برو به Device Access کنسول

ببینید Device Access ثبت نام برای اطلاعات بیشتر.

فعال کردن یک دستگاه پشتیبانی شده

دستگاه‌های زیر در این سیستم پشتیبانی می‌شوند Device Access برنامه:

  • همه ترموستات‌های گوگل نست
  • همه دوربین‌های گوگل نست
  • همه زنگ‌های درب گوگل نست
  • گوگل نست هاب مکس

برای مشاهده‌ی لیست مدل‌های دستگاه‌های پشتیبانی‌شده، به صفحه‌ی دستگاه‌های پشتیبانی‌شده مراجعه کنید.

برای اطلاعات در مورد نحوه فعال‌سازی دستگاه پشتیبانی‌شده خود، به دفترچه‌های راهنمای دستگاه مراجعه کنید.

راه‌اندازی پلتفرم ابری گوگل

دسترسی به API مربوط به SDM از طریق Google Cloud فراهم می‌شود. برای فعال کردن API و تأیید حساب گوگل با یک دستگاه پشتیبانی‌شده توسط Nest، به یک پروژه Google Cloud نیاز دارید.

برای فعال کردن API مدیریت دستگاه هوشمند و دریافت شناسه مشتری OAuth 2.0، از دکمه «فعال کردن API و دریافت شناسه مشتری OAuth 2.0» در زیر استفاده کنید:

  1. اگر یک پروژه Google Cloud موجود دارید که می‌خواهید از آن استفاده کنید Device Access، مطمئن شوید که ابتدا وارد حساب کاربری ادمین آن پروژه شده‌اید. سپس پس از کلیک روی دکمه، پروژه موجود را از لیست پروژه‌های موجود انتخاب کنید. در غیر این صورت، یک پروژه جدید ایجاد کنید.
  2. وقتی از شما می‌پرسد «از کجا تماس می‌گیرید؟» ، گزینه‌ی «وب سرور» را انتخاب کنید.
  3. برای دریافت کد مجوز با استفاده از PCM، به آدرس https://www.google.com به عنوان مقدار برای Authorized redirect URIs نیاز است.
  4. پس از اتمام نصب، مقادیر OAuth 2.0 Client ID و Client Secret را کپی کنید و فایل JSON مربوط به Credentials را روی دستگاه محلی خود دانلود کنید .
فعال کردن API و دریافت شناسه کلاینت OAuth 2.0

اگر می‌خواهید پروژه Google Cloud خود را به صورت دستی تنظیم کنید، یا تنظیمات را تأیید کنید و دوباره اعتبارنامه‌های خود را بازیابی کنید:

  1. در صفحه فعال‌سازی API، رابط برنامه‌نویسی کاربردی مدیریت دستگاه هوشمند (Smart Device Management API) را فعال کنید.
  2. یک شناسه کلاینت OAuth 2.0 در صفحه اعتبارنامه‌ها دریافت کنید.

ایجاد یک پروژه دسترسی به دستگاه

بازگشت به Device Access کنسول.

  1. در صفحه اصلی کنسول، گزینه Create project را انتخاب کنید.
  2. هر صفحه را در فرآیند ایجاد پر کنید:
    1. یک نام برای پروژه خود وارد کنید.
    2. شناسه کلاینت OAuth 2.0 که در طول راه‌اندازی پلتفرم ابری گوگل ایجاد شده است را وارد کنید. اگر شناسه کلاینت OAuth خود را قبلاً کپی نکرده‌اید، می‌توانید آن را در فایل credentials.json که دانلود کرده‌اید، پیدا کنید.
    3. فعال یا غیرفعال کردن رویدادها. رویدادها توسط Google Cloud Pub/Sub مدیریت می‌شوند و به‌روزرسانی‌های غیرهمزمان را برای همه دستگاه‌ها و ساختارهای مجاز برای پروژه شما ارائه می‌دهند. اگر رویدادها را می‌خواهید، گزینه Enable events ، سپس Create Project را انتخاب کنید و سپس موضوع Pub/Sub را ویرایش کنید و یک شناسه موضوع ارائه دهید. اگر مطمئن نیستید، گزینه Disable را انتخاب کنید. آن‌ها همیشه می‌توانند بعداً فعال شوند.
  3. پس از اتمام، به پروژه شما یک شناسه پروژه، به شکل UUID، مانند 32c4c2bc-fe0d-461b-b51c-f3885afff2f0 اختصاص داده می‌شود. این شناسه را یادداشت کنید، برای همه فراخوانی‌های SDM API به آن نیاز دارید.

این شناسه پروژه در فراخوانی‌های OAuth و API استفاده می‌شود. این شناسه مختص پروژه شماست.Device Access پروژه، و به شناسه پروژه Google Cloud مربوط نیست.