إنشاء تطبيق Google Chat باستخدام "برمجة تطبيقات Google"

توضّح هذه الصفحة كيفية إنشاء إضافة Google Workspace تعمل في Google Chat باستخدام "برمجة تطبيقات Google".

يتيح لك تطبيق Chat إرسال رسائل مباشرة والردّ عليها من خلال تكرار رسائلك.

يعرض الرسم البياني التالي البنية ونمط المراسلة:

في الرسم البياني السابق، يتّبع المستخدم الذي يتفاعل مع تطبيق Chat في "برمجة تطبيقات Google" تدفق المعلومات التالي:

1. يرسل المستخدم رسالة إلى تطبيق Chat، إما في رسالة مباشرة أو في مساحة Chat.
2. تتلقّى منطق تطبيق Chat الذي تم تنفيذه في "برمجة تطبيقات Google" الرسالة وتعالجها، ويقع هذا المنطق في Google Cloud.
3. يمكن لمنطق تطبيق Chat اختياريًا التكامل مع خدمات Google Workspace، مثل "تقويم Google" أو "جداول بيانات Google"، أو خدمات Google الأخرى، مثل "خرائط Google" أو YouTube.
4. يرسل منطق تطبيق Chat ردًا إلى خدمة تطبيق Chat في Chat.
5. يتم تسليم الرد إلى المستخدم.

الأهداف

• إعداد البيئة
• إعداد النص البرمجي
• ضبط تطبيق Chat
• اختبار تطبيق Chat

المتطلبات الأساسية

• حساب Business أو Enterprise على Google Workspace مع إمكانية الوصول إلى Google Chat.
• مشروع على Google Cloud لإنشاء مشروع، يُرجى الاطّلاع على مقالة إنشاء مشروع على Google Cloud.

إعداد البيئة

فتح مشروع على السحابة الإلكترونية في Google Cloud Console

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

1. في Google Cloud Console، انتقِل إلى صفحة اختيار مشروع.

   اختيار مشروع على السحابة الإلكترونية

2. اختَر مشروع Google Cloud الذي تريد استخدامه. أو انقر على إنشاء مشروع واتّبِع التعليمات التي تظهر على الشاشة. إذا أنشأت مشروعًا على Google Cloud، قد تحتاج إلى تفعيل الفوترة للمشروع.

تفعيل Chat API

قبل استخدام واجهات برمجة تطبيقات Google، عليك تفعيلها في مشروع على Google Cloud. يمكنك تفعيل واجهة برمجة تطبيقات واحدة أو أكثر في مشروع واحد على Google Cloud.

في Google Cloud Console، فعِّل Google Chat API.

تفعيل واجهة برمجة التطبيقات

ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth

تتطلّب جميع التطبيقات التي تستخدم OAuth 2.0 ضبط شاشة طلب الموافقة. يؤدي ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth لتطبيقك إلى تحديد ما يظهر للمستخدمين ومراجعي التطبيقات، وتسجيل تطبيقك لتتمكّن من نشره لاحقًا.

1. في Google API Console، انتقِل إلى "القائمة" menu > منصة Google للمصادقة > العلامة التجارية.

   الانتقال إلى العلامة التجارية

2. إذا سبق لك ضبط منصة Google للمصادقة، يمكنك ضبط إعدادات شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth التالية في العلامة التجارية والجمهور والوصول إلى البيانات. إذا ظهرت لك رسالة لم يتم ضبط منصة Google للمصادقة بعد، انقر على البدء:
1. ضمن معلومات التطبيق، في اسم التطبيق، أدخِل اسمًا للتطبيق.
2. في البريد الإلكتروني لدعم المستخدمين، اختَر عنوان بريد إلكتروني للدعم يمكن للمستخدمين التواصل معك من خلاله إذا كانت لديهم أسئلة حول موافقتهم.
3. انقر على التالي.
4. ضمن الجمهور، اختَر داخلي.
5. انقر على التالي.
6. ضمن معلومات الاتصال، أدخِل عنوان بريد إلكتروني يمكنك تلقّي إشعارات من خلاله بشأن أي تغييرات تطرأ على مشروعك.
7. انقر على التالي.
8. ضمن إنهاء، راجِع سياسة بيانات المستخدمين في خدمات Google API، وإذا كنت موافقًا، ضَع علامة في المربّع أوافق على "سياسة بيانات المستخدمين في خدمات Google API".
9. انقر على متابعة.
10. انقر على إنشاء.
3. يمكنك الآن تخطّي إضافة النطاقات. في المستقبل، عند إنشاء تطبيق لاستخدامه خارج مؤسسة Google Workspace، عليك تغيير نوع المستخدم إلى خارجي. بعد ذلك، أضِف نطاقات التفويض التي يتطلّبها تطبيقك. لمزيد من المعلومات، يُرجى الاطّلاع على دليل ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth الكامل .

إعداد النص البرمجي

لإعداد النص البرمجي، استخدِم نموذج تطبيق Chat من صفحة البدء في "برمجة تطبيقات Google".

