Method: phones.getCapabilities

قابلیت های مربوط به RBM یک کاربر را دریافت کنید.

بار برگشتی مشخص می‌کند که آیا می‌توان با RBM به یک کاربر دسترسی داشت یا خیر، و اگر چنین است، کاربر از کدام ویژگی‌های RBM پشتیبانی می‌کند.

Error Handling: یک خطای 404 NOT_FOUND زمانی برمی گردد که کاربر با RBM در دسترس نباشد. این شامل چند سناریو است: (1) دستگاه کاربر از RCS پشتیبانی نمی‌کند یا RCS غیرفعال است. (2) کاربر در یک شبکه تلفن همراه است که در آن عامل راه اندازی نشده است یا ترافیک RCS در آن فعال نیست. (3) یک عامل راه اندازی نشده قابلیت های کاربری را که آزمایش کننده نیست درخواست می کند.

درخواست HTTP

GET https://rcsbusinessmessaging.googleapis.com/v1/{name=phones/*}/capabilities

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

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

پارامترها
name

string

این فیلد به «phones/{E.164}/capabilities» تبدیل می‌شود، جایی که {E.164} شماره تلفن کاربر در قالب E.164 است. به عنوان مثال، برای کاربری با شماره تلفن ایالات متحده +1-222-333-4444، نقطه پایانی حاصل https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/capabilities است.

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

پارامترها
requestId

string

شناسه منحصر به فرد درخواست، که توسط نماینده اختصاص داده شده است. این باید یک UUID باشد، همانطور که در https://tools.ietf.org/html/rfc4122 تعریف شده است. اگر شناسه درخواست با شناسه ای مطابقت داشته باشد که عامل برای درخواست قبلی استفاده کرده است، پلت فرم RBM درخواست جدید را نادیده می گیرد.

agentId

string

مورد نیاز. شناسه منحصر به فرد عامل.

درخواست بدن

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

بدن پاسخگو

لیست ویژگی های پشتیبانی شده توسط کاربر

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

نمایندگی JSON 
{
  "features": [
    enum (Feature)
  ]
}
فیلدها
features[]

enum ( Feature )

لیست ویژگی های RBM که این دستگاه پشتیبانی می کند.

محدوده مجوز

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

  • https://www.googleapis.com/auth/rcsbusinessmessaging

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

ویژگی

انواع ویژگی های RBM که کاربر پشتیبانی می کند.

Enums
FEATURE_UNSPECIFIED مشخص نشده است.
RICHCARD_STANDALONE کارت های غنی مستقل.
ACTION_CREATE_CALENDAR_EVENT اقدام پیشنهادی برای ایجاد یک رویداد تقویم.
ACTION_DIAL اقدامی پیشنهادی برای شماره گیری شماره.
ACTION_OPEN_URL اقدام پیشنهادی برای باز کردن URL در مرورگر.
ACTION_SHARE_LOCATION اقدام پیشنهادی برای اشتراک‌گذاری مکان.
ACTION_VIEW_LOCATION اقدام پیشنهادی برای مشاهده مکان در یک برنامه نقشه.
ACTION_OPEN_URL_IN_WEBVIEW اقدام پیشنهادی برای باز کردن URL در نمای وب.