تحديد مستخدمي Google Chat وتحديدهم

توضّح هذه الصفحة الطرق التي يمكن لتطبيقات Google 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، مثل 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 مورد، باستخدام أي من التالي: