Benutzerdefiniertes Emoji erstellen

In diesem Leitfaden wird erläutert, wie Sie mit der create Methode für die CustomEmoji Ressource 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. Ihr Administrator muss benutzerdefinierte Emojis 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 Autorisierungsbereich chat.customemojis an.
  • Rufen Sie die CreateCustomEmoji Methode auf.
  • Geben Sie im Anfragetext eine CustomEmoji-Ressource an und legen Sie emojiName (eine eindeutige ID, 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();

Ersetzen Sie die folgenden Platzhalter, um dieses Beispiel auszuführen:

  • FILENAME: Ein 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.