Encontrar um espaço de mensagem direta

Este guia explica como usar o findDirectMessage() método no recurso Space da API Google Chat para receber detalhes sobre um espaço de mensagem direta (MD).

O recurso Space representa um lugar onde pessoas e apps do Chat podem enviar mensagens, compartilhar arquivos e colaborar. Há vários tipos de espaços:

• As mensagens diretas (MDs) são conversas entre dois usuários ou um usuário e um app do Chat.
• As conversas em grupo são conversas entre três ou mais usuários e apps do Chat.
• Os espaços nomeados são lugares permanentes onde as pessoas enviam mensagens, compartilham arquivos e colaboram.

Quando um administrador do Google Workspace instala um app do Chat para toda a organização do Google Workspace, o Google Chat cria uma MD entre o app instalado e cada usuário da organização.

A autenticação com o app permite que um app do Chat receba MDs a que o app do Chat tem acesso no Google Chat (por exemplo, MDs de que ele faz parte). A autenticação com a autenticação do usuário retorna MDs a que o usuário autenticado tem acesso.

Pré-requisitos

Encontrar uma mensagem direta

Para encontrar uma mensagem direta no Google Chat, transmita o seguinte na sua solicitação:

• Com a autenticação do app, especifique o escopo de autorização chat.bot. Com a autenticação do usuário, especifique o escopo de autorização chat.spaces.readonly ou chat.spaces.
• Chame o FindDirectMessage(), método transmitindo o name do outro usuário na MD a ser retornada. Com a autenticação do usuário, esse método retorna uma MD entre o usuário que está chamando e o usuário especificado. Com a autenticação do app, esse método retorna uma MD entre o app que está chamando e o usuário especificado.
• Para adicionar um usuário humano como membro do espaço, especifique users/{user}, em que {user} é o {person_id} para o person da API People ou o ID de um user na API Directory. Por exemplo, se a pessoa resourceName da API People for people/123456789, você poderá adicionar o usuário ao espaço incluindo uma associação com users/123456789 como member.name.

Encontrar uma mensagem direta com a autenticação do usuário

Veja como encontrar uma mensagem direta com a autenticação do usuário:

import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = [
  'https://www.googleapis.com/auth/chat.spaces.readonly',
];

// This sample shows how to find a Direct Message space with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(
    USER_AUTH_OAUTH_SCOPES,
  );

  // Initialize request argument(s)
  const request = {
    // Replace USER_NAME here
    name: 'users/USER_NAME',
  };

  // Make the request
  const response = await chatClient.findDirectMessage(request);

  // Handle the response
  console.log(response);
}

await main();

Para executar esse exemplo, substitua USER_NAME pelo ID do campo name do usuário.

A API Chat retorna uma instância de Space que detalha a MD especificada.

Encontrar uma mensagem direta com a autenticação do app

Veja como encontrar uma mensagem direta com a autenticação do app:

import {createClientWithAppCredentials} from './authentication-utils.js';

// This sample shows how to find a Direct Message space with app credential
async function main() {
  // Create a client
  const chatClient = createClientWithAppCredentials();

  // Initialize request argument(s)
  const request = {
    // Replace USER_NAME here
    name: 'users/USER_NAME',
  };

  // Make the request
  const response = await chatClient.findDirectMessage(request);

  // Handle the response
  console.log(response);
}

await main();

Para executar esse exemplo, substitua USER_NAME pelo ID do campo name do usuário.

A API Chat retorna uma instância de Space que detalha a MD especificada.

Temas relacionados

• Criar um espaço.
• Configurar um espaço.
• Receber detalhes sobre um espaço.
• Listar espaços.
• Atualizar um espaço.
• Excluir um espaço.