توضّح هذه الصفحة الطرق التي يمكن لتطبيقات Google Chat من خلالها التعرّف على الأخطاء أو تحديدها مستخدمو Chat
لتنفيذ أي مما يلي، يجب أن يكون تطبيق Chat يجب أن يحدد مستخدم:
- إنشاء رسالة تشير الرمز@ إلى مستخدم.
- دعوة مستخدم أو إضافته إلى المساحة الحالية أو إضافة مستخدم إلى مساحة جديدة.
- العثور على الرسائل المباشرة بين تطبيق Chat ومستخدم محدّد بين مستخدمين اثنين.
- الحصول على تفاصيل عضوية المستخدم في مساحة
- أرسِل رسالة خاصة إلى مستخدم.
- الاشتراك في قناة مستخدم باستخدام واجهة برمجة التطبيقات Google Workspace Events API للاطّلاع على الأحداث المتعلقة بتغييرات الاشتراك.
كيفية تحديد Chat للمستخدمين
تُنشئ Google Chat API
مرجع User
لكل شخص يستخدم Chat. فيما يلي اثنان مهمان
حقلان (User
):
name
هو اسم المورد، والمنسق على النحو التاليusers/{user}
، حيث تمثل{user}
معرِّفًا فريدًا وثابتًا. يمكن لـusers/app
استخدامها اسمًا مستعارًا لتطبيق Chat للاتصال.type
هو نوع المستخدم. وهذا النوع يخبر Chat ما إذا كانت المستخدم هو تطبيق في Chat أو شخص. بالنسبة تطبيقات Chat، القيمة هيBOT
. بالنسبة للأشخاص، القيمة هيHUMAN
تحديد مستخدم في استدعاء لواجهة Google Chat API
لتحديد مستخدم، استخدِم القيم التالية لقيمة {user}
:
للمستخدمين في مؤسستك على Google Workspace، استخدِم أحد النُهُج التالية:
name
منUser
مورد في واجهة برمجة تطبيقات Chat، مثلusers/123456789
.- يشير العمود
{person_id}
إلى اسمPerson
مورد في People API حيث تكون قيمةresourceName
هيpeople/{person_id}
—على سبيل المثال، "users/123456789
" في Chat API يمثّل المستخدم نفسه. باسمpeople/123456789
في واجهة برمجة تطبيقات "الأشخاص". id
لموردUser
في Directory API، على سبيل المثال، يشيرusers/123456789
في Chat API إلى المستخدم نفسه. بتنسيقusers/123456789
في واجهة برمجة التطبيقات للدليل.
لمستخدم في مؤسسة Google Workspace خارجية أو مستخدم يستخدم حساب Google أو عنوان البريد الإلكتروني البديل، على سبيل المثال،
users/EMAIL_USERNAME@WORKSPACE_DOMAIN.com
أوusers/EMAIL_USERNAME@gmail.com
.
تحديد مستخدم من حدث تفاعل
في كل مرة يتفاعل فيها مستخدم مع تطبيق Chat، يرسل Chat حدث تفاعل مع معلومات عن التفاعل والمستخدم. على سبيل المثال، عندما يشير المستخدم إلى تطبيق Chat في رسالة يتلقّى تطبيق Chat معلومات حول التفاعل بما في ذلك ما تتضمنه الرسالة ومن أرسلها. تطبيقات Chat الإشارة إلى المستخدمين عند استرداد المعلومات حول موارد Chat.
لتحديد المستخدم الذي تفاعل مع تطبيق Chat،
الحصول على قيمة السمة name
في
User
مورد،
والذي يمكنك الحصول عليه من
Event.user.name
يعرض مثال JSON التالي التنسيق المتوقع لهوية المستخدم في التفاعل مع تطبيق Chat:
{
...,
"user": {
"name": "users/12345678901234567890",
"displayName": "Sasha",
"avatarUrl": "https://lh3.googleusercontent.com/.../photo.jpg",
"email": "sasha@example.com"
}
}
الرسالة هي نوع محدّد من التفاعل. لتحديد هوية مستخدم أرسل
رسالة إلى تطبيق Chat
الحصول على قيمة السمة name
في
User
مورد، باستخدام أي من
التالي: