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

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

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

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

Google Cloud Console

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

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

  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 بضبط رقم تعريف المشروع الذي تريد إنشاءه.

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

يجب أن تتضمّن جميع تطبيقات Chat واجهة برمجة التطبيقات Google Chat API مفعّلة. استنادًا إلى طريقة إنشاء تطبيق 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. ثبِّت واجهة سطر الأوامر في Google Cloud (gcloud CLI) أو افتحها.

  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 Auth > العلامة التجارية.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

لإعادة نشر تطبيق 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.