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

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

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

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

Google Cloud Console

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

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

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

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

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

gcloud CLI

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

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

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

Google Cloud Console

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

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

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

Google Cloud CLI

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

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

    gcloud services enable API_SERVICE_ID

ضبط Chat API

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

قد يكون من الضروري ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول 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 قليلاً، وذلك استنادًا إلى ما إذا كان تطبيق Chat قد تم إنشاؤه باستخدام Apps Script أو AppSheet أو نوع اتصال آخر، مثل Python أو Java. في كلتا الحالتَين، ليس عليك إعادة إنشاء كل الرمز، ولكن عليك إجراء بعض التغييرات.

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

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

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

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

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

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

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

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

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

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

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

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

ضبط رقم مشروعك على Google Cloud في مشروعك على Apps Script

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  4. ضمن إعدادات "الاتصال"، اختَر مشروع Apps Script.

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

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

  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 القديم الذي لم تتم نقل بياناته، انقر على المزيد من الخيارات ، ثم انقر على الإزالة من المساحة.

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

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

لمنع المستخدمين من استخدام تطبيق Chat القديم وحثّهم على استخدام تطبيق Chat الجديد، أوقِف تطبيق Chat القديم وألغِ نشره من Google Workspace Marketplace.