Method: spaces.findDirectMessage

Retorna a mensagem direta com o usuário especificado. Se nenhum espaço de mensagem direta for encontrado, um erro 404 NOT_FOUND será retornado. Para conferir um exemplo, consulte Encontrar uma mensagem direta.

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

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

Oferece suporte aos seguintes tipos de autenticação:

  • Autenticação do app com o escopo de autorização:

    • https://www.googleapis.com/auth/chat.bot
  • Autenticação do usuário com um dos seguintes escopos de autorização:

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

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 você quer encontrar uma mensagem direta.

Formato: users/{user}, em que {user} é o id da pessoa da 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 autenticados como um usuário, é possível usar o e-mail como um alias para {user}. Por exemplo, users/[email protected], em que [email protected] é 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 do 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.