Benutzerdefiniertes Emoji erstellen

In diesem Leitfaden wird beschrieben, wie Sie mit der Methode create für die Ressource CustomEmoji der Google Chat API ein neues benutzerdefiniertes Emoji in einer Google Workspace-Organisation erstellen.

Benutzerdefinierte Emojis sind nur für Google Workspace-Konten verfügbar und Ihr Administrator muss sie für Ihre Organisation aktivieren. Weitere Informationen finden Sie unter Benutzerdefinierte Emojis in Google Chat und Berechtigungen für benutzerdefinierte Emojis verwalten.

Vorbereitung

Node.js

Benutzerdefiniertes Emoji erstellen

Wenn Sie ein benutzerdefiniertes Emoji mit Nutzerauthentifizierung erstellen möchten, übergeben Sie Folgendes in Ihrer Anfrage:

  • Geben Sie den chat.customemojis-Autorisierungsbereich an.
  • Rufen Sie die Methode CreateCustomEmoji auf.
  • Geben Sie im Anfragetext eine CustomEmoji-Ressource an und legen Sie emojiName (eine eindeutige Kennung, die Sie für das Emoji auswählen) und payload (Bildinhalt, den Sie für das Emoji auswählen) fest.

Im folgenden Beispiel wird ein benutzerdefiniertes Emoji erstellt:

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

Wenn Sie dieses Beispiel ausführen möchten, ersetzen Sie Folgendes:

  • FILENAME: Der Dateiname des Bildes.
  • EMOJI_NAME: Ein eindeutiger Name für Ihr benutzerdefiniertes Emoji, z. B. :smiley-face:.

Die Chat API gibt eine Instanz von CustomEmoji zurück, die das erstellte benutzerdefinierte Emoji beschreibt.