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 ver um exemplo, consulte Criar um espaço.

Aceita os seguintes tipos de autenticação:

  • Autenticação de app com aprovação do administrador 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 de 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 autenticar como um app, o app do Chat é adicionado como 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 podem remover o app Chat do espaço. Para permitir que apenas os administradores do espaço removam o app, defina space.permission_settings.manage_apps como managersAllowed.

A assinatura do espaço no momento da criação depende de onde ele foi criado: Import mode:

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

Se você receber a mensagem de erro ALREADY_EXISTS ao criar um espaço, tente usar outro displayName. Um espaço 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 esta solicitação. Recomendamos um UUID aleatório. Especificar um ID de solicitação existente retorna o espaço criado com esse ID em vez de criar um novo. Especificar um ID de solicitação existente do mesmo app do 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.