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

يشرح هذا الدليل كيفية استخدام طريقة create في مورد CustomEmoji ضمن 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 يتضمّن تفاصيل حول الإيموجي المخصّص الذي تم إنشاؤه.