البدء

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

لبدء استخدام " 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 وحدة التحكم، إذا لم يسبق لك إجراء ما يلي:

الانتقال إلى 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. في الشاشة الرئيسية لوحدة التحكّم، اختَر add_circle_outline إنشاء مشروع.
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.