Method: phones.getCapabilities

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

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

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

درخواست HTTP

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

این URL از سینتکس Transcoding در 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://tools.ietf.org/html/rfc4122 تعریف شده است. اگر شناسه درخواست با شناسه‌ای که عامل برای درخواست قبلی استفاده کرده است مطابقت داشته باشد، پلتفرم RCS for Business درخواست جدید را نادیده می‌گیرد.

agentId

string

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

درخواست بدنه

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

بدنه پاسخ

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

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

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

enum ( Feature )

فهرست ویژگی‌های 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 اقدام پیشنهادی برای باز کردن یک URL در مرورگر.
ACTION_SHARE_LOCATION اقدام پیشنهادی برای اشتراک‌گذاری یک مکان.
ACTION_VIEW_LOCATION اقدام پیشنهادی برای مشاهده یک مکان در برنامه نقشه.
ACTION_OPEN_URL_IN_WEBVIEW اقدام پیشنهادی برای باز کردن یک URL در وب‌ویو.