يوضّح هذا الدليل كيفية استخدام طريقة
create
في المورد Section ضِمن Google Chat API لإنشاء قسم مخصّص جديد في Google Chat.
تساعد الأقسام المستخدمين في تجميع محادثاتهم وتخصيص قائمة المساحات المعروضة في لوحة التنقّل في 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نطاق التفويض. - استدعِ طريقة
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 يوضّح القسم الذي تم إنشاؤه.