نقل تطبيق Google Chat

في حال دمجت المؤسسات التي تستخدم Google Workspace، قد تحتاج إلى نقل بيانات تطبيق Chat لكي يستمر في العمل.

قبل نقل بيانات تطبيق Chat، يُرجى الرجوع إلى مشرف مؤسستك لمعرفة ما إذا كانت الإعدادات الإدارية تؤثر فيه. قد يؤدي تغيير إعداد إداري إلى استعادة الوظائف الكاملة في تطبيق Chat وبالتالي جعل عملية نقل البيانات غير ضرورية. على سبيل المثال، قد يحتاج مشرف Google Workspace إلى إضافة تطبيق Chat إلى قائمة مسموح بها، أو قد يحتاج إلى السماح للمستخدمين بتثبيت تطبيقات Chat. لمزيد من المعلومات، يُرجى الاطّلاع على القسم تحديد ما إذا كان يجب نقل تطبيقات Google Chat بعد دمج مؤسسات Google Workspace.

بعد تحديد أنّك بحاجة إلى نقل بيانات تطبيق Chat، عليك إكمال العملية التالية من ثلاث خطوات:

1. يمكنك إعداد بيئة لتطبيق Chat من خلال إنشاء مشروع على Google Cloud في المؤسسة المدمجة، وتفعيل واجهات برمجة التطبيقات، واحتمال ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth 2.0.
2. أعِد نشر تطبيق Chat من مشروع Cloud الجديد.
3. أضِف تطبيق Chat المُعاد إنشاؤه إلى مساحات Chat أو المحادثات، وأوقِف تطبيق Chat الأصلي.

إنشاء مشروع على السحابة الإلكترونية في المؤسسة المدمجة وتفعيل واجهات برمجة التطبيقات

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

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

وحدة تحكُّم Google Cloud

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

   الانتقال إلى صفحة إنشاء مشروع

2. في حقل اسم المشروع، أدخِل اسمًا وصفيًا لمشروعك.

   اختياري: لتعديل رقم تعريف المشروع، انقر على تعديل. لا يمكن تغيير رقم تعريف المشروع بعد إنشاء المشروع، لذا اختَر معرّفًا يفي باحتياجاتك طوال فترة المشروع.

3. في حقل الموقع الجغرافي، انقر على تصفّح لعرض المواقع الجغرافية المحتمَلة لمشروعك. بعد ذلك، انقر على اختيار.
4. انقر على إنشاء. تنتقل وحدة التحكّم في Google Cloud إلى صفحة "لوحة البيانات" وسيتم إنشاء مشروعك في غضون بضع دقائق.

gcloud CLI

في إحدى بيئات التطوير التالية، يمكنك الوصول إلى واجهة سطر الأوامر في Google Cloud (`gcloud`):

• Cloud Shell: لاستخدام وحدة طرفية على الإنترنت تم إعداد gcloud CLI عليها، فعِّل Cloud Shell.
  تفعيل Cloud Shell
• Local Shell: لاستخدام بيئة تطوير محلية، عليك تثبيت initialize gcloud CLI.
  لإنشاء مشروع على السحابة الإلكترونية، استخدِم الأمر `gcloud project generate`:

  gcloud projects create PROJECT_ID

  استبدِل PROJECT_ID عن طريق ضبط رقم تعريف المشروع الذي تريد إنشاءه.

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

يجب تفعيل Google Chat API في جميع تطبيقات Chat. قد تحتاج إلى تفعيل واجهات برمجة تطبيقات أخرى استنادًا إلى كيفية إنشاء تطبيق Chat. على سبيل المثال، إذا أنشأت تطبيق Chat باستخدام Google Cloud Functions، عليك تفعيل Cloud Build API وCloud Functions API وPub/Sub API وCloud Logging API وArtifact Registry API وCloud Run API. لضمان عمل التطبيق الذي تم نقله، من أفضل الممارسات، عليك تفعيل واجهات برمجة التطبيقات نفسها التي تم تفعيلها في المشروع القديم على Google Cloud في المشروع الجديد على Google Cloud.

لتفعيل واجهة برمجة التطبيقات، يمكنك اتّباع الخطوات التالية:

