Method: spaces.findDirectMessage

Retorna a mensagem direta existente com o usuário especificado. Se nenhum espaço de mensagens diretas for encontrado, um erro 404 NOT_FOUND será retornado. Veja um exemplo em Encontrar uma mensagem direta.

Com a autenticação do usuário, retorna o espaço da mensagem direta entre o usuário especificado e o usuário autenticado.

Com a autenticação de apps, retorna o espaço da mensagem direta entre o usuário especificado e o app do Chat que fez a chamada.

Requer autenticação do usuário ou autenticação do app.

Solicitação HTTP

GET https://chat.googleapis.com/v1/spaces:findDirectMessage

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

Parâmetros de consulta

Parâmetros
name

string

Obrigatório. Nome do recurso do usuário com quem a mensagem direta será encontrada.

Formato: users/{user}, em que {user} é o id da pessoa na API People ou o id do usuário na API Directory. Por exemplo, se o ID do perfil da API People for 123456789, você poderá encontrar uma mensagem direta com essa pessoa usando users/123456789 como name. Quando autenticado como usuário, você pode usar o e-mail como um alias do {user}. Por exemplo, users/example@gmail.com, em que example@gmail.com é o e-mail do usuário do Google Chat.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

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 de OAuth:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.bot

Para mais informações, consulte o Guia de autorização.