Criar um emoji personalizado

Este guia explica como usar o create método no recurso CustomEmoji da API Google Chat para criar um emoji personalizado em uma organização do Google Workspace.

Os emojis personalizados só estão disponíveis para contas do Google Workspace, e o administrador precisa ativar esse recurso para sua organização. Para mais informações, consulte Saiba mais sobre emojis personalizados no Google Chat e Gerenciar permissões de emojis personalizados.

Pré-requisitos

Node.js

  • Uma conta do Google Workspace Business ou Enterprise com acesso ao Google Chat.

Criar um emoji personalizado

Para criar um emoji personalizado com autenticação do usuário, transmita o seguinte na solicitação:

  • Especifique o escopo de autorização chat.customemojis.
  • Chame o CreateCustomEmoji método.
  • No corpo da solicitação, forneça um recurso CustomEmoji, definindo o emojiName (um identificador exclusivo escolhido para o emoji) e o payload (conteúdo da imagem escolhido para o emoji).

O exemplo a seguir cria um emoji personalizado:

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

Para executar esse exemplo, substitua o seguinte:

  • FILENAME: um nome de arquivo da imagem.
  • EMOJI_NAME: um nome exclusivo para seu emoji personalizado, como :smiley-face:.

A API Chat retorna uma instância de CustomEmoji que detalha o emoji personalizado criado.