وحدة تحكُّم Google Cloud

1. في Google Cloud Console، انتقِل إلى رمز القائمة menu > المزيد من المنتجات > Google Workspace > مكتبة المنتجات.

   الانتقال إلى "مكتبة المنتجات"

2. انقر على واجهة برمجة التطبيقات التي تريد تفعيلها.
3. انقر على تفعيل.
4. لتفعيل المزيد من واجهات برمجة التطبيقات، كرِّر هذه الخطوات.

Google Cloud CLI

1. ثبِّت واجهة سطر الأوامر (CLI) في Google Cloud أو افتحها.

2. شغِّل الأمر services enable، مع تحديد خدمة واجهة برمجة التطبيقات التي تريد تفعيلها.

   gcloud services enable API_SERVICE_ID

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

قد يكون من الضروري إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth لمشروعك على Google Cloud. إذا سبق لك استخدام OAuth 2.0 للتفويض، استخدِم نطاقات التفويض نفسها.

1. في وحدة تحكُّم Google Cloud، انتقِل إلى القائمة menu > واجهات برمجة التطبيقات والخدمات > شاشة موافقة OAuth.

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

2. اختَر نوع المستخدِم لتطبيقك، ثم انقر على إنشاء.
3. املأ نموذج تسجيل التطبيق، ثم انقر على حفظ ومتابعة.

4. إذا كنت تريد إنشاء تطبيق لاستخدامه خارج مؤسستك على Google Workspace، انقر على إضافة نطاقات أو إزالتها. ننصح باتّباع أفضل الممارسات التالية عند اختيار النطاقات:

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

أعِد نشر تطبيق Chat إلى المشروع الجديد على Cloud.

بناءً على ما إذا تم إنشاء تطبيق Chat باستخدام "برمجة تطبيقات Google" أو AppSheet أو نوع اتصال آخر، مثل Python أو Java، تختلف عملية إعادة نشر تطبيق Chat قليلاً. في كلتا الحالتين، لا تحتاج إلى إعادة إنشاء كل التعليمات البرمجية، ولكن تحتاج إلى إجراء بعض التغييرات.

نقل منطق تطبيق Chat

بناءً على بنية تطبيق Chat، قد تحتاج إلى نقل خدمات أخرى إلى المشروع الجديد على السحابة الإلكترونية:

• بالنسبة إلى تطبيقات HTTP، يجب أيضًا نقل بقية أجزاء منطق التطبيق التي تم إنشاؤها باستخدام Cloud Functions أو Cloud Run أو App Engine.
• بالنسبة إلى تطبيقات Chat الحوارية التي تستخدم اللغة الطبيعية، عليك أيضًا نقل بيانات برامج Dialogflow.
• بالنسبة إلى تطبيقات Chat التي صُمّمت خلف جدار حماية، عليك أيضًا نقل مواضيع النشر/الاشتراك.

ضبط تطبيق Chat في المشروع الجديد على السحابة الإلكترونية

لإعادة نشر تطبيق Chat المُصمَّم بلغة مثل Python أو Java، عليك إعداد تطبيق Chat في مشروعك الجديد على Google Cloud.

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

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

2. انقر على علامة التبويب الإعداد وأدخِل المعلومات المطلوبة التالية:

   • اسم التطبيق: الاسم الذي يستخدمه الأشخاص عند التفاعل مع تطبيق Chat.
   • عنوان URL للصورة الرمزية: عنوان URL يستخدم HTTPS يشير إلى صورة ذات رسومات مربّعة (على سبيل المثال، PNG أو JPEG)، بحجم 128x128 على الأقل، وتظهر كصورة رمزية لتطبيق Chat.
   • الوصف: وصف للغرض المقصود من تطبيق Chat يظهر أسفل اسم تطبيق Chat.

