- 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:
Ao autenticar como um app, o campo space.customer
precisa ser definido na solicitação.
A associação ao 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 | |
---|---|
request |
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.