يشرح هذا الدليل كيفية استخدام الطريقة
setUp()
على المورد Space
الخاص بـ Google Chat API لإعداد مساحة في Google Chat. يؤدي إعداد مساحة إلى إنشاء مساحة وإضافة مستخدمين محدّدين إليها.
يمثّل
مورد Space
مكانًا يمكن فيه للمستخدمين وتطبيقات Chat إرسال الرسائل
ومشاركة الملفات والتعاون. هناك عدة أنواع من المساحات:
- الرسائل المباشرة هي محادثات بين مستخدمَين أو مستخدم وأحد تطبيقات Chat.
- المحادثات الجماعية هي محادثات بين ثلاثة مستخدمين أو أكثر وتطبيقات Chat.
- المساحات المُسمّاة هي أماكن دائمة يرسل فيها المستخدمون الرسائل ويشاركون الملفات ويتعاونون معًا.
عند إعداد مساحة، يجب مراعاة ما يلي:
- تتم إضافة المستخدم الذي يتصل (المصادق عليه) تلقائيًا إلى المساحة، وبالتالي لا تحتاج إلى تحديد عضوية المستخدم في الطلب.
- عند إنشاء رسالة مباشرة (DM) إذا كانت هناك رسالة مباشرة بين مستخدمَين، يتم عرضها. بخلاف ذلك، يتم إنشاء رسالة مباشرة.
- عند إنشاء محادثة جماعية، إذا لم تتم بنجاح إضافة أي من العضويات المقدَّمة في الطلب إلى المحادثة الجماعية (على سبيل المثال، بسبب مشكلة في الأذونات)، قد يتم إنشاء محادثة جماعية فارغة (تتضمّن المستخدم المتصل فقط).
- لا يمكنك إعداد مساحات تتضمن ردودًا في سلاسل منفصلة أو إضافة مستخدمين من خارج Google Workspace.
- تتمّ فلترة الاشتراكات المكرّرة (بما في ذلك المستخدم المتّصل) المقدَّمة في الطلب بدلاً من أن تؤدّي إلى حدوث خطأ في الطلب.
المتطلبات الأساسية
Node.js
- حساب على Google Workspace من فئة Business أو Enterprise يتيح الوصول إلى Google Chat
- إعداد البيئة:
- أنشئ مشروعًا على Google Cloud.
- إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
- فعِّل Google Chat API وضبطها باستخدام اسم و رمز ووصف لتطبيق Chat.
- ثبِّت مكتبة برامج Cloud Client Library لنظام التشغيل Node.js.
-
إنشاء بيانات اعتماد معرِّف عميل OAuth لتطبيق متوافق مع الكمبيوتر المكتبي. لتنفيذ العيّنة الواردة في
هذا الدليل، احفظ بيانات الاعتماد كملف JSON باسم
client_secrets.json
في الدليل المحلي.
- اختَر نطاق تفويض يتيح مصادقة المستخدمين.
Python
- حساب على Google Workspace من فئة Business أو Enterprise يتيح الوصول إلى Google Chat
- إعداد البيئة:
- أنشئ مشروعًا على Google Cloud.
- إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
- فعِّل Google Chat API واضبطها باستخدام اسم تطبيق Chat ورمزه ووصفه.
- ثبِّت مكتبة Cloud Client Library لـ Python.
-
إنشاء بيانات اعتماد معرِّف عميل OAuth لتطبيق متوافق مع الكمبيوتر المكتبي. لتنفيذ العيّنة الواردة في
هذا الدليل، احفظ بيانات الاعتماد كملف JSON باسم
client_secrets.json
في الدليل المحلي.
- اختَر نطاق تفويض يتيح مصادقة المستخدمين.
Java
- حساب Business أو Enterprise Google Workspace لديه إذن بالوصول إلى Google Chat.
- إعداد البيئة:
- أنشِئ مشروعًا على Google Cloud.
- إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
- فعِّل Google Chat API وضبطها باستخدام اسم و رمز ووصف لتطبيق Chat.
- ثبِّت مكتبة Cloud Client Library لـ Java.
-
أنشئ بيانات اعتماد معرِّف عميل OAuth لتطبيق كمبيوتر مكتبي. لتنفيذ العيّنة الواردة في
هذا الدليل، احفظ بيانات الاعتماد كملف JSON باسم
client_secrets.json
في الدليل المحلي.
- اختَر نطاق تفويض يتيح مصادقة المستخدمين.
برمجة تطبيقات
- حساب على Google Workspace من فئة Business أو Enterprise يتيح الوصول إلى Google Chat
- إعداد البيئة:
- أنشئ مشروعًا على Google Cloud.
- إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
- فعِّل Google Chat API وضبطها باستخدام اسم و رمز ووصف لتطبيق Chat.
- أنشِئ مشروعًا مستقلاً لبرمجة التطبيقات، وفعِّل خدمة Chat المتقدّمة.
- اختَر نطاق تفويض يتيح مصادقة المستخدمين.
إعداد مساحة
لإعداد مساحة، يجب إدخال ما يلي في طلبك:
- حدِّد نطاق التفويض
chat.spaces.create
أوchat.spaces
. - استخدِم الطريقة
SetUpSpace()
. - نقْل
space
كنسخة منSpace
مع جميع الحقول اللازمة، مثلdisplayName
أوspaceType
. - نقْل
memberships
كصفيف من مثيلاتMembership
. بالنسبة إلى كلّ مثيل:- حدِّد
users/{user}
لإضافة مستخدم كعضو في المساحة، حيث يكون{user}
هو{person_id}
لـperson
من People API، أو معرّفuser
في Directory API. على سبيل المثال، إذا كانresourceName
في واجهة برمجة التطبيقات People API هوpeople/123456789
، يمكنك إضافة المستخدم إلى المساحة من خلال تضمين عضوية معusers/123456789
كmember.name
. - حدِّد
groups/{group}
لإضافة مجموعة كعضو في المساحة، حيث يكون{group}
هو رقم تعريف المجموعة التي تريد إنشاء عضوية لها. يمكن استرداد معرّف المجموعة باستخدام Cloud Identity API. على سبيل المثال، إذا كانت Cloud Identity API تُعرِض مجموعة باسمgroups/123456789
، اضبطmembership.groupMember.name
علىgroups/123456789
. لا يمكن إضافة "مجموعات Google" إلى محادثة جماعية أو رسالة مباشرة، ولكن يمكن إضافتها إلى مساحة مُسمّاة فقط.
- حدِّد
لإنشاء رسالة مباشرة بين المستخدم المتصل ومستخدم آخر، حدِّد عضوية المستخدم في طلبك.
لإنشاء رسالة مباشرة بين المستخدم المتصل والتطبيق المتصل، اضبط
space.singleUserBotDm
على true
ولا تحدِّد أي عضويات. يمكنك استخدام هذه الطريقة
فقط لإعداد رسالة مباشرة باستخدام تطبيق الاتصال. لإضافة تطبيق الاتصال
كعضو في مساحة أو رسالة مباشرة حالية بين مستخدمَين بشريين، اطّلِع على إنشاء عضوية.
ينشئ المثال التالي مساحة مُسمّاة وينشئ عضوية واحدة في المساحة لمستخدمَين بشريين (المستخدم الذي تم مصادقة هويته ومستخدم آخر).
Node.js
Python
Java
برمجة تطبيقات
لتنفيذ العيّنة، استبدِل ما يلي:
DISPLAY_NAME
: الاسم المعروض للمساحة الجديدة-
USER_NAME
: رقم تعريف المستخدم الآخر المطلوب تضمين اشتراك له
للانتقال إلى المساحة، استخدِم رقم تعريف مورد المساحة لإنشاء عنوان URL الخاص بها.
يمكنك الحصول على رقم تعريف المورد من المساحة name
في جسد ردّ Google Chat. على سبيل المثال، إذا كان name
لمساحة العرض هو spaces/1234567
، يمكنك الانتقال
إلى المساحة باستخدام عنوان URL التالي:
https://mail.google.com/chat/u/0/#chat/space/1234567
.
مواضيع ذات صلة
- أنشئ مساحة.
- الحصول على تفاصيل عن مساحة
- إدراج المساحات:
- تعديل مساحة
- حذف المساحة
- ابحث عن مساحة رسائل مباشرة.
- إتاحة مساحة للاكتشاف من قِبل مستخدمين محدّدين