Method: phones.getCapabilities

الحصول على إذن الوصول إلى ميزات "خدمات الاتصالات التفاعلية (RCS) للمؤسسات" الخاصة بمستخدم

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

التعامل مع الأخطاء: يتم عرض الخطأ 404 NOT_FOUND عندما يتعذّر الوصول إلى المستخدم من خلال "خدمات الاتصالات التفاعلية (RCS) للأنشطة التجارية". ويشمل ذلك سيناريوهات متعددة: (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. إذا كان رقم تعريف الطلب يتطابق مع رقم تعريف استخدمه الموظف لطلب سابق، تتجاهل منصة "خدمات RCS للأنشطة التجارية" الطلب الجديد.
agentId

string

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

نص الطلب

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

نص الاستجابة

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

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

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

enum (Feature)

قائمة بميزات "خدمات الاتصالات التفاعلية للأنشطة التجارية" التي يتوافق معها هذا الجهاز
carrier

string

النتائج فقط. معلومات مشغّل شبكة الجوّال التي ينتمي إليها رقم هاتف المستخدم، وفقًا لأنظمة Google الخلفية لخدمات الاتصالات التفاعلية في الوقت الحالي، تتم تعبئة هذا الحقل فقط لأرقام الهواتف في الولايات المتحدة.

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

يجب توفير نطاق 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 في "عرض الويب"