يشرح هذا الدليل كيفية استخدام طريقة
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 الخاصة بنظام 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.