يشرح هذا الدليل كيفية استخدام طريقة patch
على المورد Space
في Google Chat API لتعديل مساحة. يمكنك تحديث المساحة لتغيير السمات المتعلقة بها،
مثل اسمها المعروض ووصفها وإرشاداتها المرئية للمستخدم.
يمثّل
مورد Space
مكانًا يمكن فيه للمستخدمين وتطبيقات Chat إرسال الرسائل
ومشاركة الملفات والتعاون. تتوفّر عدة أنواع من المساحات:
- الرسائل المباشرة هي محادثات بين مستخدمَين أو مستخدم وتطبيق Chat.
- المحادثات الجماعية هي محادثات بين ثلاثة مستخدمين أو أكثر وتطبيقات Chat.
- المساحات المُسمّاة هي أماكن دائمة يرسل من خلالها المستخدمون الرسائل ويشاركون الملفات ويتعاونون في ما بينها.
المتطلّبات الأساسية
Python
- Python 3.6 أو أعلى
- تتيح لك أداة pip إدارة الحزم
أحدث مكتبات برامج Google للغة بايثون. لتثبيتها أو تحديثها، قم بتشغيل الأمر التالي في واجهة سطر الأوامر لديك:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- مشروع على Google Cloud مع تفعيل وإعداد Google Chat API لمعرفة الخطوات، راجِع إنشاء تطبيق Google Chat.
تم ضبط التفويض لتطبيق Chat. يتطلب تعديل المساحة مصادقة المستخدم من خلال نطاق التفويض
chat.spaces
.
Node.js
- Node.js وnpm
أحدث مكتبات برامج Google لنظام Node.js. لتثبيتها، قم بتشغيل الأمر التالي في واجهة سطر الأوامر:
npm install @google-cloud/local-auth @googleapis/chat
- مشروع على Google Cloud مع تفعيل وإعداد Google Chat API لمعرفة الخطوات، راجِع إنشاء تطبيق Google Chat.
تم ضبط التفويض لتطبيق Chat. يتطلب تعديل المساحة مصادقة المستخدم من خلال نطاق التفويض
chat.spaces
.
تعديل مساحة
لتعديل مساحة حالية في Google Chat، عليك تضمين ما يلي في طلبك:
- حدِّد نطاق تفويض
chat.spaces
. - استدعِ
طريقة
patch
في مرجعSpace
. يمكنك في طلبك تحديد حقل المساحةname
والحقلupdateMask
الذي يتضمّن حقلاً واحدًا أو أكثر لتعديله والحقلbody
الذي يتضمّن معلومات المساحة المعدّلة.
يمكنك تعديل عناصر مثل الاسم المعروض ونوع المساحة وحالة السجلّ وغير ذلك. للاطّلاع على كل الحقول التي يمكنك تعديلها، يُرجى مراجعة المستندات المرجعية.
في ما يلي كيفية تعديل الحقل spaceDetails
لمساحة حالية:
Python
- في دليل العمل، أنشِئ ملفًا باسم "
chat_space_update.py
". أدرِج الرمز التالي في
chat_space_update.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"] def main(): ''' Authenticates with Chat API via user credentials, then updates the specified space description and guidelines. ''' # 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().patch( # The space to update, and the updated space details. # # Replace {space} with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. name='spaces/SPACE', updateMask='spaceDetails', body={ 'spaceDetails': { 'description': 'This description was updated with Chat API!', 'guidelines': 'These guidelines were updated with Chat API!' } } ).execute() # Prints details about the updated space. print(result) if __name__ == '__main__': main()
في الرمز، استبدِل
SPACE
باسم مساحة، ويمكنك الحصول عليه من خلال طريقةspaces.list
في Chat API أو من عنوان URL للمساحة.في دليل العمل، أنشئ النموذج وشغِّله:
python3 chat_space_update.py
Node.js
- في دليل العمل، أنشِئ ملفًا باسم "
update-space.js
". أدرِج الرمز التالي في
update-space.js
:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Updates a Chat space with the description and guidelines. * @return {!Promise<!Object>} */ async function updateSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.spaces', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.patch({ name: 'spaces/SPACE', updateMask: 'spaceDetails', requestBody: { spaceDetails: { description: 'This description was updated with Chat API!', guidelines: 'These guidelines were updated with Chat API!' }, } }); } updateSpace().then(console.log);
في الرمز، استبدِل
SPACE
باسم مساحة، ويمكنك الحصول عليه من خلال طريقةspaces.list
في Chat API أو من عنوان URL للمساحة.في دليل العمل، شغِّل النموذج:
node update-space.js
تعرض Google Chat API نسخة افتراضية من
مورد Space
يعرض التعديلات.
مواضيع ذات صلة
- الحصول على تفاصيل حول مساحة
- إدراج المساحات:
- حذف المساحة
- إعداد مساحة
- العثور على مساحة رسائل مباشرة
- إتاحة مساحة قابلة للاكتشاف من مستخدمين محدّدين