الخطوات الأولى

يسمح البرنامج Device Access للمستخدمين بالوصول إلى البيانات والتحكم فيها وإدارتها أجهزة Google Nest التي تستخدم واجهة برمجة التطبيقات SDM API

لبدء استخدام " Device Access"، عليك إكمال المهام التالية:

  1. التسجيل في Device Access البرنامج.
  2. تفعيل جهاز Nest متوافق باستخدام حساب Google
  3. أنشِئ مشروعًا على Google Cloud لتفعيل واجهة برمجة تطبيقات SDM والحصول على معرِّف عميل OAuth 2.0.
  4. أنشِئ مشروعًا Device Access للحصول على رقم تعريف المشروع.

التسجيل للوصول إلى الجهاز

قبل إنشاء مشروعك الأول، يجب عليك التسجيل في Device Access. يشمل التسجيل قبول Google API والجهاز. إتاحة الوصول إلى بنود خدمة "وضع الحماية"، بالإضافة إلى خطة رسوم غير قابلة للاسترداد (5 دولارات أمريكية) لكل حساب.

لن تتمكن من إنشاء مشروع حتى توافق على بنود تم دفع رسوم التسجيل. ينطبق هذا على جميع المستخدمين، المستخدمين الفرديين والمستخدمين الذين يريدون إنشاء إعلانات عروضنا.

التسجيل في Device Access وحدة التحكّم، إذا لم يسبق لك إجراء ذلك:

الانتقال إلى Device Access وحدة التحكّم

يمكنك الاطّلاع على Device Access التسجيل للمزيد من المعلومات. المعلومات.

تفعيل جهاز متوافق

الأجهزة التالية متوافقة مع Device Access البرنامج:

  • جميع أجهزة Google Nest Thermostat
  • جميع كاميرات Google Nest
  • جميع أجهزة Google Nest Doorbell
  • Google Nest Hub Max

يمكنك الاطّلاع على صفحة الأجهزة المتوافقة للحصول على قائمة بطُرز الأجهزة الفردية.

راجِع أدلّة الأجهزة للحصول على معلومات حول كيفية تفعيل جهازك المتوافق.

إعداد Google Cloud Platform

يتم توفير الوصول إلى واجهة برمجة تطبيقات SDM من خلال Google Cloud. لتمكين واجهة برمجة التطبيقات وتفويض حساب Google باستخدام جهاز Nest متوافق، يجب أن يكون لديك جهاز Google Cloud مشروعك.

استخدِم زر تفعيل واجهة برمجة التطبيقات والحصول على معرّف عميل OAuth 2.0 أدناه للتفعيل. Smart Device Management API والحصول على معرِّف عميل OAuth 2.0:

  1. إذا كان لديك مشروع حالي على Google Cloud يهمّك للاستخدام مع Device Access، تأكَّد من تسجيل الدخول إلى حساب المشرف. لهذا المشروع أولاً. ثم حدد المشروع الحالي من قائمة للمشروعات المتاحة بعد النقر فوق الزر. بخلاف ذلك، يمكنك إنشاء حساب مشروعك.
  2. اختَر خادم الويب عند طرح السؤال "من أين تتصل؟".
  3. أدخِل https://www.google.com كقيمة إعادة التوجيه المُصرَّح بها. معرّفات الموارد المنتظمة (URI): يلزم وجود معرف موارد منتظم (URI) لإعادة التوجيه للحصول على رمز تفويض باستخدام تضمين نبضي مشفر (PCM).
  4. بعد اكتمال الإعداد، انسخ معرِّف عميل OAuth 2.0 وسر العميل. وتنزيل بيانات الاعتماد بتنسيق JSON على جهازك المحلي.
تفعيل واجهة برمجة التطبيقات والحصول على معرِّف عميل OAuth 2.0

إذا أردت إعداد مشروعك على Google Cloud يدويًا أو إثبات ملكية الإعداد واسترداد بيانات الاعتماد مرة أخرى:

  1. تفعيل Smart Device Management API على صفحة تفعيل واجهة برمجة التطبيقات
  2. الحصول على معرِّف عميل OAuth 2.0 على بيانات الاعتماد.

إنشاء مشروع "الوصول إلى الأجهزة"

ارجع إلى Device Access وحدة التحكّم.

  1. في الشاشة الرئيسية لوحدة Console، انقر على إنشاء المشروع.
  2. املأ كل شاشة في عملية الإنشاء:
    1. أدخِل اسمًا لمشروعك.
    2. إدخال معرِّف عميل OAuth 2.0 الذي تم إنشاؤه أثناء إعداد Google Cloud Platform إذا كنت لم ينسخ معرّف عميل OAuth سابقًا، يمكنك العثور عليه في تم تنزيل ملف واحد (credentials.json).
    3. تفعيل الأحداث أو إيقافها تتم إدارة الأحداث من خلال Google Cloud Pub/Sub. وتوفير تحديثات غير متزامنة لجميع الأجهزة والتركيبات المسموح بها لمشروعك. اختَر تفعيل إذا كنت تريد عرض الأحداث. في حال حذف إذا لم تكن متأكدًا، اختَر إيقاف. ويمكن دائمًا تفعيلها لاحقًا.
  3. عند الانتهاء، يتم تعيين رقم تعريف مشروع لمشروعك، في شكل المعرّف الفريد العالمي (UUID)، مثل 32c4c2bc-fe0d-461b-b51c-f3885afff2f0. قم بتدوين هذا المعرف، ستحتاجها لجميع طلبات البيانات من واجهة برمجة تطبيقات SDM.

يُستخدَم رقم تعريف المشروع هذا في طلبات OAuth وواجهة برمجة التطبيقات. إنها خاصة Device Access المشروع وليس مرتبطًا بخدمة Google Cloud رقم تعريف المشروع

التالي
2- تفويض حساب