Method: phones.getCapabilities

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

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

عاملی که راه‌اندازی نشده است فقط می‌تواند قابلیت‌هایی را برای کاربرانی که آزمایش‌کننده آن عامل هستند درخواست کند. اگر یک عامل راه‌اندازی نشده، قابلیت‌های یک غیر آزمایش‌کننده را درخواست کند، پلتفرم RBM 403 PERMISSION_DENIED برمی‌گرداند.

درخواست 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 است.

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

پارامترها
request Id

string

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

agent Id

string

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

درخواست بدن

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

بدن پاسخگو

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

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

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

enum ( Feature )

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

محدوده مجوز

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

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

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

ویژگی

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

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