البدء

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

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

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

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

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

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

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

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

تحذير: إذا كنت تعمل في مؤسسة، سجِّل باستخدام عنوان بريد إلكتروني عام للفريق بدلاً من عنوان بريد إلكتروني شخصي أو فردي. لا يمكن تغيير عنوان البريد الإلكتروني Device Access لوحدة التحكّم بعد إنشاء الحساب. تأكَّد من تسجيل الدخول إلى عنوان البريد الإلكتروني الصحيح قبل المتابعة.

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

تفعيل واجهة برمجة التطبيقات والحصول على معرِّف عميل OAuth 2.0

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

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

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

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

1. على الشاشة الرئيسية لوحدة التحكّم، اختَر إنشاء مشروع.
2. املأ كل شاشة أثناء عملية الإنشاء:
   1. أدخِل اسمًا لمشروعك.
   2. أدخِل معرِّف عميل OAuth 2.0 الذي تم إنشاؤه أثناء إعداد Google Cloud. إذا لم يسبق لك نسخ معرِّف عميل OAuth، يمكنك العثور عليه في ملف credentials.json الذي نزّلته.
      ملاحظة: لاستخدام مشروع مع SDM API:

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

ويتم استخدام رقم تعريف المشروع هذا في طلبات OAuth وAPI. وهو خاص بمشروعكDevice Access ، وهو غير مرتبط برقم تعريف مشروع Google Cloud.