توضّح هذه الصفحة الطرق التي يمكن لتطبيقات Google Chat من خلالها تحديد مستخدمي Chat أو تحديدهم.
لإجراء أي مما يلي، يجب أن يحدّد تطبيق Chat مستخدمًا:
- أنشئ رسالة تشير إلى مستخدم باستخدام علامة@.
- يمكنك دعوة مستخدم أو إضافته إلى مساحة حالية، أو إضافة مستخدم إلى مساحة جديدة.
- البحث عن الرسائل المباشرة بين تطبيق Chat ومستخدم محدّد أو بين مستخدمَين
- الحصول على تفاصيل عضوية المستخدم في مساحة
- إرسال رسالة خاصة إلى مستخدم
كيفية تحديد 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 API، مثلusers/123456789
.- تمثّل هذه السمة
{person_id}
لاسم موردPerson
في People API، حيث تكون قيمةresourceName
هيpeople/{person_id}
. على سبيل المثال، تمثّلusers/123456789
في Chat API المستخدم نفسه الذي يمثّلpeople/123456789
في People API. id
لموردUser
في Directory API، على سبيل المثال، يمثّلusers/123456789
في Chat API الشخص نفسه الذي يظهر باسمusers/123456789
في Directory API.
بالنسبة إلى مستخدم في مؤسسة 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
، وذلك باستخدام إحدى الطريقتَين التاليتَين: