Creare un'emoji personalizzata

Questa guida spiega come utilizzare il create metodo sulla risorsa CustomEmoji dell'API Google Chat per creare una nuova emoji personalizzata in un'organizzazione Google Workspace.

Le emoji personalizzate sono disponibili solo per gli account Google Workspace e l'amministratore deve attivarle per la tua organizzazione. Per ulteriori informazioni, consulta Informazioni sulle emoji personalizzate in Google Chat e Gestire le autorizzazioni per le emoji personalizzate.

Prerequisiti

Node.js

Crea un'emoji personalizzata

Per creare un'emoji personalizzata con l'autenticazione utente, trasmetti quanto segue nella richiesta:

  • Specifica l'ambito di autorizzazione chat.customemojis.
  • Chiama il CreateCustomEmoji metodo.
  • Nel corpo della richiesta, fornisci una risorsa CustomEmoji, impostando emojiName (un identificatore univoco che scegli per l'emoji) e payload (il contenuto dell'immagine che scegli per l'emoji).

L'esempio seguente crea un'emoji personalizzata:

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

Per eseguire questo esempio, sostituisci quanto segue:

  • FILENAME: il nome file dell'immagine.
  • EMOJI_NAME: un nome univoco per l'emoji personalizzata, ad esempio :smiley-face:.

L'API Chat restituisce un'istanza di CustomEmoji che descrive l'emoji personalizzata creata.