Method: spaces.create

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
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.