Method: phones.getCapabilities

الحصول على إمكانات المستخدم المتعلّقة بخدمة "المراسلة التفاعلية"

تحدّد الحمولة التي يتم إرجاعها ما إذا كان يمكن التواصل مع المستخدم من خلال RBM، وفي حال كان ذلك ممكنًا، تحدّد ميزات RBM التي يتيحها المستخدم.

التعامل مع الأخطاء: يتم عرض الخطأ 404 NOT_FOUND عندما يتعذّر الوصول إلى المستخدم باستخدام RBM. ويشمل ذلك سيناريوهات متعددة: (1) لا يتوافق جهاز المستخدم مع خدمات RCS أو تم إيقافها. (2) يكون المستخدم على شبكة جوّالة لا يتم فيها تشغيل الوكيل أو لا يتم فيها تفعيل زيارات RCS. (3) يطلب وكيل غير مُطلق إمكانات مستخدم ليس من المختبِرين.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل الترميز 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. إذا كان رقم تعريف الطلب مطابقًا لرقم تعريف استخدمه الموظف لطلب سابق، تتجاهل منصة RBM الطلب الجديد.
agentId

string

مطلوب. المعرّف الفريد للوكيل.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

قائمة بالميزات التي يمكن للمستخدم الاستفادة منها

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "features": [
    enum (Feature)
  ]
}
الحقول
features[]

enum (Feature)

قائمة بميزات "المراسلة الغنية" التي يتيحها هذا الجهاز

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

الميزة

أنواع ميزات RBM التي يتيحها المستخدم

عمليات التعداد
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 في طريقة عرض الويب