3. لتفعيل الميزات التفاعلية، انقر على مفتاح التبديل تفعيل الميزات التفاعلية الذي يتيح للمستخدمين التفاعل مع تطبيق Chat واستخدِم الجدول التالي لإنهاء الإعداد:

   الحقل	الوصف
   الوظائف	مجموعة من الحقول التي تحدِّد كيفية تفاعل تطبيق Chat مع المستخدمين: تلقّي رسائل بين شخصَين: يمكن للمستخدمين العثور على تطبيق Chat ومراسلته مباشرةً في Google Chat. الانضمام إلى المساحات والمحادثات الجماعية: يمكن للمستخدمين إضافة تطبيق Chat إلى المساحات والمحادثات الجماعية.
   إعدادات الربط	نقطة النهاية لتطبيق Chat، وهي إحدى النقاط التالية: عنوان URL للتطبيق: نقطة نهاية HTTPS تستضيف تنفيذ تطبيق Chat. مشروع "برمجة تطبيقات Google": رقم تعريف نشر لمشروع "برمجة تطبيقات Google" ينفّذ تطبيق Chat. اسم موضوع Cloud Pub/Sub: هو موضوع النشر/الاشتراك الذي يشترك فيه تطبيق Chat كنقطة نهاية. Dialogflow: لتسجيل تطبيق Chat من خلال عملية دمج Dialogflow. لمزيد من المعلومات، يُرجى الاطّلاع على المقالة إنشاء تطبيق Dialogflow على Google Chat يفهم اللغة الطبيعية.
   الأوامر التي تبدأ بشرطة مائلة	الأوامر التي يمكن عرضها للمستخدمين ضمن Google Chat. يسمح هذا الإعداد للمستخدمين بالاطّلاع على الإجراءات الأساسية لتطبيق Chat في Google Chat، واختيار إجراء معيّن يريدون التفاعل معه. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الردّ على الأوامر التي تبدأ بشرطة مائلة كتطبيق في Chat.
   معاينات الروابط	أنماط عناوين URL التي يتعرّف عليها تطبيق Chat ويقدّم محتوًى إضافيًا عندما يرسل المستخدمون الروابط. لمزيد من المعلومات، يُرجى الاطّلاع على روابط المعاينة.
   مستوى الرؤية	بإمكان ما يصل إلى 5 أفراد أو مجموعة واحدة أو أكثر من "مجموعات Google" الاطّلاع على تطبيق Chat وتثبيته. استخدِم هذا الحقل لاختبار تطبيق Chat أو لمشاركة تطبيق Chat مع فريقك. لمزيد من المعلومات، راجِع إعدادات إذن الوصول والنشر في تطبيق Chat.

4. لتسجيل الأخطاء في "التسجيل في السحابة الإلكترونية" كلما عرض تطبيق Chat خطأ، ضَع علامة في مربّع الاختيار تسجيل الأخطاء في التسجيل. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة طلبات البحث في سجلات الأخطاء لتطبيقات Chat.

5. انقر على حفظ. عند حفظ إعداد تطبيق Chat، يكون تطبيق Chat متاحًا للمستخدمين المحددين في مؤسستك على Google Workspace.

إعادة نشر تطبيق Chat لبرمجة التطبيقات

لإعادة نشر تطبيق Chat الذي تم إنشاؤه باستخدام "برمجة التطبيقات"، عليك تغيير رقم المشروع على Google Cloud الذي يرتبط به مشروع "برمجة تطبيقات Google" إلى رقم المشروع المنتمي إلى مشروعك الجديد على السحابة الإلكترونية. بعد ذلك، انسخ رقم تعريف نشر "برمجة تطبيقات Google" والصقه في صفحة ضبط تطبيق Chat في Google Cloud Console.

نسخ رقم مشروعك على Google Cloud

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

   الانتقال إلى "إعدادات إدارة الهوية وإمكانية الوصول والمشرف"

2. في حقل رقم المشروع، انسخ القيمة.

ضبط رقم مشروع Google Cloud في مشروع "برمجة تطبيقات Google"

1. انتقِل إلى "برمجة تطبيقات Google".

   الانتقال إلى لغة "برمجة تطبيقات Google"

2. في مشروع "برمجة تطبيقات Google" في تطبيق Chat، انقر على إعدادات المشروع settings.

3. ضمن مشروع Google Cloud Platform (GCP)، انقر على تغيير المشروع.

4. في رقم مشروع Google Cloud Platform، الصِق رقم مشروع Google Cloud.

5. انقر على ضبط المشروع.

