Este guia explica como usar o
patch
método no Section recurso 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
- Uma conta do Google Workspace Business ou Enterprise com acesso ao Google Chat.
- Configure seu ambiente:
- Crie um projeto na nuvem do Google Cloud.
- Configure a tela de permissão OAuth.
- Ative e configure a API Google Chat com um nome, ícone e descrição para seu app Chat.
- Instale a biblioteca de cliente Python do Cloud.
-
Crie credenciais de ID do cliente OAuth para um aplicativo de computador. Para executar o exemplo neste
guia, salve as credenciais como um arquivo JSON chamado
credentials.jsonno seu diretório local.
- Escolha um escopo de autorização que ofereça suporte à autenticação do usuário.
Atualizar uma seção
Para atualizar uma seção com a autenticação do usuário, transmita o seguinte na solicitação:
- Especifique o escopo de autorização
chat.users.sections. - Chame o
UpdateSectionmétodo. - No corpo da solicitação, forneça um recurso
Sectione uma máscara de campo:- Defina o
nameda seção a ser atualizada. - Defina
displayNamecomo o novo nome da seção. - Defina
updateMaskcomodisplayName.
- Defina o
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 este exemplo, substitua o seguinte:
SECTION_NAME: o nome do recurso da seção. Você pode receber o nome do recurso chamando oListSectionsmétodo.NEW_SECTION_DISPLAY_NAME: o novo nome da seção.
A API Chat retorna a instância atualizada de
Section.
Temas relacionados
- Criar uma seção
- Excluir uma seção
- Mudar a posição de uma seção
- Listar seções
- Listar espaços em uma seção
- Mover um espaço para outra seção