Method: phones.getCapabilities

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

تحدِّد الحمولة المُرسَلة ما إذا كان يمكن الوصول إلى المستخدِم باستخدام نموذج RBM، وإذا كان الأمر كذلك، تحدِّد الميزات التي يتيحها المستخدِم في نموذج RBM. إذا تعذّر الوصول إلى المستخدم باستخدام RBM، تعرض منصة RBM القيمة 404 NOT_FOUND.

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

طلب 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.

الميزة

أنواع ميزات "حملات الأداء الأفضل" التي يتيحها المستخدم

عمليات التعداد
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 في webview
ACTION_COMPOSE إجراء مقترَح لإنشاء رسالة نصية/صوتية/فيديو