Répertorier les réactions à un message

Ce guide explique comment utiliser la méthode list() sur la ressource Reaction de l'API Google Chat pour lister les réactions à un message (comme 👍, 🚲 et 🌞).

La ressource Reaction représente un emoji que les utilisateurs peuvent utiliser pour réagir à un message, comme 👍, 🚲 et 🌞.

Prérequis

Node.js

• Compte Google Workspace Business ou Enterprise ayant accès à Google Chat.

• Configurez votre environnement :
  • Créez un projet Google Cloud.
  • Configurez l'écran de consentement OAuth.
  • Activez et configurez l'API Google Chat avec un nom, une icône et une description pour votre application Chat.
  • Installez la bibliothèque cliente Cloud Node.js.
  • Créez des identifiants d'ID client OAuth pour une application de bureau. Pour exécuter l'exemple de ce guide, enregistrez les identifiants sous forme de fichier JSON nommé client_secrets.json dans votre répertoire local.
  Pour obtenir des conseils, suivez la procédure de configuration de votre environnement dans ce guide de démarrage rapide.
• Choisissez une portée d'autorisation compatible avec l'authentification des utilisateurs.

Les exemples de code de cette page utilisent l'interface API gRPC avec les bibliothèques clientes Google Cloud. Vous pouvez également utiliser l'interface API REST. Pour en savoir plus sur les interfaces gRPC et REST, consultez la présentation de l'API Google Chat.

Lister les réactions

Pour répertorier les réactions à un message, transmettez les éléments suivants dans votre requête:

• Spécifiez le champ d'application d'autorisation chat.messages.reactions.readonly, chat.messages.reactions, chat.messages.readonly ou chat.messages.
• Appelez la méthode ListReactions(), en transmettant parent comme nom de ressource du message.

L'exemple suivant liste les réactions pour un message spécifié:

Node.js

chat/client-libraries/cloud/list-reactions-user-cred.js

Afficher sur GitHub

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

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

// This sample shows how to list reactions to a message with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME and MESSAGE_NAME here.
    parent: 'spaces/SPACE_NAME/messages/MESSAGE_NAME'
  };

  // Make the request
  const pageResult = chatClient.listReactionsAsync(request);

  // Handle the response. Iterating over pageResult will yield results and
  // resolve additional pages automatically.
  for await (const response of pageResult) {
    console.log(response);
  }
}

main().catch(console.error);

Pour exécuter cet exemple, remplacez les éléments suivants:

• SPACE_NAME: ID de l'name de l'espace. Vous pouvez obtenir l'ID en appelant la méthode ListSpaces() ou à partir de l'URL de l'espace.
• MESSAGE_NAME: ID de l'name du message. Vous pouvez obtenir l'ID à partir du corps de la réponse renvoyée après avoir créé un message de manière asynchrone avec l'API Chat ou avec le nom personnalisé attribué au message lors de sa création.

L'API Chat renvoie une liste paginée de réactions.

Articles associés

• Ajouter une réaction à un message
• Supprimer une réaction à un message