Créer un emoji personnalisé

Ce guide explique comment utiliser la create méthode sur la ressource CustomEmoji de l'API Google Chat pour créer un emoji personnalisé dans une organisation Google Workspace.

Les emoji personnalisés ne sont disponibles que pour les comptes Google Workspace, et votre administrateur doit les activer pour votre organisation. Pour en savoir plus, consultez À propos des emoji personnalisés dans Google Chat et Gérer les autorisations pour les emoji personnalisés.

Prérequis

Node.js

Créer un emoji personnalisé

Pour créer un emoji personnalisé avec l'authentification de l'utilisateur, transmettez les éléments suivants dans votre requête :

  • Spécifiez le champ d'application d'autorisation chat.customemojis.
  • Appelez la CreateCustomEmoji méthode.
  • Dans le corps de la requête, fournissez une ressource CustomEmoji, en définissant emojiName (un identifiant unique que vous choisissez pour l'emoji) et payload (le contenu de l'image que vous choisissez pour l'emoji).

L'exemple suivant crée un emoji personnalisé :

Node.js

chat/client-libraries/cloud/create-custom-emoji-user-cred.js
import fs from 'node:fs';
import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = [
  'https://www.googleapis.com/auth/chat.customemojis',
];

// This sample shows how to create custom emoji with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(
    USER_AUTH_OAUTH_SCOPES,
  );

  // TODO(developer) Replace FILENAME here.
  const filename = 'FILENAME';
  // Read custom emoji file content into a base64 encoded string.
  const fileContent = fs.readFileSync(filename, {encoding: 'base64'});

  // Initialize request argument(s)
  const request = {
    custom_emoji: {
      // TODO(developer): Replace EMOJI_NAME here.
      emoji_name: 'EMOJI_NAME',
      payload: {
        file_content: fileContent,
        filename,
      },
    },
  };

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

  // Handle the response
  console.log(response);
}

await main();

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

  • FILENAME : nom de fichier de l'image.
  • EMOJI_NAME : nom unique de votre emoji personnalisé, par exemple :smiley-face:.

L'API Chat renvoie une instance de CustomEmoji qui décrit l'emoji personnalisé créé.