تحديد مستخدمي 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 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، وذلك باستخدام إحدى الطريقتَين التاليتَين: