يشرح هذا الدليل كيفية استخدام
create
الطريقة في مرجع Section ضِمن Google Chat API لإنشاء قسم مخصّص جديد
في Google Chat.
تساعد الأقسام المستخدمين في تجميع محادثاتهم وتخصيص قائمة المساحات المعروضة في لوحة التنقّل في Google Chat. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إنشاء الأقسام وتنظيمها في Google Chat.
المتطلبات الأساسية
Python
- إعداد بيئتك:
- إنشاء مشروع على Google Cloud.
- ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
- تفعيل Google Chat API وضبطه باستخدام اسم و رمز ووصف لتطبيق Chat.
- تثبيت مكتبة عملاء Google Cloud في Python
-
إنشاء بيانات اعتماد معرّف عميل OAuth لتطبيق على الكمبيوتر المكتبي. لتشغيل النموذج في هذا
الدليل، احفظ بيانات الاعتماد كملف JSON باسم
credentials.jsonفي دليلك المحلي.
- اختيار نطاق تفويض يتيح مصادقة المستخدم
إنشاء قسم
لإنشاء قسم باستخدام مصادقة المستخدم، مرِّر ما يلي في طلبك:
- حدِّد نطاق تفويض
chat.users.sections. - استدعِ طريقة
CreateSection. - في نص الطلب، قدِّم مرجع
Section:- اضبط
displayNameعلى اسم للقسم (بحد أقصى 80 حرفًا). - اضبط
typeعلىCUSTOM_SECTION.
- اضبط
ينشئ المثال التالي قسمًا:
Python
from google.cloud import chat_v1
def create_section():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.CreateSectionRequest(
parent="users/me",
section=chat_v1.Section(
display_name="SECTION_DISPLAY_NAME",
type=chat_v1.Section.SectionType.CUSTOM_SECTION
)
)
# Make the request
response = client.create_section(request=request)
print(response)
لتشغيل هذا النموذج، استبدِل ما يلي:
SECTION_DISPLAY_NAME: اسم القسم الجديد
تعرض Chat API نموذجًا من
Section يوضّح القسم الذي تم إنشاؤه.