Method: spaces.findDirectMessage

پیام مستقیم موجود با کاربر مشخص شده را برمی گرداند. اگر فضای پیام مستقیم پیدا نشد، خطای 404 NOT_FOUND را برمی‌گرداند. برای مثال، به یافتن یک پیام مستقیم مراجعه کنید.

با احراز هویت برنامه ، فضای پیام مستقیم بین کاربر مشخص شده و برنامه چت در حال تماس را برمی‌گرداند.

با احراز هویت کاربر ، فضای پیام مستقیم بین کاربر مشخص شده و کاربر احراز هویت شده را برمی گرداند.

از انواع احراز هویت زیر پشتیبانی می کند:

درخواست HTTP

GET https://chat.googleapis.com/v1/spaces:findDirectMessage

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای پرس و جو

پارامترها
name

string

مورد نیاز. نام منبع کاربر برای یافتن پیام مستقیم با.

قالب: users/{user} ، که در آن {user} یا id شخص از People API یا id کاربر در Directory API است. برای مثال، اگر شناسه نمایه People API 123456789 باشد، می‌توانید با استفاده از users/123456789 به عنوان name ، پیام مستقیمی با آن شخص پیدا کنید. وقتی به عنوان کاربر احراز هویت می‌شوید ، می‌توانید از ایمیل به عنوان نام مستعار برای {user} استفاده کنید. به عنوان مثال، users/example@gmail.com که در آن example@gmail.com ایمیل کاربر چت Google است.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Space است.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.bot

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.