new_releases التعديلات: يمكنك الاطّلاع على
ملاحظات الإصدار للتعرّف على الميزات الجديدة وتحديثات المنتجات.
CapabilityCallbackResponse
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
إمكانية استخدام ميزة "المراسلة الغنية" لدى المستخدم هذا الردّ هو نتيجة طلب capability.requestCapabilityCallback من الوكيل.
يظهر CapabilityCallbackResponse في الحقل "data" الخاص بالكائن "message" الذي يتلقّاه الوكيل من اشتراكه في Google Pub/Sub. الحقل "data" هو سلسلة بترميز base64 يجب أن يفكّ الوكيل ترميزها لتتطابق مع بنية CapabilityCallbackResponse. تم إيقافها نهائيًا: لم يعُد مستخدَمًا.
| تمثيل JSON |
{
"requestId": string,
"phoneNumber": string,
"rbmEnabled": boolean,
"features": [
enum (Feature)
],
"status": {
object (Status)
}
} |
| الحقول |
requestId |
string
المعرّف الفريد العالمي (UUID) الذي يخصّصه الوكيل لطلب capability.requestCapabilityCallback.
|
phoneNumber |
string
رقم هاتف المستخدِم بتنسيق E.164
|
rbmEnabled |
boolean
تُستخدَم لتحديد ما إذا كان بإمكان المستخدم المشاركة في محادثات RBM مع وكلاء الدعم.
|
features[] |
enum (Feature)
قائمة بجميع ميزات "المراسلة الغنية" المتوافقة مع رقم الهاتف هذا
|
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" }
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe CapabilityCallbackResponse indicates a user's RBM capability and is received by agents via a Pub/Sub subscription, base64-encoded in the "data" field of the message object.\u003c/p\u003e\n"],["\u003cp\u003eThis response includes details such as the \u003ccode\u003erequestId\u003c/code\u003e, \u003ccode\u003ephoneNumber\u003c/code\u003e, \u003ccode\u003erbmEnabled\u003c/code\u003e status, and a list of \u003ccode\u003efeatures\u003c/code\u003e supported by the phone number.\u003c/p\u003e\n"],["\u003cp\u003eThe response also contains a \u003ccode\u003estatus\u003c/code\u003e object, which details the response status, and includes error messages if the capability check failed.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eStatus\u003c/code\u003e object adheres to the gRPC logical error model, containing an error \u003ccode\u003ecode\u003c/code\u003e, an error \u003ccode\u003emessage\u003c/code\u003e, and an array of error \u003ccode\u003edetails\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe error details can contain a type identification and specific fields, as well as the actual error messages.\u003c/p\u003e\n"]]],[],null,["# CapabilityCallbackResponse\n\n| This item is deprecated!\nThe RBM capability of a user. This response is the result of a capability.requestCapabilityCallback request from the agent.\n\nThe CapabilityCallbackResponse appears in the \"data\" field of the \"message\" object that the agent receives from its Google Pub/Sub subscription. The \"data\" field is a base64-encoded string that the agent must decode to match the CapabilityCallbackResponse structure. Deprecated: No longer used.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"requestId\": string, \"phoneNumber\": string, \"rbmEnabled\": boolean, \"features\": [ enum (/business-communications/rcs-business-messaging/reference/rest/v1/phones/getCapabilities#Feature) ], \"status\": { object (/business-communications/rcs-business-messaging/reference/rest/v1/CapabilityCallbackResponse#Status) } } ``` |\n\n| Fields ||\n|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requestId` | `string` The UUID assigned by the agent to the capability.requestCapabilityCallback request. |\n| `phoneNumber` | `string` Phone number of the user in E.164 format. |\n| `rbmEnabled` | `boolean` Whether the user is capable of participating in RBM conversations with agents. |\n| `features[]` | `enum (`[Feature](/business-communications/rcs-business-messaging/reference/rest/v1/phones/getCapabilities#Feature)`)` List of all RBM features which are supported for this phone number |\n| `status` | `object (`[Status](/business-communications/rcs-business-messaging/reference/rest/v1/CapabilityCallbackResponse#Status)`)` Status of the response. If the capability check fails, includes error messages. |\n\nStatus\n------\n\nThe `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details.\n\nYou can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------|\n| ``` { \"code\": integer, \"message\": string, \"details\": [ { \"@type\": string, field1: ..., ... } ] } ``` |\n\n| Fields ||\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `code` | `integer` The status code, which should be an enum value of `google.rpc.Code`. |\n| `message` | `string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details](/business-communications/rcs-business-messaging/reference/rest/v1/CapabilityCallbackResponse#Status.FIELDS.details) field, or localized by the client. |\n| `details[]` | `object` A list of messages that carry the error details. There is a common set of message types for APIs to use. An object containing fields of an arbitrary type. An additional field `\"@type\"` contains a URI identifying the type. Example: `{ \"id\": 1234, \"@type\": \"types.example.com/standard/id\" }`. |"]]
