البدء

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

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

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

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

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

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