به‌روزرسانی یک بخش

این راهنما نحوه استفاده از متد patch روی منبع Section از API گوگل چت برای به‌روزرسانی یک بخش سفارشی در گوگل چت را توضیح می‌دهد.

فقط بخش‌هایی از نوع CUSTOM_SECTION می‌توانند به‌روزرسانی شوند. برای اطلاعات بیشتر، به «ایجاد و سازماندهی بخش‌ها در Google Chat» مراجعه کنید.

پیش‌نیازها

پایتون

به‌روزرسانی یک بخش

برای به‌روزرسانی یک بخش با احراز هویت کاربر ، موارد زیر را در درخواست خود وارد کنید:

  • دامنه مجوز chat.users.sections را مشخص کنید.
  • متد UpdateSection را فراخوانی کنید.
  • در بدنه درخواست، یک منبع Section resource) و یک ماسک فیلد (field mask) ارائه دهید:
    • name بخشی را که قرار است به‌روزرسانی شود، تعیین کنید.
    • displayName روی نام جدید بخش تنظیم کنید.
    • updateMask روی displayName تنظیم کنید.

مثال زیر یک بخش را به‌روزرسانی می‌کند:

پایتون 

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 : نام جدید برای بخش.

API چت، نمونه‌ی به‌روزرسانی‌شده‌ی Section را برمی‌گرداند.