Ajouter une réaction à un message

Ce guide explique comment utiliser la méthode create() sur la ressource Reaction de l'API Google Chat pour ajouter une réaction à un message (par exemple, 👍, 🚲 et 🌞).

La ressource Reaction représente un emoji que les utilisateurs peuvent utiliser pour réagir à un message, par exemple : 👍, 🚲 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 en attribuant un nom, une icône et une description à 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 de l'API gRPC avec les bibliothèques clientes Google Cloud. Vous pouvez également utiliser l'interface de l'API REST. Pour en savoir plus sur les interfaces gRPC et REST, consultez la présentation de l'API Google Chat.

Ajouter une réaction à un message

Pour créer une réaction à un message, transmettez les éléments suivants dans votre requête:

• Spécifiez le champ d'application d'autorisation chat.messages.reactions.create, chat.messages.reactions ou chat.messages.
• Appelez la méthode CreateReaction() en transmettant parent comme nom de ressource du message auquel réagir et reaction comme instance de Reaction, dans laquelle le champ unicode est un emoji standard représenté par une chaîne Unicode.

L'exemple suivant réagit à un message avec l'emoji 😀:

Node.js

chat/client-libraries/cloud/create-reaction-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.create'];

// This sample shows how to create reaction 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',
    reaction: {
      // A standard emoji represented by a unicode string.
      emoji: { unicode: '😀' }
    }
  };

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

  // Handle the response
  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 instance de Reaction qui détaille la réaction créée.

Articles associés

• Supprimer une réaction à un message
• Liste des réactions à un message