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 apps de chat.
• Los espacios con nombre son lugares persistentes en los que las personas envían mensajes, comparten archivos y colaboran.

Cuando un administrador de Google Workspace instala una app de Chat para toda su organización de Google Workspace, Google Chat crea un DM entre la app de Chat instalada y cada usuario de la organización.

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 autenticación de usuarios muestra los mensajes directos a los que tiene acceso el usuario autenticado.

Requisitos previos

Cómo encontrar un mensaje directo

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

• Con la autenticación de apps, especifica el alcance de autorización de chat.bot. Con la autenticación de usuarios, especifica el permiso de autorización chat.spaces.readonly o chat.spaces.
• Llama al método FindDirectMessage() y pasa el name del otro usuario en el DM para que se muestre. 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} para el person de la API de People o el ID de un user en la API de Directory. Por ejemplo, si el resourceName de la persona de la API de Personas 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:

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 MD especificado.

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

A continuación, te mostramos cómo encontrar un mensaje directo con autenticación de apps:

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 MD especificado.

Temas relacionados

• Crear un espacio.
• Configura un espacio.
• Obtener detalles sobre un espacio
• Crea listas de espacios.
• Actualiza un espacio.
• Borra un espacio.