شروع کنید

l10n- -

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

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

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

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

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

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

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

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

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

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

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

  • همه ترموستات‌های Google Nest
  • همه دوربین‌های Google Nest
  • همه زنگ‌های درهای Google Nest
  • Google Nest Hub Max

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

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

Google Cloud Platform را راه اندازی کنید

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

برای فعال کردن API مدیریت دستگاه هوشمند و دریافت شناسه مشتری OAuth 2.0 از Enable the API استفاده کنید و یک دکمه OAuth 2.0 Client ID در زیر دریافت کنید:

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

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

  1. API مدیریت دستگاه هوشمند را در صفحه فعال سازی API فعال کنید.
  2. شناسه مشتری OAuth 2.0 را در صفحه اعتبارنامه دریافت کنید.

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

به کنسول Device Access برگردید.

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

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