Method: spaces.findDirectMessage

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

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

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

Exige autenticação de usuário ou autenticação de conta de serviço.

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 para encontrar mensagem direta.

Formato: users/{user}, em que {user} é o {person_id} para a pessoa da API People ou o id para o usuário na API Directory. Por exemplo, se a API de pessoas Person.resourceName for people/123456789, você pode encontrar uma mensagem direta com essa pessoa usando users/123456789 como name. Quando autenticado como um usuário, você pode usar o e-mail como um alias de {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.