کاربران چت گوگل را شناسایی و مشخص کنید

این صفحه روش‌هایی را توضیح می‌دهد که برنامه‌های چت Google می‌توانند کاربران چت را شناسایی یا مشخص کنند.

برای انجام هر یک از موارد زیر، یک برنامه چت باید یک کاربر را مشخص کند:

چت چگونه کاربران را شناسایی می کند

Google Chat API یک منبع User برای هر شخصی که از Chat استفاده می کند ایجاد می کند. دو فیلد User مهم زیر هستند:

  • name نام منبع منبع است که به صورت users/{user} قالب بندی شده است، که در آن {user} یک شناسه منحصر به فرد و پایدار را نشان می دهد. users/app می توان به عنوان نام مستعار برای برنامه چت تماس گیرنده استفاده کرد.
  • type نوع کاربر است. این نوع به 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 یک رویداد تعاملی با اطلاعاتی درباره تعامل و کاربر ارسال می کند. به عنوان مثال، هنگامی که کاربری از یک برنامه چت در پیامی نام می برد، برنامه چت اطلاعاتی در مورد این تعامل دریافت می کند، از جمله اینکه پیام چه می گوید و چه کسی آن را ارسال کرده است. برنامه‌های چت هنگام بازیابی اطلاعات مربوط به منابع چت به کاربران ارجاع می‌دهند.

برای شناسایی کاربری که با یک برنامه چت تعامل داشته است، مقدار ویژگی name را در منبع User دریافت کنید، که می توانید از Event.user.name دریافت کنید.

مثال JSON زیر قالب مورد انتظار هویت کاربر را در تعامل با یک برنامه چت نشان می دهد:

{
  ...,
  "user": {
    "name": "users/12345678901234567890",
    "displayName": "Sasha",
    "avatarUrl": "https://lh3.googleusercontent.com/.../photo.jpg",
    "email": "sasha@example.com"
  }
}

پیام نوع خاصی از تعامل است. برای شناسایی کاربری که پیامی به برنامه چت ارسال کرده است، با استفاده از یکی از موارد زیر، مقدار ویژگی name را در منبع User دریافت کنید: