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.

الميزة

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

عمليات التعداد
FEATURE_UNSPECIFIED غير محدّد
REVOCATION الإبطال إذا كان المستخدم يسمح بإبطال الرسائل، يمكن للموظف إبطال رسالة أرسلها قبل أن تسلّمها منصة RBM.
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 الإجراء المقترح لإنشاء رسالة نصية/صوتية/فيديو.