يشرح هذا الدليل كيفية استخدام طريقة
list
في مورد Section ضِمن Google Chat API لعرض قائمة بالأقسام المتاحة للمستخدم الذي تم التحقّق من هويته في Google Chat.
لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء أقسام وتنظيمها في Google Chat.
المتطلبات الأساسية
Python
- حساب Google Workspace Business أو Enterprise مع إمكانية الوصول إلى Google Chat
- إعداد البيئة:
- أنشئ مشروعًا على Google Cloud.
- ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
- فعِّل واجهة Google Chat API وأعِدّها من خلال إضافة اسم ورمز ووصف لتطبيق Chat.
- ثبِّت مكتبة برامج Cloud للغة Python.
-
إنشاء بيانات اعتماد معرِّف عميل OAuth لتطبيق على جهاز كمبيوتر لتشغيل النموذج في هذا الدليل، احفظ بيانات الاعتماد كملف JSON باسم
credentials.jsonفي الدليل المحلي.
- اختَر نطاق تفويض يتيح مصادقة المستخدم.
أقسام القائمة
لعرض أقسام تتضمّن مصادقة المستخدم، مرِّر ما يلي في طلبك:
- حدِّد نطاق تفويض
chat.users.sectionsأوchat.users.sections.readonly. - استدعِ طريقة
ListSections. - اضبط قيمة
parentعلىusers/me.
يعرض المثال التالي أقسامًا:
Python
from google.cloud import chat_v1
def list_sections():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.ListSectionsRequest(
parent="users/me"
)
# Make the request
page_result = client.list_sections(request=request)
# Handle the response
for section in page_result:
print(section)
تعرض Chat API قائمة بموارد
Section.