البدء

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

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

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

التسجيل في برنامج الوصول إلى الأجهزة

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

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

سجِّل في Device Access Console، إذا لم يسبق لك ذلك:

الانتقال إلى 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) لإعادة التوجيه من أجل الحصول على رمز تفويض باستخدام PCM.
  4. بعد اكتمال عملية الإعداد، انسخ قيم معرّف العميل وسر العميل في OAuth 2.0، ونزِّل ملف JSON الخاص ببيانات الاعتماد على جهازك المحلي.
تفعيل واجهة برمجة التطبيقات والحصول على معرّف عميل OAuth 2.0

إذا أردت إعداد مشروعك على Google Cloud يدويًا أو التحقّق من الإعداد واسترداد بيانات الاعتماد مرة أخرى، اتّبِع الخطوات التالية:

  1. فعِّل Smart Device Management 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، وتتيح تحديثات غير متزامنة لجميع الأجهزة والتركيبات المصرّح بها لمشروعك. إذا كنت تريد الأحداث، انقر على تفعيل الأحداث، ثم على إنشاء مشروع، ثم عدِّل موضوع Pub/Sub وقدِّم معرّف موضوع. إذا لم تكن متأكدًا، اختَر إيقاف. ويمكن تفعيلها لاحقًا في أي وقت.
  3. عند اكتمال مشروعك، يتم تعيين رقم تعريف المشروع له، ويكون على شكل معرّف فريد عالميًا (UUID)، مثل 32c4c2bc-fe0d-461b-b51c-f3885afff2f0. دوِّن هذا المعرّف، لأنّك ستحتاج إليه في جميع طلبات واجهة برمجة التطبيقات لمجموعة أدوات SDM.

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

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