يشرح هذا الدليل كيفية استخدام طريقة
delete
في مورد Section ضِمن Google Chat API لحذف قسم مخصّص في Google Chat.
عند حذف قسم، يتم نقل العناصر التابعة له (مثل المساحات) إلى الأقسام التلقائية في Google Chat، ولا يتم حذفها.
يمكن حذف الأقسام من النوع CUSTOM_SECTION فقط. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء أقسام وتنظيمها في 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نطاق التفويض. - استدعِ طريقة
DeleteSection. - في نص الطلب، اضبط
nameعلى اسم مورد القسم المطلوب حذفه.
يحذف المثال التالي قسمًا:
Python
from google.cloud import chat_v1
def delete_section():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.DeleteSectionRequest(
name="SECTION_NAME"
)
# Make the request
client.delete_section(request=request)
print("Section deleted")
لتشغيل هذا النموذج، استبدِل ما يلي:
-
SECTION_NAME: اسم المورد الخاص بالقسم. يمكنك الحصول على اسم المورد من خلال استدعاء الطريقةListSections.