يشرح هذا الدليل كيفية استخدام طريقة create
على مورد Space
الخاص بـ
Google Chat API لإنشاء مساحة مُسَمّاة.
تشير رسالة الأشكال البيانية
مرجع Space
يمثّل مكانًا يمكن فيه للمستخدمين والتطبيقات في Chat إرسال رسائل
ومشاركتها والتعاون. تتوفّر عدة أنواع من المساحات:
- الرسائل المباشرة هي محادثات بين مستخدمين أو مستخدم تطبيق Chat.
- الدردشات الجماعية هي محادثات بين ثلاثة مستخدمين أو أكثر تطبيقات Chat
- المساحات المُعنونة هي أماكن دائمة يرسل من خلالها المستخدمون الرسائل ويشاركون الملفات والتعاون.
المساحة المعنوَنة هي مكان يرسل فيه الأشخاص الرسائل ويشاركون الملفات
والتعاون. يمكن أن تتضمّن المساحات المُعنونة تطبيقات Chat. المساحات المُعنونة
تضمين ميزات إضافية تؤدي إلى المحادثات الجماعية والرسائل المباشرة بدون اسم
غير متاحة لهم، مثل مدراء المساحات الذين يمكنهم تطبيق الإعدادات الإدارية
والأوصاف وإضافة أو إزالة الأشخاص والتطبيقات. بعد إنشاء مساحة مُعنوَنة،
يكون العضو الوحيد في المساحة هو المستخدم الذي تمت مصادقته. المساحة لا
تضمين أشخاص آخرين أو تطبيقات أخرى ولا حتى تطبيق Chat
التي تنشئها. لإضافة مستخدمين، يجب إنشاء عضويات في المساحة من خلال الاتصال على
طريقة create
في صفحة
مرجع واحد (Member
)
للتعرّف على كيفية إجراء ذلك، يمكنك الاطّلاع على إنشاء عضوية.
لإنشاء مساحة مُسمّاة تضم عدة أعضاء، وهي محادثة جماعية بدون اسم بين أو ثلاثة أشخاص أو أكثر، أو محادثة مباشرة بين شخصين، أو الشخص وتطبيق Chat الذي يتصل Chat API: إعداد مساحة بدلاً من ذلك.
المتطلبات الأساسية
Python
- نشاط تجاري أو مؤسسة حساب Google Workspace لديه إذن بالوصول إلى Google Chat
- Python 3.6 أو أعلى
- أداة إدارة حزم pip
- أحدث مكتبات عملاء Google. لتثبيت التطبيقات أو تحديثها،
قم بتشغيل الأمر التالي في واجهة سطر الأوامر:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- إعداد البيئة:
- أنشِئ مشروعًا على Google Cloud.
- ضبط شاشة موافقة OAuth
- تفعيل Google Chat API وضبطه باستخدام اسم ورمزه ووصفه لتطبيق Chat.
-
أنشئ بيانات اعتماد معرِّف عميل OAuth لتطبيق متوافق مع الكمبيوتر المكتبي. لتنفيذ النموذج في هذه
فقط، احفظ بيانات الاعتماد كملف JSON (
client_secrets.json
) في الدليل المحلي.
- اختر نطاق تفويض يتيح مصادقة المستخدم.
Node.js
- نشاط تجاري أو مؤسسة حساب Google Workspace لديه إذن بالوصول إلى Google Chat
- الإصدار 14 من Node.js أو الإصدارات الأحدث
- npm أداة إدارة الحِزم
- أحدث مكتبات عملاء Google. لتثبيت التطبيقات أو تحديثها،
قم بتشغيل الأمر التالي في واجهة سطر الأوامر:
npm install @google-cloud/local-auth @googleapis/chat
- إعداد البيئة:
- أنشِئ مشروعًا على Google Cloud.
- ضبط شاشة موافقة OAuth
- تفعيل Google Chat API وضبطه باستخدام اسم ورمزه ووصفه لتطبيق Chat.
-
أنشئ بيانات اعتماد معرِّف عميل OAuth لتطبيق متوافق مع الكمبيوتر المكتبي. لتنفيذ النموذج في هذه
فقط، احفظ بيانات الاعتماد كملف JSON (
client_secrets.json
) في الدليل المحلي.
- اختر نطاق تفويض يتيح مصادقة المستخدم.
إنشاء مساحة مُسَمّاة
لإنشاء مساحة مُسَمّاة، أدخِل ما يلي في طلبك:
- حدِّد نطاق التفويض
chat.spaces.create
أوchat.spaces
. - عليك استدعاء
طريقة
create
في صفحة مرجع واحد (Space
) - ضبط
spaceType
إلىSPACE
. - ضبط
displayName
إلى اسم المساحة المرئي للمستخدمين في المثال التالي،displayName
تم ضبطها علىAPI-made
. - يمكنك بشكل اختياري تعيين سمات مساحة أخرى، مثل
spaceDetails
(وصف مرئي للمستخدم ومجموعة من الإرشادات الخاصة بالمساحة)
إليك كيفية إنشاء مساحة مُعنوَنة:
Python
- في دليل العمل، أنشِئ ملفًا باسم "
chat_space_create_named.py
". أدرِج الرمز التالي في
chat_space_create_named.py
:from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build # Define your app's authorization scopes. # When modifying these scopes, delete the file token.json, if it exists. SCOPES = ["https://www.googleapis.com/auth/chat.spaces.create"] def main(): ''' Authenticates with Chat API via user credentials, then creates a Chat space. ''' # Authenticate with Google Workspace # and get user authorization. flow = InstalledAppFlow.from_client_secrets_file( 'client_secrets.json', SCOPES) creds = flow.run_local_server() # Build a service endpoint for Chat API. chat = build('chat', 'v1', credentials=creds) # Use the service endpoint to call Chat API. result = chat.spaces().create( # Details about the space to create. body = { # To create a named space, set spaceType to SPACE. 'spaceType': 'SPACE', # The user-visible name of the space. 'displayName': 'API-made' } ).execute() # Prints details about the created space. print(result) if __name__ == '__main__': main()
في دليل العمل، أنشئ النموذج وشغِّله:
python3 chat_space_create_named.py
Node.js
- في دليل العمل، أنشِئ ملفًا باسم "
create-space.js
". أدرِج الرمز التالي في
create-space.js
:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Creates a new chat space. * @return {!Promise<!Object>} */ async function createSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.spaces.create', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.create( {requestBody: {spaceType: 'SPACE', displayName: 'API-made'}}); } createSpace().then(console.log);
في دليل العمل، شغِّل النموذج:
node create-space.js
يتم إنشاء مساحة مُعنوَنة. للانتقال إلى المساحة، استخدِم رقم تعريف المورد الخاص بالمساحة.
لإنشاء عنوان URL للمساحة. يمكنك العثور على رقم تعريف المورد من المساحة.
name
في نص استجابة Google Chat. على سبيل المثال، إذا كانت مساحتك
name
هي spaces/1234567
. يمكنك الانتقال إلى المساحة باستخدام ما يلي:
عنوان URL: https://mail.google.com/chat/u/0/#chat/space/1234567
.
مواضيع ذات صلة
- إضافة مستخدمين وتطبيقات إلى المساحة من خلال إنشاء الأعضاء
- يمكنك نشر رسالة في المساحة من خلال إنشاء رسالة
- الحصول على تفاصيل حول مساحة
- إدراج المساحات:
- تعديل مساحة
- حذف المساحة
- إعداد مساحة
- العثور على مساحة رسائل مباشرة
- إتاحة مساحة قابلة للاكتشاف من مستخدمين محدّدين