Atualizar uma seção

Neste guia, explicamos como usar o método patch no recurso Section da API Google Chat para atualizar uma seção personalizada no Google Chat.

Somente seções do tipo CUSTOM_SECTION podem ser atualizadas. Para mais informações, consulte Criar e organizar seções no Google Chat.

Pré-requisitos

Python

Atualizar uma seção

Para atualizar uma seção com autenticação do usuário, transmita o seguinte na sua solicitação:

  • Especifique o escopo de autorização chat.users.sections.
  • Chame o método UpdateSection.
  • No corpo da solicitação, forneça um recurso Section e uma máscara de campo:
    • Defina o name da seção a ser atualizada.
    • Defina displayName como o novo nome da seção.
    • Defina updateMask como displayName.

O exemplo a seguir atualiza uma seção:

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)

Para executar esta amostra, substitua o seguinte:

  • SECTION_NAME: o nome do recurso da seção. Para receber o nome do recurso, chame o método ListSections.
  • NEW_SECTION_DISPLAY_NAME: o novo nome da seção.

A API Chat retorna a instância atualizada de Section.