نقل تطبيق Google Chat

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

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

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

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

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

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

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

Google Cloud Console

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

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

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

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

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

gcloud CLI

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

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

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

يجب أن تكون واجهة برمجة التطبيقات Google Chat API مفعّلة في جميع تطبيقات 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 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.

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

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

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

  2. إذا سبق لك ضبط Google Auth platform، يمكنك ضبط إعدادات "شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth" التالية في العلامة التجارية والجمهور والوصول إلى البيانات. إذا ظهرت لك الرسالة Google Auth platform لم يتم ضبطه بعد، انقر على البدء:
    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، يُرجى الاطّلاع على بدء استخدام Google Auth platform.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

مشاركة تطبيق محادثاتك

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

التبديل إلى تطبيق محادثات الجديد

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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