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

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

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

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

Google Cloud Console

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

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

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

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

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

gcloud CLI

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

  • Cloud Shell: لاستخدام وحدة طرفية على الإنترنت تم إعداد gcloud CLI عليها، فعِّل Cloud Shell.
    تفعيل Cloud Shell
  • Local Shell: لاستخدام بيئة تطوير محلية، ثبِّت gcloud CLI وافتحها.
    لإنشاء مشروع على السحابة الإلكترونية، استخدِم الأمر gcloud projects create: 
    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 Console

  1. في Google Cloud Console، انتقِل إلى "القائمة" > واجهات برمجة التطبيقات والخدمات > المكتبة > Google Workspace.

    الانتقال إلى مكتبة واجهة برمجة التطبيقات

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

Google Cloud CLI

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

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

    gcloud services enable API_SERVICE_ID

ضبط Chat API

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

التبديل إلى تطبيق 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.