Method: phones.getCapabilities

الحصول على الإمكانات ذات الصلة بميزة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)" لأحد المستخدمين

تحدِّد حمولة البيانات المعروضة ما إذا كان من الممكن الوصول إلى المستخدم من خلال ميزة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية" (RBM)، وفي هذه الحالة، الميزات التي يتيحها المستخدم. وإذا تعذّر الوصول إلى المستخدم من خلال ميزة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)"، ستعرض منصة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية" (RBM) 404 NOT_FOUND.

لا يمكن للوكيل الذي لم يتم إطلاقه إلا طلب الإمكانيات للمستخدمين الذين يختبرون هذا الوكيل. إذا طلب الوكيل الذي لم يتم إطلاقه إمكانيات غير المختبِر، تعرض منصة RBM دالة 403 PERMISSION_DENIED.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
name

string

يؤدي هذا الحقل إلى "الهواتف/{E.164}/الإمكانات"، حيث يكون {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.

إبراز

أنواع ميزات RBM التي يوفّرها المستخدم

عمليات التعداد
FEATURE_UNSPECIFIED غير محدَّد.
REVOCATION الإبطال: في حال كان المستخدم يتيح الإبطال، يمكن للوكيل إبطال رسالة تم إرسالها قبل تسليم الرسالة بواسطة النظام الأساسي "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)".
RICHCARD_STANDALONE البطاقات التفاعلية المستقلة:
ACTION_CREATE_CALENDAR_EVENT تم اقتراح إجراء لإنشاء حدث في التقويم.
ACTION_DIAL الإجراء المقترح للاتصال برقم.
ACTION_OPEN_URL الإجراء المقترَح لفتح عنوان URL.
ACTION_SHARE_LOCATION إجراء مقترح لمشاركة موقع.
ACTION_VIEW_LOCATION الإجراء المقترح لعرض موقع جغرافي في تطبيق خرائط.