يشرح هذا الدليل كيفية استخدام طريقة
get
في المورد
CustomEmoji
ضِمن Google Chat API للحصول على تفاصيل حول إيموجي مخصّص.
لا تتوفّر الرموز التعبيرية المخصّصة إلا لحسابات Google Workspace، ويجب أن يفعِّلها المشرف لمؤسستك. لمزيد من المعلومات، يُرجى الاطّلاع على المقالتَين التعرّف على رموز الإيموجي المخصّصة في Google Chat وإدارة أذونات رموز الإيموجي المخصّصة.
المتطلبات الأساسية
Node.js
- حساب Google Workspace Business أو Enterprise مع إمكانية الوصول إلى Google Chat
- إعداد البيئة:
- أنشئ مشروعًا على Google Cloud.
- ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
- فعِّل واجهة Google Chat API وأعِدّها باستخدام اسم ورمز ووصف لتطبيق Chat.
- ثبِّت مكتبة برامج Cloud Client Library لنظام Node.js.
- أنشئ بيانات اعتماد الوصول استنادًا إلى الطريقة التي تريد استخدامها للمصادقة في طلب Google Chat API:
- لإجراء المصادقة كمستخدم في Chat،
أنشئ بيانات اعتماد معرّف عميل OAuthواحفظها كملف JSON باسم
credentials.json
في الدليل المحلي. - لإجراء المصادقة بصفتك تطبيق Chat،
أنشئ بيانات اعتماد
لحساب الخدمة واحفظها كملف JSON باسم
credentials.json
.
- لإجراء المصادقة كمستخدم في Chat،
أنشئ بيانات اعتماد معرّف عميل OAuthواحفظها كملف JSON باسم
- اختَر نطاق تفويض استنادًا إلى ما إذا كنت تريد المصادقة كمستخدم أو كتطبيق Chat.
الحصول على تفاصيل حول رمز إيموجي مخصّص
للحصول على تفاصيل حول رمز تعبيري مخصّص يتضمّن مصادقة المستخدم، أدرِج ما يلي في طلبك:
- حدِّد
chat.customemojis
نطاق التفويض. - استدعِ الطريقة
GetCustomEmoji
. - في نص الطلب، اضبط
name
على اسم مورد رمز الإيموجي المخصّص المطلوب الحصول عليه.
يحصل المثال التالي على تفاصيل رمز إيموجي مخصّص.
Node.js
لتشغيل هذا النموذج، استبدِل ما يلي:
EMOJI_NAME
: الاسم الفريد لرمز الإيموجي المخصّص، في الحقلemoji_name
يمكنك الحصول على المعرّف من خلال استدعاء الطريقةListCustomEmoji()
، أو من نص الاستجابة الذي يتم عرضه بعد إنشاء رمز تعبيري مخصّص بشكل غير متزامن باستخدام Chat API.