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

توضِّح هذه الصفحة الطرق التي يمكن بها لتطبيقات Google Chat التعرّف على مستخدمي Chat أو تحديدهم.

لتنفيذ أيّ من الإجراءات التالية، يجب أن يحدّد تطبيق Chat مستخدمًا:

كيفية تحديد Chat لهوية المستخدمين

تُنشئ Google Chat API User موردًا لكل مستخدم يستخدم Chat. في ما يلي حقلَان مهمَّان User:

  • name هو اسم المورد للمورد، بتنسيق users/{user}، حيث يمثّل {user} معرّفًا فريدًا وثابتًا. يمكن استخدام users/app كاسم بدل لتطبيق Chat المخصّص للمكالمات.
  • type هو نوع المستخدم. يُعلم هذا النوع 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: على سبيل المثال، representusers/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، باستخدام أيّ مما يلي: