Method: spaces.create

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

Oferece suporte aos 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 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 no 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 Chat é adicionado como membro do espaço. No entanto, ao contrário da autenticação humana, o app Chat não é adicionado como administrador do espaço. Por padrão, o app Chat pode ser removido do espaço por todos os membros. Para permitir que apenas os administradores do espaço removam o app, defina space.permission_settings.manage_apps como managersAllowed.

A participação no espaço após a criação depende de ele ser criado no Import mode:

  • Modo de importação:nenhum membro é criado.
  • Todos os outros modos:o usuário que faz a chamada é adicionado como membro. Isso é:
    • O próprio app ao usar a autenticação de app.
    • 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 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 ID exclusivo para essa solicitação. Recomendamos um UUID aleatório. Especificar um ID de solicitação torna a solicitação idempotente, o que garante que várias solicitações idênticas com o mesmo ID de solicitação resultem na criação de apenas um espaço. As solicitações subsequentes com o mesmo ID de solicitação retornam o espaço existente e não o atualizam, mesmo que os detalhes solicitados sejam diferentes do estado atual.

Para usar esse campo de maneira eficaz:

  • Verifique se as solicitações subsequentes são idênticas e usam as mesmas credenciais de autenticação da solicitação original.
  • Se um espaço já tiver sido criado com o ID de solicitação fornecido, a solicitação vai retornar esse espaço. O espaço retornado pode não estar totalmente preenchido. A API ecoa o espaço na solicitação com o nome do recurso atribuído pelo sistema. Para recuperar os metadados mais recentes do espaço, chame spaces.get.
  • A reutilização de um ID de solicitação existente com um usuário autenticado diferente resulta em 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.