يوضّح هذا الدليل كيفية استخدام طريقة
list
في مورد SectionItem ضِمن Google Chat API لإدراج عناصر (مثل المساحات) في قسم.
يمكن أن تكون المساحات فقط عناصر أقسام. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء أقسام وتنظيمها في 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. - استدعِ طريقة
ListSectionItems. - اضبط قيمة
parentعلى اسم مورد القسم.
يعرض المثال التالي مساحات في أحد الأقسام:
Python
from google.cloud import chat_v1
def list_section_items():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.ListSectionItemsRequest(
parent="SECTION_NAME"
)
# Make the request
page_result = client.list_section_items(request=request)
# Handle the response
for item in page_result:
print(item)
لتشغيل هذا النموذج، استبدِل ما يلي:
-
SECTION_NAME: اسم المورد الخاص بالقسم. يمكنك الحصول على اسم المورد من خلال استدعاء الطريقةListSections.
تعرض Chat API قائمة بموارد
SectionItem.