Method: phones.agentMessages.delete

تلغي هذه الطريقة رسالة من وكيل تم إرسالها ولكن لم يتم تسليمها بعد.

إذا ألغى نظام RCS for Business الأساسي رسالة بنجاح، سيتم حذف الرسالة من قائمة انتظار الرسائل لدى المستخدم ولن يتم تسليمها أبدًا (200 OK).

تعني الاستجابة 404 Not Found أنّ محاولة الإبطال قد فشلت لأنّه تم تسليم الرسالة.

هناك احتمال صغير بأن يبدأ الوكيل عملية الإبطال أثناء معالجة منصة "خدمات الاتصالات التفاعلية (RCS) للمؤسسات" لعملية تسليم الرسالة. في هذه الحالات النادرة، يتلقّى الموظف حدث مستخدم DELIVERED للرسالة بعد فترة قصيرة من بدء طلب الإبطال.

طلب HTTP

DELETE https://rcsbusinessmessaging.googleapis.com/v1/{name=phones/*/agentMessages/*}

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
name

string

"phones/{E.164}/agentMessages/{messageId}"، حيث {E.164} هو رقم هاتف المستخدم بتنسيق E.164 و{messageId} هو المعرّف الذي يحدّده الموظف لرسالة الموظف التي يجب إبطالها. على سبيل المثال، مع رقم الهاتف الأمريكي ‎+1-222-333-4444 ورسالة وكيل تحمل المعرّف "12345xyz"، ستكون نقطة النهاية الناتجة هي https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages/12345xyz.

مَعلمات طلب البحث

المعلمات
agentId

string

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

نص الطلب

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

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيكون نص الاستجابة عبارة عن كائن JSON فارغ.

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

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/rcsbusinessmessaging

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.