Method: phones.getCapabilities

دریافت قابلیت‌های مرتبط با «سرویس‌های ارتباطی غنی ویژه کسب‌وکارها» برای کاربر.

بار داده برگردانده‌شده مشخص می‌کند که آیا می‌توان با ‹RCS ویژه «کسب‌وکارها»› به کاربر دسترسی پیدا کرد یا نه و اگر بله، کاربر از کدام ویژگی‌های ‹RCS ویژه «کسب‌وکارها»› پشتیبانی می‌کند.

رسیدگی به خطا: وقتی کاربر با «RCS ویژه کسب‌وکارها» قابل‌دسترسی نباشد، خطای 404 NOT_FOUND برگردانده می‌شود. این شامل چندین سناریو می‌شود: (۱) دستگاه کاربر از RCS پشتیبانی نمی‌کند یا RCS در آن غیرفعال است. (۲) کاربر در شبکه تلفن همراهی باشد که عامل در آن راه‌اندازی نشده است یا ترافیک «سرویس‌های ارتباطی غنی» در آن فعال نیست. (۳) نماینده‌ای که راه‌اندازی نشده است قابلیت‌های کاربری را درخواست می‌کند که آزمایش‌کننده نیست.

درخواست HTTP

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

نشانی وب از نحو تراتبدیل gRPC استفاده می‌کند.

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

پارامترها
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://www.rfc-editor.org/info/rfc9562 تعریف شده است. اگر شناسه درخواست با شناسه‌ای که نماینده برای درخواست قبلی استفاده کرده است مطابقت داشته باشد، پلاتفرم «RCS ویژه کسب‌وکارها» درخواست جدید را نادیده می‌گیرد.

agentId

string

الزامی. شناسه یکتای نماینده.

متن درخواست

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

بدنه پاسخ

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

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

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

enum (Feature)

فهرست ویژگی‌های «RCS ویژه کسب‌وکارها» که این دستگاه پشتیبانی می‌کند.

carrier

string

فقط خروجی. اطلاعات شرکت مخابراتی که شماره تلفن کاربر به آن تعلق دارد، طبق باطن‌های Google RCS. درحال‌حاضر، این فیلد فقط برای شماره تلفن‌های ایالات متحده پر می‌شود.

دامنه‌های مجوز

به گستره OAuth زیر نیاز دارد:

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

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

ویژگی

انواع ویژگی‌های ‹RCS ویژه «کسب‌وکارها»› که کاربر از آن‌ها پشتیبانی می‌کند.

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