Rechercher un espace de message privé (MP)

Ce guide explique comment utiliser la findDirectMessage() méthode sur la ressource Space de l'API Google Chat pour obtenir des informations sur un espace de message privé (MP).

La ressource Space représente un emplacement où les utilisateurs et les applications Chat peuvent envoyer des messages, partager des fichiers et collaborer. Il existe plusieurs types d'espaces :

  • Les messages privés sont des conversations entre deux utilisateurs ou entre un utilisateur et une application Chat.
  • Les chats de groupe sont des conversations entre trois utilisateurs ou plus et des applications Chat.
  • Les espaces nommés sont des emplacements persistants où les utilisateurs envoient des messages, partagent des fichiers et collaborent.

Lorsqu'un administrateur Google Workspace installe une application Chat pour l'ensemble de son organisation Google Workspace, Google Chat crée un message privé entre l'application Chat installée et chaque utilisateur de l'organisation.

L'authentification avec l'authentification de l'application permet à une application Chat d'obtenir les messages privés auxquels elle a accès dans Google Chat (par exemple, les messages privés dont elle est membre). L'authentification avec l'authentification de l'utilisateur renvoie les messages privés auxquels l'utilisateur authentifié a accès.

Prérequis

Node.js

Rechercher un message privé

Pour rechercher un message privé dans Google Chat, transmettez les éléments suivants dans votre requête :

  • Avec l'authentification de l'application, spécifiez le champ d'application d'autorisation chat.bot. Avec l'authentification de l'utilisateur, spécifiez le champ d'application d'autorisation chat.spaces.readonly ou chat.spaces.
  • Appelez la FindDirectMessage(), méthode en transmettant le name de l’autre utilisateur dans le MP à renvoyer. Avec l'authentification de l'utilisateur, cette méthode renvoie un message privé entre l'utilisateur appelant et l'utilisateur spécifié. Avec l'authentification de l'application, cette méthode renvoie un message privé entre l'application appelante et l'utilisateur spécifié.
  • Pour ajouter un utilisateur humain en tant que membre d'un espace, spécifiez users/{user}, où {user} correspond au {person_id} de la person de l'API People ou à l'ID d'un user dans l'API Directory. Par exemple, si la personne de l'API People resourceName est people/123456789, vous pouvez ajouter l'utilisateur à l'espace en incluant une adhésion avec users/123456789 comme member.name.

Rechercher un message privé avec l'authentification de l'utilisateur

Voici comment rechercher un message privé avec l'authentification de l'utilisateur :

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);
}

await main();

Pour exécuter cet exemple, remplacez USER_NAME par l'ID du champ name de l'utilisateur.

L'API Chat renvoie une instance de Space qui détaille le message privé spécifié.

Rechercher un message privé avec l'authentification de l'application

Voici comment rechercher un message privé avec l'authentification de l'application :

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);
}

await main();

Pour exécuter cet exemple, remplacez USER_NAME par l'ID du champ name de l'utilisateur.

L'API Chat renvoie une instance de Space qui détaille le message privé spécifié.