إنشاء مشروع مطوِّر

ننصحك بـ تنفيذ خادم OAuth 2.0 قبل إنشاء مشروع Cloud-to-cloud.

تتم إدارة مشاريع المطوّرين، التي تتضمّن عمليات التكامل Cloud-to-cloud، على Google Home Developer Console. توضّح هذه الصفحة كيفية إعداد مشروع جديد للمطوّرين على Developer Console.

تسمية المشروع

عند تسمية مشروعك، من المستحسن اختيار اسم:

  • يتضمّن بعض المعلومات الأساسية عن المشروع
  • لا يمكن الخلط بينه وبين اسم مشروع آخر
  • يمكن أن يمثّل جميع الأجهزة ضمن المشروع integration

الأسماء الواضحة مهمة. الاسم العام، مثل project-gamma-798، "مموّه" بشكل فعّال ولن يبرز في قائمة المشاريع الأخرى التي تحمل أسماء عامة.

يُرجى مراعاة الإرشادات التالية عند تسمية مشروعك:

  • استخدام اسم شركتك
  • استخدام نوع المشروع أو الإجراء في الاسم
  • عدم استخدام كلمة "اختبار" في اسم المشروع

على سبيل المثال، acme-smarthome وacme-lighting هما اسما مشروعين واضحان وفريدان.

إنشاء المشروع

يمثّل مشروع المطوّرين عملية تكامل واحدة أو أكثر ، ولا يمكن أن يكون أي منها عملية تكامل Cloud-to-cloud. من خلال مشاركة مشروع مع أعضاء فريق التطوير، يمكن للمالك السماح لمستخدمين آخرين بإدارة جميع عمليات التكامل في المشروع.

تتم إدارة عمليات التكامل في نظام Google Smart Home Ecosystem باستخدام الـ Developer Console.

الطريقة 1: إنشاء مشروع جديد

انتقِل إلى Developer Console:

انتقِل إلى Developer Console

  1. في صفحة إدارة المشاريع ، انقر على إنشاء مشروع.
  2. في صفحة البدء ، انقر على إنشاء مشروع.
  3. أدخِل اسم مشروعك، الذي يجب أن يلتزم بـ إرشادات تسمية المشاريع.
  4. انقر على إنشاء مشروع جديد.

ستتم إعادة توجيهك إلى صفحة الرئيسية للمشروع الجديد.

الطريقة 2: استيراد مشروع حالي من وحدة تحكّم Actions on Google

يمكن استيراد مشروع Actions on Google حالي إلى Developer Console الجديد إذا كنت بحاجة إلى إضافة دعم Matter إلى عملية تكامل Cloud-to-cloud أو Local Home SDK حالية.

تنطبق القيود التالية على هذه الطريقة:

  • هذه عملية استيراد أحادية الاتجاه فقط. لا يمكن التراجع عنها.
  • يمكن لمالك المشروع فقط استيراد Actions on Google مشروع حالي. المالك هو الشخص الذي أنشأ المشروع، ويمكن الاطّلاع عليه باستخدام الرابط الأعضاء.
  • لا يمكن تعديل الملف الشخصي للشركة لمشروع مستورَد إلا في Actions on Google Console. ستظهر التغييرات التي يتم إجراؤها هناك في Google Home Developer Console.

بعد الاستيراد، سيظل بإمكانك استخدام مشروع Actions on Google الأصلي لإدارة عمليات التكامل الحالية (مثل Cloud-to-cloud و Local Home وApp Discovery).

لاستيراد مشروع حالي من Actions on Google Console، انتقِل إلى Developer Console:

انتقِل إلى Developer Console

  1. انقر على إنشاء مشروع.
  2. أدخِل اسم مشروع حالي من Actions أو اختَر مشروعًا من القائمة المنسدلة (على سبيل المثال، في لقطة الشاشة التالية، اسم المشروع هو "مشروع Matter").
  3. انقر على استيراد المشروع.

ستتم إعادة توجيهك إلى تفاصيل المشروع الحالي في Developer Console.

مركز مطوّري Google Home: بدء الاستخدام

ضبط مستويات التسجيل

تلقائيًا، يتم حفظ سجلّات الأخطاء فقط في Google Cloud لكل عملية تكامل في مشروعك.

لحفظ جميع السجلّات في Google Cloud لكل عملية تكامل، اختَر All logs في قسم التحكّم في مستوى التسجيل: سجلّات الأخطاء.

مستويات سجلّ المشاريع في "مركز مطوّري Google Home"

ينطبق هذا الإعداد على جميع عمليات التكامل في مشروعك. لا يمكن إلغاؤه إلا لعمليات التكامل Cloud-to-cloud. قد يؤدي حفظ جميع السجلّات في Google Cloud إلى تكلفة إضافية إذا تم تجاوز مساحة تخزين السجلّات.

لمزيد من المعلومات عن السجلّات، يُرجى الاطّلاع على تسجيل السجلّات في السحابة لـ Cloud-to-cloud .

مشاركة مشروع مطوّرين

يمكنك إضافة إذن الوصول إلى مشروع أو إزالته من بين المستخدمين في فريقك باستخدام الأدوار المحدّدة مسبقًا.

  1. في صفحة الرئيسية في Developer Console، انقر على الأعضاء، ما يؤدي إلى نقلك إلى صفحة إدارة الهوية وإمكانية الوصول والمشرف > إدارة الهوية وإمكانية الوصول على Google Cloud Console.

    بدلاً من ذلك، انقر على تفاصيل المشروع، ثم انقر على إدارة الأعضاء في Google Cloud Platform في قسم الأعضاء في أسفل الصفحة.

  2. أجرِ التغييرات اللازمة باستخدام Google Cloud Console لوحة البيانات.

لمعرفة تعليمات حول كيفية تعديل إذن الوصول إلى مشروع، يُرجى الرجوع إلى الـ تحكّم في الوصول إلى المشاريع باستخدام إدارة الهوية وإمكانية الوصول.

بعد إضافة مستخدم إلى قائمة المستخدمين، يمكنه الاطّلاع على المشروع وأي عمليات تكامل في الـ Developer Console.

وفقًا لإعداد مؤسستك، قد تظهر لك أخطاء في الأذونات عند محاولة إنشاء مشاريع مطوّرين. إذا حدث ذلك، تواصَل مع مشرف Google Cloud واطلب أذونات "منشئ المشاريع" لحسابك.