إنشاء إيموجي مخصّص

يشرح هذا الدليل كيفية استخدام الـ create method على الـ CustomEmoji resource في Google Chat API لإنشاء إيموجي مخصّص جديد في مؤسسة Google Workspace.

لا تتوفّر رموز الإيموجي المخصّصة إلا لحسابات Google Workspace، ويجب أن يفعِّل المشرف هذه الميزة لمؤسستك. لمزيد من المعلومات، يُرجى الاطّلاع على التعرّف على رموز الإيموجي المخصّصة في Google Chat و إدارة أذونات رموز الإيموجي المخصّصة.

المتطلبات الأساسية

Node.js

إنشاء إيموجي مخصّص

لإنشاء إيموجي مخصّص باستخدام مصادقة المستخدم، مرِّر ما يلي في طلبك:

  • حدِّد نطاق التفويض chat.customemojis.
  • استدعِ طريقة CreateCustomEmoji.
  • في نص الطلب، قدِّم مصدر CustomEmoji، مع ضبط emojiName (معرّف فريد تختاره للإيموجي) وpayload (محتوى الصورة الذي تختاره للإيموجي).

ينشئ المثال التالي إيموجي مخصّصًا:

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

لتشغيل هذا النموذج، استبدِل ما يلي:

  • FILENAME: اسم ملف الصورة
  • EMOJI_NAME: اسم فريد للإيموجي المخصّص، مثل :smiley-face:

تعرض Chat API نموذجًا من CustomEmoji يوضّح الإيموجي المخصّص الذي تم إنشاؤه.