دریافت قابلیتهای مرتبط با «سرویسهای ارتباطی غنی ویژه کسبوکارها» برای کاربر.
بار داده برگرداندهشده مشخص میکند که آیا میتوان با ‹RCS ویژه «کسبوکارها»› به کاربر دسترسی پیدا کرد یا نه و اگر بله، کاربر از کدام ویژگیهای ‹RCS ویژه «کسبوکارها»› پشتیبانی میکند.
رسیدگی به خطا: وقتی کاربر با «RCS ویژه کسبوکارها» قابلدسترسی نباشد، خطای 404 NOT_FOUND برگردانده میشود. این شامل چندین سناریو میشود: (۱) دستگاه کاربر از RCS پشتیبانی نمیکند یا RCS در آن غیرفعال است. (۲) کاربر در شبکه تلفن همراهی باشد که عامل در آن راهاندازی نشده است یا ترافیک «سرویسهای ارتباطی غنی» در آن فعال نیست. (۳) نمایندهای که راهاندازی نشده است قابلیتهای کاربری را درخواست میکند که آزمایشکننده نیست.
درخواست HTTP
GET https://rcsbusinessmessaging.googleapis.com/v1/{name=phones/*}/capabilities
نشانی وب از نحو تراتبدیل gRPC استفاده میکند.
پارامترهای مسیر
| پارامترها | |
|---|---|
name |
این فیلد به «phones/{E.164}/capabilities» تبدیل میشود که در آن {E.164} شماره تلفن کاربر در قالب E.164 است. برای مثال، برای کاربری با شماره تلفن ایالات متحده +1-222-333-4444، نقطه پایانی حاصل https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/capabilities است. |
پارامترهای پُرسمان
| پارامترها | |
|---|---|
requestId |
شناسه یکتای درخواست که توسط نماینده اختصاص داده شده است. این باید UUID باشد، همانطور که در https://www.rfc-editor.org/info/rfc9562 تعریف شده است. اگر شناسه درخواست با شناسهای که نماینده برای درخواست قبلی استفاده کرده است مطابقت داشته باشد، پلاتفرم «RCS ویژه کسبوکارها» درخواست جدید را نادیده میگیرد. |
agentId |
الزامی. شناسه یکتای نماینده. |
متن درخواست
بدنه درخواست باید خالی باشد.
بدنه پاسخ
فهرست ویژگیهای پشتیبانیشده توسط کاربر.
اگر موفقیتآمیز باشد، بدنه پاسخ حاوی دادههایی با ساختار زیر است:
| نمایش JSON |
|---|
{
"features": [
enum ( |
| فیلدها | |
|---|---|
features[] |
فهرست ویژگیهای «RCS ویژه کسبوکارها» که این دستگاه پشتیبانی میکند. |
carrier |
فقط خروجی. اطلاعات شرکت مخابراتی که شماره تلفن کاربر به آن تعلق دارد، طبق باطنهای Google RCS. درحالحاضر، این فیلد فقط برای شماره تلفنهای ایالات متحده پر میشود. |
دامنههای مجوز
به گستره OAuth زیر نیاز دارد:
https://www.googleapis.com/auth/rcsbusinessmessaging
برای اطلاعات بیشتر، به OAuth 2.0 Overview مراجعه کنید.
ویژگی
انواع ویژگیهای ‹RCS ویژه «کسبوکارها»› که کاربر از آنها پشتیبانی میکند.
| شمارشیها | |
|---|---|
FEATURE_UNSPECIFIED |
مشخص نشده است. |
RICHCARD_STANDALONE |
کارتهای غنی مستقل. |
RICHCARD_CAROUSEL |
گردونه کارتهای غنی. |
ACTION_CREATE_CALENDAR_EVENT |
کنش پیشنهادی برای ایجاد رویداد تقویم. |
ACTION_DIAL |
کنش پیشنهادی برای شمارهگیری. |
ACTION_OPEN_URL |
اقدام پیشنهادی برای باز کردن نشانی وب در مرورگر. |
ACTION_SHARE_LOCATION |
کنش پیشنهادی برای همرسانی مکان. |
ACTION_VIEW_LOCATION |
کنش پیشنهادی برای مشاهده مکان در برنامه نقشه. |
ACTION_OPEN_URL_IN_WEBVIEW |
کنش پیشنهادی برای باز کردن نشانی وب در وبنما. |