نقل تطبيق 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

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

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

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

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

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

واجهة سطر الأوامر gcloud

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

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

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

يجب أن تحتوي جميع تطبيقات Chat على 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 كأفضل ممارسة، لضمان تطبيق تم نقله، عليك تفعيل واجهات برمجة التطبيقات نفسها في المشروع الجديد على السحابة الإلكترونية مفعَّلة في المشروع القديم على السحابة الإلكترونية

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

وحدة التحكّم في Google Cloud

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

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

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

Google Cloud CLI

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

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

    gcloud services enable API_SERVICE_ID

ضبط Chat API

في مشروعك الجديد على Google Cloud، عليك استخدام Chat API من أجل: تحديد اسم تطبيق Chat ووصفه ورمزه إلى تهيئة هذه التفاصيل، ويمكنك مراجعة ضبط واجهة Chat API

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

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

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

  2. اختَر نوع المستخدم لتطبيقك، ثم انقر على إنشاء.
  3. أكمِل نموذج تسجيل التطبيق، ثم انقر على حفظ ومتابعة.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

إعداد رقم مشروعك على Google Cloud في مشروع "برمجة التطبيقات"

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  5. في حقل معرّف النشر، الصِق رقم تعريف النشر الذي سبق لك. المنسوخ.

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

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

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

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

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

إذا كان تطبيق Chat يصادق كتطبيق ويستخدم لإجراء اتصالات بـ Google APIs، يمكنك تحديث تفاصيل حساب خدمة تطبيق 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