Este guia explica como usar o
position
método no recurso Section da API Google Chat para mudar a ordem de classificação de uma seção no Google Chat.
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.
Mudar a posição de uma seção
Para mudar a posição de uma seção com a autenticação do usuário, transmita o seguinte na sua solicitação:
- Especifique o escopo de autorização
chat.users.sections. - Chame o
PositionSectionmétodo. - No corpo da solicitação, especifique o
nameda seção a ser posicionada e a nova posição:- Defina
sortOrdercomo uma posição absoluta (maior que 0). - OU defina
relativePositioncomoSTARTouEND.
- Defina
O exemplo a seguir move uma seção para o início da lista:
Python
from google.cloud import chat_v1
def position_section():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.PositionSectionRequest(
name="SECTION_NAME",
relative_position=chat_v1.PositionSectionRequest.Position.START
)
# Make the request
response = client.position_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.
A API Chat retorna a instância atualizada de
Section.
Temas relacionados
- Criar uma seção
- Atualizar uma seção
- Excluir uma seção
- Listar seções
- Listar espaços em uma seção
- Mover um espaço para outra seção