البدء

يتيح برنامج 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 ووضع الحماية Device Access، بالإضافة إلى رسوم غير قابلة للاسترداد تُدفع لمرة واحدة (5 دولارات أمريكية) لكل حساب.

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

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

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

تحذير: يجب استخدام حساب مستهلِك على Google (على سبيل المثال، حساب gmail.com) للتسجيل في برنامج الوصول إلى الأجهزة. لا يمكنك استخدام حساب Google Workspace. إذا كنت تعمل لدى مؤسسة، ننصحك بالتسجيل في "مشروع الوصول إلى الأجهزة" باستخدام حساب خاص بفريقك.

تحذير: بعد ربط حساب Google بمشروع "الوصول إلى الأجهزة"، لا يمكن تغييره، لذا تأكَّد من تسجيل الدخول إلى حساب Google الصحيح قبل المتابعة.

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

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

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

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

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

ملاحظة: يجب تفعيل جهاز متوافق باستخدام حساب Google. لا تتوافق حسابات Nest القديمة مع Device Access. يمكنك الاطّلاع على الأسئلة الشائعة حول الحسابات في تطبيق Nest لمزيد من المعلومات حول نقل حساب قديم على Nest.

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

إعداد 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 الذي نزّلته.
      ملاحظة: لاستخدام مشروع مع واجهة برمجة تطبيقات SDM، اتّبِع الخطوات التالية:

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

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