CapabilityCallbackResponse

قدرة المستخدِم على استخدام ميزة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)" يأتي هذا الردّ نتيجة طلب client.requestCapabilityCallback المقدَّم من الوكيل.

يظهر CapabilityCallbackResponse في حقل "البيانات" ضمن عنصر "الرسالة" الذي يتلقّاه الوكيل من اشتراكه في خدمة Google Cloud Pub/Sub. حقل "البيانات" هو سلسلة بترميز base64 يجب أن يفك ترميزها الوكيل ليطابق بنية CapabilityCallbackResponse.

تمثيل JSON
{
  "requestId": string,
  "phoneNumber": string,
  "rbmEnabled": boolean,
  "features": [
    enum (Feature)
  ],
  "status": {
    object (Status)
  }
}
الحقول
requestId

string

رقم التعريف الفريد العالمي (UUID) الذي خصّصه الوكيل لطلب intent.requestCapabilityCallback.

phoneNumber

string

رقم هاتف المستخدم بالتنسيق E.164

rbmEnabled

boolean

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

features[]

enum (Feature)

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

status

object (Status)

حالة الردّ وفي حال تعذّر التحقّق من الإمكانية، سيتم تضمين رسائل الخطأ.

الحالة

يحدد النوع Status نموذج خطأ منطقي مناسب لبيئات البرمجة المختلفة، بما في ذلك واجهات برمجة تطبيقات REST وواجهات برمجة التطبيقات RPC. ويتم استخدامه من قِبل gRPC. تحتوي كل رسالة Status على ثلاث أجزاء من البيانات: رمز الخطأ ورسالة الخطأ وتفاصيل الخطأ.

يمكنك معرفة المزيد حول نموذج الخطأ هذا وكيفية التعامل معه في دليل تصميم واجهة برمجة التطبيقات.

تمثيل JSON
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
الحقول
code

integer

رمز الحالة، الذي يجب أن يكون قيمة تعداد google.rpc.Code

message

string

رسالة خطأ موجّهة للمطوّر، ويجب أن تكون باللغة الإنجليزية. يجب ترجمة أي رسالة خطأ تظهر للمستخدمين وإرسالها في حقل google.rpc.Status.details أو ترجمتها من خلال البرنامج.

details[]

object

قائمة بالرسائل التي تتضمن تفاصيل الخطأ. هناك مجموعة شائعة من أنواع الرسائل التي يمكن أن تستخدمها واجهات برمجة التطبيقات.

كائن يحتوي على حقول من نوع عشوائي. يحتوي الحقل الإضافي "@type" على معرّف موارد منتظم (URI) يحدّد النوع. مثال: { "id": 1234, "@type": "types.example.com/standard/id" }