Creare un'emoji personalizzata

Questa guida spiega come utilizzare il metodo create nella 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 il tuo amministratore deve attivarle per la tua organizzazione. Per ulteriori informazioni, vedi Informazioni sulle emoji personalizzate in Google Chat e Gestire le autorizzazioni per le emoji personalizzate.

Prerequisiti

Node.js

Creare un'emoji personalizzata

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

  • Specifica l'ambito di autorizzazione chat.customemojis.
  • Chiama il metodo CreateCustomEmoji.
  • 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 {createClientWithUserCredentials} from './authentication-utils.js';
import fs from 'fs';

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 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: filename,
      }
    }
  };

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

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

main().catch(console.error);

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 in dettaglio l'emoji personalizzata creata.