نقل تطبيق 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 الأصلي.

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

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

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

Google Cloud Console

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

   الانتقال إلى "إنشاء مشروع"

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

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

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

gcloud CLI

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

• Cloud Shell: لتفعيل Cloud Shell واستخدام وحدة طرفية على الإنترنت مع إعداد gcloud CLI مسبقًا
  تفعيل Cloud Shell
• Local Shell: لاستخدام بيئة تطوير محلية، عليك تثبيت وإعداد gcloud CLI.
  لإنشاء مشروع على Google Cloud، استخدِم الأمر gcloud projects create:

  gcloud projects create PROJECT_ID

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

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

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

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

Google Cloud Console

1. في "وحدة تحكّم Google Cloud"، انتقِل إلى القائمة > المزيد من المنتجات > Google Workspace > مكتبة المنتجات.

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

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

Google Cloud CLI

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

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

   gcloud services enable API_SERVICE_ID

ضبط إعدادات Chat API

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

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

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

1. في "وحدة تحكّم Google Cloud"، انتقِل إلى "القائمة" > > تحديد هوية العلامة التجارية.

   الانتقال إلى "الهوية البصرية للعلامة التجارية"

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

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

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

لمزيد من المعلومات حول ضبط موافقة OAuth، يُرجى الاطّلاع على بدء استخدام .

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

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

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

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

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

ضبط الميزات التفاعلية في مشروع Google Cloud الجديد

لإعادة نشر تطبيق Chat الذي تم إنشاؤه باستخدام لغة مثل Python أو Java، عليك إعداد تطبيق Chat في مشروع Cloud الجديد.

لضبط الميزات التفاعلية، اطّلِع على تلقّي تفاعلات المستخدمين والردّ عليها.

إعادة نشر تطبيق Chat على Apps Script

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

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

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

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

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

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

1. انتقِل إلى Apps Script.

   الانتقال إلى Apps Script

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

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

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

5. انقر على تحديد المشروع.

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

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

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

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

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

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

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

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

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

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

6. لإكمال بقية الإعدادات، راجِع الجدول في مقالة ضبط إعدادات تطبيق "المحادثة" في مشروع Cloud الجديد.

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

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

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

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

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

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

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

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

بعد نقل تطبيق Chat إلى المؤسسة الجديدة، حان الوقت للإعلان عنه. أضِف التطبيق إلى مساحات 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 القديم الذي لم يتم نقل بياناته، انقر على المزيد من الخيارات ، ثم انقر على الإزالة من المساحة.

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

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

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