تعديل قسم

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

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

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

Python

  • حساب على Google Workspace Business أو Enterprise مع إمكانية الوصول إلى Google Chat

تعديل قسم

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

  • حدِّد نطاق تفويض 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.