يشرح هذا الدليل كيفية استخدام طريقة patch
على المرجع membership
.
Google Chat API لتغيير السمات المتعلقة باشتراك معيّن، مثل تغيير
عضو في المساحة إلى مدير مساحة، أو تغيير مدير المساحة إلى عضو في المساحة
تشير رسالة الأشكال البيانية
مرجع Membership
يمثِّل ما إذا تمت دعوة مستخدِم أو تطبيق Google Chat إلى
أو جزء منها أو غير موجود فيه.
المتطلبات الأساسية
Python
- نشاط تجاري أو مؤسسة حساب Google Workspace لديه إذن بالوصول إلى Google Chat
- إعداد البيئة:
- أنشِئ مشروعًا على Google Cloud.
- ضبط شاشة موافقة OAuth
- تفعيل Google Chat API وضبطه باستخدام اسم ورمزه ووصفه لتطبيق Chat.
- تثبيت بايثون مكتبة برامج Google API
-
أنشئ بيانات اعتماد معرِّف عميل OAuth لتطبيق متوافق مع الكمبيوتر المكتبي. لتنفيذ النموذج في هذه
هذا الدليل، فاحفظ بيانات الاعتماد كملف JSON اسمه
client_secrets.json
في الدليل المحلي.
- اختر نطاق تفويض يتيح مصادقة المستخدم.
Node.js
- نشاط تجاري أو مؤسسة حساب Google Workspace لديه إذن بالوصول إلى Google Chat
- إعداد البيئة:
- أنشِئ مشروعًا على Google Cloud.
- ضبط شاشة موافقة OAuth
- تفعيل Google Chat API وضبطه باستخدام اسم ورمزه ووصفه لتطبيق Chat.
- تثبيت Node.js مكتبة برامج Google API
-
أنشئ بيانات اعتماد معرِّف عميل OAuth لتطبيق متوافق مع الكمبيوتر المكتبي. لتنفيذ النموذج في هذه
هذا الدليل، فاحفظ بيانات الاعتماد كملف JSON اسمه
client_secrets.json
في الدليل المحلي.
- اختر نطاق تفويض يتيح مصادقة المستخدم.
برمجة تطبيقات
- نشاط تجاري أو مؤسسة حساب Google Workspace لديه إذن بالوصول إلى Google Chat
- إعداد البيئة:
- أنشِئ مشروعًا على Google Cloud.
- ضبط شاشة موافقة OAuth
- تفعيل Google Chat API وضبطه باستخدام اسم ورمزه ووصفه لتطبيق Chat.
- إنشاء مشروع "برمجة تطبيقات Google" مستقل وفعِّل خدمة المحادثة المتقدّمة.
- اختر نطاق تفويض يتيح مصادقة المستخدم.
تعديل اشتراك
لتعديل عضوية في مساحة، أدخِل ما يلي في طلبك:
- حدِّد نطاق تفويض
chat.memberships
. - عليك استدعاء
طريقة
patch
على مرجعMembership
وتمريرname
للعضوية لتعديلها، بالإضافة إلىupdateMask
وbody
يحدد سمات العضوية المُعدّلة. - تحدّد السمة
updateMask
جوانب الاشتراك المطلوب تعديلها. ما يلي:role
: دور المستخدم ضمن "مساحة Chat" الذي يحدِّد الأذونات المسموح بها من الإجراءات في المساحة. القيم المتاحة:ROLE_MEMBER
: عضو في المساحة لدى المستخدم الأذونات الأساسية، مثل إرسال الرسائل إلى المساحة. في مجموعة 1:1 ومجموعة بدون اسم المحادثات، فإن الجميع لديهم هذا الدور.- "
ROLE_MANAGER
": مدير مساحة يمتلك المستخدم جميع الأذونات الأساسية بالإضافة إلى أذونات إدارية تسمح لهم بإدارة المساحة، مثل إضافة أو إزالة الأعضاء. لا تتوفّر هذه الميزة إلا في المساحات التي تكون فيها السمةspaceType
هيSPACE
. (المساحات المُعنونة).
منح عضو عادي في المساحة دور مدير مساحة
في المثال التالي، يصبح العضو العادي في المساحة مديرًا من خلال تحديد
role
كـ ROLE_MANAGER
في body
التي تحدّد العضوية المُعدَّلة
:
Python
- في دليل العمل، أنشِئ ملفًا باسم "
chat_membership_update.py
". أدرِج الرمز التالي في
chat_membership_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.memberships"] def main(): ''' Authenticates with Chat API via user credentials, then updates a specified space member to change it from a regular member to a space manager. ''' # 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().members().patch( # The membership to update, and the updated role. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. # # Replace MEMBERSHIP with a membership name. # Obtain the membership name from the membership of Chat API. name='spaces/SPACE/members/MEMBERSHIP', updateMask='role', body={'role': 'ROLE_MANAGER'} ).execute() # Prints details about the updated membership. print(result) if __name__ == '__main__': main()
في الرمز، استبدل ما يلي:
SPACE
: اسم مساحة التي يمكنك الحصول عليها من طريقة واحدة (spaces.list
) في Chat API أو من عنوان URL للمساحة.MEMBERSHIP
: اسم عضوية التي يمكنك الحصول عليها من طريقة واحدة (spaces.members.list
) في Chat API
في دليل العمل، أنشئ النموذج وشغِّله:
python3 chat_membership_update.py
Node.js
- في دليل العمل، أنشِئ ملفًا باسم "
chat_membership_update.js
". أدرِج الرمز التالي في
chat_membership_update.js
:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Updates a membership in a Chat space to change it from * a space member to a space manager. * @return {!Promise<!Object>} */ async function updateSpace() { /** * Authenticate with Google Workspace * and get user authorization. */ const scopes = [ 'https://www.googleapis.com/auth/chat.memberships', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); /** * Build a service endpoint for Chat API. */ const chatClient = await chat.chat({version: 'v1', auth: authClient}); /** * Use the service endpoint to call Chat API. */ return await chatClient.spaces.patch({ /** * The membership to update, and the updated role. * * Replace SPACE with a space name. * Obtain the space name from the spaces resource of Chat API, * or from a space's URL. * * Replace MEMBERSHIP with a membership name. * Obtain the membership name from the membership of Chat API. */ name: 'spaces/SPACE/members/MEMBERSHIP', updateMask: 'role', requestBody: { role: 'ROLE_MANAGER' } }); } /** * Use the service endpoint to call Chat API. */ updateSpace().then(console.log);
في الرمز، استبدل ما يلي:
SPACE
: اسم مساحة التي يمكنك الحصول عليها من طريقة واحدة (spaces.list
) في Chat API أو من عنوان URL للمساحة.MEMBERSHIP
: اسم عضوية التي يمكنك الحصول عليها من طريقة واحدة (spaces.members.list
) في Chat API
في دليل العمل، أنشئ النموذج وشغِّله:
python3 chat_membership_update.js
برمجة تطبيقات
يستدعي هذا المثال واجهة برمجة تطبيقات Chat باستخدام خدمة Chat المتقدّمة
إضافة نطاق تفويض
chat.memberships
إلى ملفappsscript.json
لمشروع برمجة التطبيقات:"oauthScopes": [ "https://www.googleapis.com/auth/chat.memberships" ]
أضف دالة كهذه إلى مشروع "برمجة تطبيقات Google" الرمز:
/** * Updates a membership from space member to space manager. * @param {string} memberName The resource name of the membership. */ function updateMembershipToSpaceManager(memberName) { try { const body = {'role': 'ROLE_MANAGER'}; Chat.Spaces.Members.patch(memberName, body); } catch (err) { // TODO (developer) - Handle exception console.log('Failed to create message with error %s', err.message); } }
تغيّر واجهة برمجة التطبيقات في Google Chat الاشتراك المحدّد إلى مدير مساحة وتعرض
مثال على Membership
بالتفصيل التغيير.
جعل مدير المساحة عضوًا عاديًا
في المثال التالي، يصبح مدير المساحة عضوًا عاديًا من خلال تحديد
role
كـ ROLE_MEMBER
في body
التي تحدّد العضوية المُعدَّلة
:
Python
- في دليل العمل، أنشِئ ملفًا باسم "
chat_membership_update.py
". أدرِج الرمز التالي في
chat_membership_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.memberships"] def main(): ''' Authenticates with Chat API via user credentials, then updates a specified space member to change it from a regular member to a space manager. ''' # 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().members().patch( # The membership to update, and the updated role. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. # # Replace MEMBERSHIP with a membership name. # Obtain the membership name from the membership of Chat API. name='spaces/SPACE/members/MEMBERSHIP', updateMask='role', body={'role': 'ROLE_MEMBER'} ).execute() # Prints details about the updated membership. print(result) if __name__ == '__main__': main()
في الرمز، استبدل ما يلي:
SPACE
: اسم مساحة التي يمكنك الحصول عليها من طريقة واحدة (spaces.list
) في Chat API أو من عنوان URL للمساحة.MEMBERSHIP
: اسم عضوية التي يمكنك الحصول عليها من طريقة واحدة (spaces.members.list
) في Chat API
في دليل العمل، أنشئ النموذج وشغِّله:
python3 chat_membership_update.py
Node.js
- في دليل العمل، أنشِئ ملفًا باسم "
chat_membership_update.js
". أدرِج الرمز التالي في
chat_membership_update.js
:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Updates a membership in a Chat space to change it from * a space manager to a space member. * @return {!Promise<!Object>} */ async function updateSpace() { /** * Authenticate with Google Workspace * and get user authorization. */ const scopes = [ 'https://www.googleapis.com/auth/chat.memberships', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); /** * Build a service endpoint for Chat API. */ const chatClient = await chat.chat({version: 'v1', auth: authClient}); /** * Use the service endpoint to call Chat API. */ return await chatClient.spaces.patch({ /** * The membership to update, and the updated role. * * Replace SPACE with a space name. * Obtain the space name from the spaces resource of Chat API, * or from a space's URL. * * Replace MEMBERSHIP with a membership name. * Obtain the membership name from the membership of Chat API. */ name: 'spaces/SPACE/members/MEMBERSHIP', updateMask: 'role', requestBody: { role: 'ROLE_MEMBER' } }); } /** * Use the service endpoint to call Chat API. */ updateSpace().then(console.log);
في الرمز، استبدل ما يلي:
SPACE
: اسم مساحة التي يمكنك الحصول عليها من طريقة واحدة (spaces.list
) في Chat API أو من عنوان URL للمساحة.MEMBERSHIP
: اسم عضوية التي يمكنك الحصول عليها من طريقة واحدة (spaces.members.list
) في Chat API
في دليل العمل، أنشئ النموذج وشغِّله:
python3 chat_membership_update.js
برمجة تطبيقات
يستدعي هذا المثال واجهة برمجة تطبيقات Chat باستخدام خدمة Chat المتقدّمة
إضافة نطاق تفويض
chat.memberships
إلى ملفappsscript.json
لمشروع برمجة التطبيقات:"oauthScopes": [ "https://www.googleapis.com/auth/chat.memberships" ]
أضف دالة كهذه إلى مشروع "برمجة تطبيقات Google" الرمز:
/** * Updates a membership from space manager to space member. * @param {string} memberName The resource name of the membership. */ function updateMembershipToSpaceMember(memberName) { try { const body = {'role': 'ROLE_MEMBER'}; Chat.Spaces.Members.patch(memberName, body); } catch (err) { // TODO (developer) - Handle exception console.log('Failed to create message with error %s', err.message); } }
تغيّر واجهة برمجة التطبيقات في Google Chat الاشتراك المحدّد إلى مدير مساحة وتعرض
مثال على Membership
بالتفصيل التغيير.
مواضيع ذات صلة
- دعوة مستخدم أو تطبيق Google Chat إلى مساحة أو إضافتهما
- الحصول على تفاصيل حول عضوية المستخدم أو تطبيق Chat
- قائمة الأعضاء في مساحة
- إزالة مستخدم أو تطبيق في Chat من مساحة