Neste guia, explicamos como usar o método
create
no recurso Section da API Google Chat para criar uma nova
seção personalizada no Google Chat.
As seções ajudam os usuários a agrupar as conversas e personalizar a lista de espaços mostrados no painel de navegação do 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 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 do Chat.
- Instale a biblioteca de cliente do Cloud Python.
-
Crie credenciais de ID do cliente OAuth para um aplicativo para computador. Para executar a amostra 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.
Criar uma seção
Para criar 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
CreateSection. - No corpo da solicitação, forneça um recurso
Section:- Defina
displayNamecomo um nome para a seção (até 80 caracteres). - Defina
typecomoCUSTOM_SECTION.
- Defina
O exemplo a seguir cria uma seção:
Python
from google.cloud import chat_v1
def create_section():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.CreateSectionRequest(
parent="users/me",
section=chat_v1.Section(
display_name="SECTION_DISPLAY_NAME",
type=chat_v1.Section.SectionType.CUSTOM_SECTION
)
)
# Make the request
response = client.create_section(request=request)
print(response)
Para executar esta amostra, substitua o seguinte:
SECTION_DISPLAY_NAME: o nome da nova seção.
A API Chat retorna uma instância de
Section que detalha a seção criada.
Temas relacionados
- Atualizar 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