Method: spaces.create

• Solicitação HTTP
• Parâmetros de consulta
• Corpo da solicitação
• Corpo da resposta
• Escopos de autorização
• Faça um teste

Cria um espaço. Pode ser usado para criar um espaço nomeado ou um chat em grupo no Import mode. Para conferir um exemplo, consulte Criar um espaço.

Oferece suporte aos seguintes tipos de autenticação:

• Autenticação de app com aprovação do administrador na Prévia para desenvolvedores e um dos seguintes escopos de autorização:

  • https://www.googleapis.com/auth/chat.app.spaces.create
  • https://www.googleapis.com/auth/chat.app.spaces

• Autenticação do usuário com um dos seguintes escopos de autorização:

  • https://www.googleapis.com/auth/chat.spaces.create
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.import (somente espaços do modo de importação)

Ao autenticar como um app, o campo space.customer precisa ser definido na solicitação.

Ao fazer a autenticação como um app, o app do Chat é adicionado como um participante do espaço. No entanto, ao contrário da autenticação humana, o app do Chat não é adicionado como administrador do espaço. Por padrão, todos os participantes do espaço podem remover o app Chat. Para permitir que apenas os administradores removam o app de um espaço, defina space.permission_settings.manage_apps como managersAllowed.

A assinatura do espaço na criação depende se ele foi criado em Import mode:

• Modo de importação:nenhum participante é criado.
• Todos os outros modos:o usuário que faz a chamada é adicionado como membro. Isso é:
  • O próprio app quando a autenticação é feita por ele.
  • O usuário humano ao usar a autenticação do usuário.

Se você receber a mensagem de erro ALREADY_EXISTS ao criar um espaço, tente usar um displayName diferente. Um espaço existente na organização do Google Workspace já pode usar esse nome de exibição.

Solicitação HTTP

POST https://chat.googleapis.com/v1/spaces

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de consulta

Parâmetros
requestId	string Opcional. Um identificador exclusivo para essa solicitação. Recomendamos um UUID aleatório. Especificar um ID de solicitação atual retorna o espaço criado com esse ID em vez de criar um novo espaço. Especificar um ID de solicitação do mesmo app de chat com um usuário autenticado diferente retorna um erro.

Corpo da solicitação

O corpo da solicitação contém uma instância de Space.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de Space.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

• https://www.googleapis.com/auth/chat.app.spaces.create
• https://www.googleapis.com/auth/chat.app.spaces
• https://www.googleapis.com/auth/chat.import
• https://www.googleapis.com/auth/chat.spaces
• https://www.googleapis.com/auth/chat.spaces.create

Para mais informações, consulte o guia de autorização.