يوضّح هذا الدليل كيفية استخدام طريقة
position
في المورد 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نطاق التفويض. - استدعِ طريقة
PositionSection. - في نص الطلب، حدِّد
nameالقسم المطلوب وضعه والموضع الجديد:- اضبط
sortOrderعلى موضع مطلق (أكبر من 0). - أو اضبط
relativePositionعلىSTARTأوEND.
- اضبط
ينقل المثال التالي قسمًا إلى بداية القائمة:
Python
from google.cloud import chat_v1
def position_section():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.PositionSectionRequest(
name="SECTION_NAME",
relative_position=chat_v1.PositionSectionRequest.Position.START
)
# Make the request
response = client.position_section(request=request)
print(response)
لتشغيل هذا النموذج، استبدِل ما يلي:
-
SECTION_NAME: اسم المورد الخاص بالقسم. يمكنك الحصول على اسم المورد من خلال استدعاء الطريقةListSections.
تعرض واجهة Chat API النسخة المعدَّلة من Section.