Method: spaces.setup

Cria um espaço e adiciona usuários especificados a ele. O usuário que fez a chamada é adicionado automaticamente ao espaço e não pode ser especificado como participante na solicitação. Veja um exemplo em Configurar um espaço com os participantes iniciais.

Para especificar os membros que serão adicionados, adicione as assinaturas com o membership.member.name apropriado. Para adicionar um usuário humano, use users/{user}, em que {user} pode ser o endereço de e-mail do usuário. Para usuários na mesma organização do Workspace, {user} também pode ser o id para a pessoa na API People ou o id para o usuário na API Directory. Por exemplo, se o ID do perfil de pessoa da API People para user@example.com for 123456789, defina membership.member.name como users/user@example.com ou users/123456789 para adicionar o usuário ao espaço.

Para especificar os grupos do Google que serão adicionados, adicione as associações com o membership.group_member.name apropriado. Para adicionar ou convidar um grupo do Google, use groups/{group}, em que {group} é o id do grupo na API Cloud Identity Groups. Por exemplo, você pode usar a API Cloud Identity Groups lookup para recuperar o ID 123456789 do e-mail do grupo group@example.com e adicionar o grupo ao espaço definindo membership.group_member.name como groups/123456789. Não é possível usar o e-mail do grupo, e os grupos do Google só podem ser adicionados como participantes em espaços nomeados.

Em um espaço nomeado ou um chat em grupo, se o autor da chamada bloquear, ser bloqueado por alguns participantes ou não tiver permissão para adicionar alguns participantes, eles não serão adicionados ao espaço criado.

Para criar uma mensagem direta (DM) entre o usuário que fez a chamada e outro usuário humano, especifique exatamente uma associação para representar o usuário humano. Se um usuário bloquear o outro, a solicitação falhará e o DM não será criado.

Para criar uma mensagem direta entre o usuário que fez a chamada e o app de chamada, defina Space.singleUserBotDm como true e não especifique nenhuma associação. Esse método só pode ser usado para configurar uma mensagem direta com o app de chamada. Para adicionar o app de chamada como participante de um espaço ou como uma mensagem direta entre dois usuários humanos, consulte Convidar ou adicionar um usuário ou app a um espaço.

Se já houver um tomador de decisão entre dois usuários, mesmo que um deles bloqueie o outro no momento em que uma solicitação for feita, a mensagem direta atual será retornada.

Os espaços com respostas agrupadas não estão disponíveis. Se você receber a mensagem de erro ALREADY_EXISTS ao configurar um espaço, tente usar outra displayName. Talvez um espaço na organização do Google Workspace já esteja usando esse nome de exibição.

Exige a autenticação do usuário.

Solicitação HTTP

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

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

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "space": {
    object (Space)
  },
  "requestId": string,
  "memberships": [
    {
      object (Membership)
    }
  ]
}
Campos
space

object (Space)

Obrigatório. O campo Space.spaceType é obrigatório.

Para criar um espaço, defina Space.spaceType como SPACE e defina Space.displayName. Se você receber a mensagem de erro ALREADY_EXISTS ao configurar um espaço, tente usar outra displayName. Talvez um espaço na organização do Google Workspace já esteja usando esse nome de exibição.

Para criar um chat em grupo, defina Space.spaceType como GROUP_CHAT. Não defina Space.displayName.

Para criar uma conversa individual entre pessoas, defina Space.spaceType como DIRECT_MESSAGE e Space.singleUserBotDm como false. Não defina Space.displayName ou Space.spaceDetails.

Para criar uma conversa individual entre uma pessoa e o app de chamada do Chat, defina Space.spaceType como DIRECT_MESSAGE e Space.singleUserBotDm como true. Não defina Space.displayName ou Space.spaceDetails.

Se um espaço DIRECT_MESSAGE já existir, ele será retornado em vez de criar um novo.

requestId

string

Opcional. Um identificador exclusivo para essa solicitação. Um UUID aleatório é recomendado. Especificar um ID de solicitação já existente retorna o espaço criado com esse ID em vez de criar um novo. Especificar um ID de solicitação no mesmo app do Chat com um usuário autenticado diferente retorna um erro.

memberships[]

object (Membership)

Opcional. Os usuários ou grupos do Google Chat que serão convidados para o espaço. Omita o usuário que faz a chamada, porque ele é adicionado automaticamente.

O conjunto atualmente permite até 20 associações (além do autor da chamada).

Para associação humana, o campo Membership.member precisa conter um user com name preenchido (formato: users/{user}) e type definido como User.Type.HUMAN. Só é possível adicionar usuários humanos ao configurar um espaço. Só é possível adicionar apps do Chat para a configuração de mensagens diretas com o app de chamada. Também é possível adicionar participantes usando o e-mail do usuário como um alias para {user}. Por exemplo, o user.name pode ser users/example@gmail.com. Para convidar usuários do Gmail ou de domínios externos do Google Workspace, o e-mail do usuário precisa ser usado para {user}.

Para associação a um grupo do Google, o campo Membership.group_member precisa conter um group com name preenchido (formato groups/{group}). Você só pode adicionar Grupos do Google quando definir Space.spaceType como SPACE.

Opcional ao definir Space.spaceType como SPACE.

Obrigatório ao definir Space.spaceType como GROUP_CHAT, assim como pelo menos duas assinaturas.

Obrigatório ao definir Space.spaceType como DIRECT_MESSAGE com um usuário humano, junto com exatamente uma assinatura.

Precisa estar em branco ao criar uma conversa individual entre uma pessoa e o app de chamada do Chat (ao definir Space.spaceType como DIRECT_MESSAGE e Space.singleUserBotDm como true).

Corpo da resposta

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

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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