تعديل قسم

يشرح هذا الدليل كيفية استخدام طريقة patch في المورد Section ضِمن Google Chat API لتعديل قسم مخصّص في Google Chat.

يمكن تعديل الأقسام من النوع CUSTOM_SECTION فقط. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء أقسام وتنظيمها في Google Chat.

المتطلبات الأساسية

Python

تعديل قسم

لتعديل قسم باستخدام مصادقة المستخدم، مرِّر ما يلي في طلبك:

  • حدِّد chat.users.sections نطاق التفويض.
  • استدعِ طريقة UpdateSection.
  • في نص الطلب، قدِّم مورد Section وقناع حقل:
    • اضبط name القسم الذي تريد تعديله.
    • اضبط displayName على الاسم الجديد للقسم.
    • اضبط قيمة updateMask على displayName.

يعدّل المثال التالي قسمًا:

Python

from google.cloud import chat_v1
from google.protobuf import field_mask_pb2

def update_section():
    # Create a client
    client = chat_v1.ChatServiceClient()

    # Initialize request
    request = chat_v1.UpdateSectionRequest(
        section=chat_v1.Section(
            name="SECTION_NAME",
            display_name="NEW_SECTION_DISPLAY_NAME"
        ),
        update_mask=field_mask_pb2.FieldMask(paths=["display_name"])
    )

    # Make the request
    response = client.update_section(request=request)

    print(response)

لتشغيل هذا النموذج، استبدِل ما يلي:

  • ‫SECTION_NAME: اسم المورد الخاص بالقسم. يمكنك الحصول على اسم المورد من خلال استدعاء الطريقة ListSections.
  • NEW_SECTION_DISPLAY_NAME: الاسم الجديد للقسم

تعرض واجهة Chat API النسخة المعدَّلة من Section.