إنشاء مشروع "برمجة تطبيقات Google"

1. من صفحة البدء في "برمجة تطبيقات Google"، انتقِل إلى نماذج أولية لإضافات Google Workspace وانقر على نموذج تطبيق Chat:

   فتح نموذج تطبيق Chat

2. في مشروع "برمجة تطبيقات Google" الجديد الذي يفتح، أدخِل اسمًا للمشروع:

   1. انقر على مشروع بلا عنوان.

   2. في عنوان المشروع ، اكتب Add-on Chat app.

   3. انقر على إعادة تسمية.

في المستقبل، إذا أردت استخدام Google APIs معيّنة أو نشر تطبيقك، عليك ربط مشروع على السحابة الإلكترونية بمشروع "برمجة تطبيقات Google". لا تحتاج إلى إجراء ذلك في هذا الدليل. لمزيد من المعلومات، يُرجى الاطّلاع على دليل مشاريع Google Cloud.

إنشاء عملية نشر تجريبية

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

للحصول على رقم تعريف عملية نشر الإصدار الرئيسي، اتّبِع الخطوات التالية:

1. في مشروع "برمجة تطبيقات Google" لتطبيق Chat، انقر على نشر > عمليات النشر التجريبية.
2. انسخ رقم تعريف عملية نشر الإصدار الرئيسي لاستخدامه في خطوة لاحقة، ثم انقر على تم.

ضبط تطبيق Chat

اتّبِع الخطوات التالية لضبط تطبيق Google Chat:

1. في Google API Console، ابحث عن Google Chat API، وانقر على Google Chat API.
2. انقر على إدارة.

3. انقر على الإعدادات واضبط تطبيق Chat:

   1. في حقل اسم التطبيق ، أدخِل Add-on Chat app.
   2. في حقل عنوان URL للصورة الرمزية ، أدخِل https://developers.google.com/workspace/add-ons/images/quickstart-app-avatar.png.
   3. في حقل الوصف ، أدخِل Add-on Chat app.
   4. ضمن الوظائف ، اختَر الانضمام إلى المساحات والمحادثات الجماعية.
   5. ضمن "إعدادات الاتصال"، اختَر مشروع "برمجة تطبيقات Google".
   6. في حقل رقم تعريف عملية النشر ، ألصِق رقم تعريف عملية نشر الإصدار الرئيسي الذي سبق لك نسخه.
   7. ضمن "مدى الظهور"، اختَر مستخدمون ومجموعات معيّنة في نطاقك ، وأدخِل عنوان بريدك الإلكتروني.

4. انقر على حفظ.

أصبح تطبيق Chat جاهزًا للردّ على الرسائل.

اختبار تطبيق Chat

لاختبار تطبيق Chat، افتح مساحة رسالة مباشرة مع تطبيق Chat وأرسِل رسالة:

1. افتح Google Chat باستخدام حساب Google Workspace الذي قدّمته عند إضافة نفسك كمختبِر موثوق به.

   الانتقال إلى Google Chat

2. انقر على add محادثة جديدة.
3. في حقل إضافة مستخدم واحد أو أكثر ، اكتب اسم تطبيق Chat.

4. اختَر تطبيق Chat من النتائج. تُفتح رسالة مباشرة.

5. في الرسالة المباشرة الجديدة مع التطبيق، اكتب Hello واضغط على enter.

   يشكرك تطبيق Chat على إضافته ويكرّر رسالتك.

لإضافة مختبِرين موثوق بهم ومزيد من المعلومات عن اختبار الميزات التفاعلية، يُرجى الاطّلاع على مقالة اختبار الميزات التفاعلية لتطبيقات Google Chat.

تحديد المشاكل وحلّها

عندما يعرض تطبيق أو بطاقة في Google Chat خطأً، تعرض واجهة Chat رسالة "حدث خطأ ما". أو "يتعذّر معالجة طلبك". في بعض الأحيان، لا تعرض واجهة مستخدم Chat أي رسالة خطأ، ولكن تطبيق Chat أو البطاقة يعرض نتيجة غير متوقّعة، على سبيل المثال، قد لا تظهر رسالة بطاقة.

على الرغم من أنّه قد لا تظهر رسالة خطأ في واجهة مستخدم Chat، تتوفّر رسائل خطأ وصفية وبيانات السجلّ لمساعدتك في حلّ الأخطاء عند تفعيل تسجيل الأخطاء لتطبيقات Chat. للحصول على مساعدة في عرض الأخطاء وتصحيحها وحلّها، يُرجى الاطّلاع على تحديد أخطاء Google Chat وحلّها.

تَنظيم

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

1. في Google API Console، انتقِل إلى صفحة إدارة الموارد. انقر على القائمة menu > المشرف وإدارة الهوية وإمكانية الوصول > إدارة الموارد.

   الانتقال إلى Resource Manager

2. في قائمة المشاريع، اختَر المشروع الذي تريد حذفه، ثم انقر على حذف delete.
3. في مربّع الحوار، اكتب رقم تعريف المشروع، ثم انقر على إيقاف لحذف المشروع.