يوضّح هذا الدليل كيفية استخدام الأسلوب
setUp()
في مورد Space
من Google Chat API لإعداد
مساحة في Google Chat. يؤدي إعداد مساحة إلى إنشاء مساحة وإضافة مستخدمين محدّدين إليها.
يمثّل
مورد Space
مكانًا يمكن فيه للمستخدمين وتطبيقات Chat إرسال الرسائل
ومشاركة الملفات والتعاون. هناك عدة أنواع من المساحات:
- الرسائل المباشرة هي محادثات بين مستخدمين أو مستخدم تطبيق Chat.
- الدردشات الجماعية هي محادثات بين ثلاثة مستخدمين أو أكثر تطبيقات Chat
- المساحات المُعنونة هي أماكن دائمة يرسل من خلالها المستخدمون الرسائل ويشاركون الملفات والتعاون.
عند إعداد مساحة، يجب مراعاة ما يلي:
- تتم إضافة المستخدم الذي يتصل (تمت مصادقته) تلقائيًا إلى المساحة، وبالتالي يمكنك لا تحتاج إلى تحديد عضوية المستخدم في الطلب.
- عند إنشاء رسالة مباشرة، إذا كانت هناك رسالة مباشرة بين مستخدمَين، يتم عرض الرسالة المباشرة. وبخلاف ذلك، يتم إنشاء رسالة مباشرة.
- عند إنشاء محادثة جماعية، في حال عدم توفّر أي من العضويات في الطلب تتم إضافتها بنجاح إلى المحادثة الجماعية (على سبيل المثال، مشكلة في الإذن)، ثم قد يتم إنشاء محادثة جماعية فارغة (بما في ذلك المستخدم المتصل فقط).
- لا يمكنك إعداد مساحات تتضمن ردودًا في سلاسل منفصلة أو إضافة مستخدمين من خارج Google Workspace
- تتم فلترة العضويات المكرّرة (بما في ذلك المستخدم المتصل) المقدَّمة في الطلب بدلاً من ظهور خطأ في الطلب.
المتطلبات الأساسية
Node.js
- حساب على Google Workspace من فئة Business أو Enterprise يتيح الوصول إلى Google Chat
- إعداد بيئتك:
- أنشئ مشروعًا على Google Cloud.
- إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
- تفعيل Google Chat API وضبطه باستخدام اسم ورمزه ووصفه لتطبيق Chat.
- تثبيت Node.js Cloud Client Library.
-
أنشئ بيانات اعتماد معرِّف عميل OAuth لتطبيق كمبيوتر مكتبي. لتنفيذ العيّنة الواردة في
هذا الدليل، احفظ بيانات الاعتماد كملف JSON باسم
client_secrets.json
في الدليل المحلي.
- اختَر نطاق تفويض يتيح مصادقة المستخدمين.
Python
- حساب على Google Workspace من فئة Business أو Enterprise يتيح الوصول إلى Google Chat
- إعداد بيئتك:
- أنشئ مشروعًا على Google Cloud.
- ضبط شاشة موافقة OAuth
- تفعيل Google Chat API وضبطه باستخدام اسم ورمزه ووصفه لتطبيق Chat.
- تثبيت بايثون Cloud Client Library.
-
أنشئ بيانات اعتماد معرِّف عميل OAuth لتطبيق متوافق مع الكمبيوتر المكتبي. لتنفيذ النموذج في هذه
هذا الدليل، فاحفظ بيانات الاعتماد كملف JSON اسمه
client_secrets.json
في الدليل المحلي.
- اختر نطاق تفويض يتيح مصادقة المستخدم.
Java
- نشاط تجاري أو مؤسسة حساب 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.
- إنشاء مشروع "برمجة تطبيقات Google" مستقل وفعِّل خدمة المحادثة المتقدّمة.
- اختَر نطاق تفويض يتيح مصادقة المستخدمين.
إعداد مساحة
لإعداد مساحة، أدخِل ما يلي في طلبك:
- حدِّد نطاق التفويض
chat.spaces.create
أوchat.spaces
. - استخدِم الطريقة
SetUpSpace()
. - نقْل
space
كنسخة منSpace
مع جميع الحقول اللازمة، مثلdisplayName
أوspaceType
. - تمرير
memberships
كمصفوفة منMembership
الحالات. لكل مثيل:- عليك تحديد
users/{user}
لإضافة مستخدم بشري كعضو في المساحة، حيث{user}
. إما{person_id}
فيperson
من People API أو من معرّفuser
في واجهة برمجة التطبيقات للدليل. فعلى سبيل المثال، إذا كان الشخص الذي يستخدم واجهة برمجة تطبيقات "الأشخاص"resourceName
هي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
.
مواضيع ذات صلة
- أنشئ مساحة.
- الحصول على تفاصيل عن مساحة
- إدراج المساحات:
- تعديل مساحة
- حذف المساحة
- العثور على مساحة رسائل مباشرة
- إتاحة مساحة للاكتشاف من قِبل مستخدمين محدّدين