الخطوات الأولى

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

لبدء استخدام 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 وحدة التحكّم

تحذير: يجب استخدام حساب 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

يتم توفير إمكانية الوصول إلى واجهة برمجة التطبيقات لمجموعة أدوات Smart Device Management من خلال Google Cloud. لتفعيل واجهة برمجة التطبيقات وتفويض حساب Google باستخدام جهاز Nest متوافق، ستحتاج إلى مشروع على Google Cloud.

استخدِم الزر تفعيل واجهة برمجة التطبيقات والحصول على معرّف عميل OAuth 2.0 أدناه لتفعيل Smart Device Management API والحصول على معرّف عميل OAuth 2.0:

1. إذا كان لديك مشروع حالي على Google Cloud تريد استخدامه مع Device Access، تأكَّد من تسجيل الدخول إلى حساب المشرف لهذا المشروع أولاً. بعد النقر على الزر، اختَر المشروع الحالي من قائمة projects المتاحة. بخلاف ذلك، أنشئ مشروعًا جديدًا.
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. في الشاشة الرئيسية لـ 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.