نسخ رقم تعريف نشر مشروع برمجة التطبيقات

1. في أعلى يسار "برمجة التطبيقات"، انقر على نشر > إدارة عمليات النشر.
2. ضمن رقم تعريف النشر، انقر على نسخ.
3. انقر على تم.

إعادة ضبط تطبيق Chat وإعادة نشره

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

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

2. انقر على علامة التبويب الإعداد وأدخِل المعلومات المطلوبة التالية:

   • اسم التطبيق: الاسم الذي يستخدمه الأشخاص عند التفاعل مع تطبيق Chat.
   • عنوان URL للصورة الرمزية: عنوان URL يستخدم HTTPS يشير إلى صورة ذات رسومات مربّعة (على سبيل المثال، PNG أو JPEG)، بحجم 128x128 على الأقل، وتظهر كصورة رمزية لتطبيق Chat.
   • الوصف: وصف للغرض المقصود من تطبيق Chat يظهر أسفل اسم تطبيق Chat.

3. لتفعيل الميزات التفاعلية، انقر على مفتاح التبديل تفعيل الميزات التفاعلية التي تتيح للمستخدمين التفاعل مع تطبيق Chat:

4. ضمن "إعدادات الربط"، اختَر مشروع "برمجة تطبيقات Google".

5. في حقل رقم تعريف النشر، الصِق رقم تعريف النشر الذي نسخْته سابقًا.

6. لإكمال بقية خطوات عملية الإعداد، اطّلِع على الجدول في مقالة ضبط تطبيق Chat في المشروع الجديد على السحابة الإلكترونية.

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

إعادة نشر تطبيق AppSheet Chat

لإعادة نشر تطبيق Chat المُدمَج باستخدام AppSheet في مشروعك الجديد على Cloud، عليك نسخ التطبيق إلى المشروع الجديد على Cloud.

تعديل حساب الخدمة

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

مشاركة تطبيق Chat

قبل أن يصبح تطبيق Chat متاحًا للمستخدمين في المؤسسة الجديدة، قد على المشرف السماح يدويًا بالوصول إلى تطبيق Chat. لمزيد من المعلومات، يُرجى الرجوع إلى مقالة كيفية تثبيت مشرفي Google Workspace لتطبيقات Chat.

التبديل إلى تطبيق Chat الجديد

والآن بعد نقل تطبيق Chat إلى المؤسسة الجديدة، حان الوقت للإعلان عنه. أضِفه إلى مساحات Chat أو الرسائل المباشرة، ثم أزِل تطبيق Chat القديم منه حتى لا يتمكّن المستخدمون من مراسلة سوى تطبيق Chat الذي تم نقله.

إضافة تطبيق Chat الجديد إلى مساحات Chat

1. انتقِل إلى Chat.

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

2. انقر على رسالة مباشرة أو مساحة.

3. انقر على القائمة المنسدلة بجانب اسم المساحة أو المستخدم، ثم اختَر التطبيقات وعمليات الدمج.

4. انقر على إضافة تطبيقات.

5. أدخِل اسم التطبيق واختَر التطبيق من القائمة، ثم انقر على إضافة.

6. كرِّر هذه الخطوات لكل مساحة أو رسالة مباشرة تريد إضافة تطبيق Chat إليها.

إزالة تطبيق Chat القديم من مساحات Chat

1. انتقِل إلى Chat.

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

2. انقر على رسالة مباشرة أو مساحة.

3. انقر على القائمة المنسدلة بجانب اسم المساحة أو المستخدم، ثم اختَر التطبيقات وعمليات الدمج.

4. بجانب تطبيق Chat القديم الذي لم يتم نقله، انقر على خيارات إضافية more_vert، ثم انقر على الإزالة من المساحة.

5. كرِّر هذه الخطوات لكل مساحة أو رسالة مباشرة تريد إزالة تطبيق Chat القديم منها.

إيقاف تطبيق Chat القديم

لمنع المستخدمين من استخدام تطبيق Chat القديم وتشجيعهم على استخدام تطبيق Chat الجديد، عليك إيقاف تطبيق Chat القديم وإلغاء نشره من Google Workspace Marketplace.

مواضيع ذات صلة

• نشر التطبيقات