Cómo buscar un espacio de mensaje directo (MD)

En esta guía, se explica cómo usar el método findDirectMessage() en el recurso Space de la API de Google Chat para obtener detalles sobre un espacio de mensajes directos (DM).

El recurso Space representa un lugar donde las personas y las apps de Chat pueden enviar mensajes, compartir archivos y colaborar. Existen varios tipos de espacios:

  • Los mensajes directos (MD) son conversaciones entre dos usuarios o un usuario y una app de Chat.
  • Los chats en grupo son conversaciones entre tres o más usuarios y las apps de Chat.
  • Los espacios con nombre son lugares persistentes en los que las personas envían mensajes, comparten archivos y colaboran.

La autenticación con autenticación de apps permite que una app de Chat obtenga los MD a los que tiene acceso en Google Chat (por ejemplo, los MD de los que es miembro). La autenticación con la autenticación de usuario muestra los MD a los que tiene acceso el usuario autenticado.

Requisitos previos

Node.js

Cómo encontrar un mensaje directo

Para encontrar un mensaje directo en Google Chat, pasa lo siguiente en la solicitud:

  • Con la autenticación de apps, especifica el alcance de la autorización de chat.bot. Con la autenticación de usuarios, especifica el alcance de la autorización chat.spaces.readonly o chat.spaces.
  • Llama al método FindDirectMessage(), que pasa el name del otro usuario en el DM que se debe mostrar. Con la autenticación del usuario, este método muestra un DM entre el usuario que llama y el usuario especificado. Con la autenticación de apps, este método muestra un DM entre la app que realiza la llamada y el usuario especificado.
  • Para agregar un usuario humano como miembro de un espacio, especifica users/{user}, en el que {user} es el {person_id} de person de la API de People o el ID de un user en la API de Directory. Por ejemplo, si la persona de la API de People resourceName es people/123456789, puedes agregar al usuario al espacio si incluyes una membresía con users/123456789 como member.name.

Busca un mensaje directo con autenticación del usuario

Sigue estos pasos para encontrar un mensaje directo con autenticación del usuario:

Node.js

chat/client-libraries/cloud/find-dm-space-user-cred.js
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);
}

main().catch(console.error);

Para ejecutar este ejemplo, reemplaza USER_NAME por el ID del campo name del usuario.

La API de Chat muestra una instancia de Space que detalla el DM especificado.

Cómo encontrar un mensaje directo con autenticación de apps

Sigue estos pasos para encontrar un mensaje directo con autenticación de apps:

Node.js

chat/client-libraries/cloud/find-dm-space-app-cred.js
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);
}

main().catch(console.error);

Para ejecutar este ejemplo, reemplaza USER_NAME por el ID del campo name del usuario.

La API de Chat muestra una instancia de Space que detalla el DM especificado.