يوضّح هذا الدليل كيفية استخدام طريقة
move
في مورد 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نطاق التفويض. - استدعِ طريقة
MoveSectionItem. - في نص الطلب، حدِّد
nameلعنصر القسم المطلوب نقله وtargetSection:- اضبط
nameعلى اسم المرجع لعنصر القسم (مثلاً،users/me/sections/default-spaces/items/spaces/123456). - اضبط
targetSectionعلى اسم المورد الخاص بالقسم الذي تريد نقل العنصر إليه.
- اضبط
ينقل المثال التالي مساحة إلى قسم مختلف:
Python
from google.cloud import chat_v1
def move_section_item():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.MoveSectionItemRequest(
name="SECTION_ITEM_NAME",
target_section="TARGET_SECTION_NAME"
)
# Make the request
response = client.move_section_item(request=request)
print(response)
لتشغيل هذا النموذج، استبدِل ما يلي:
-
SECTION_ITEM_NAME: اسم المرجع لعنصر القسم -
TARGET_SECTION_NAME: اسم المورد الخاص بالقسم المستهدَف.
تعرض واجهة Chat API النسخة المعدَّلة من SectionItem.