Method: phones.agentMessages.delete

يؤدي إلى إبطال رسالة الوكيل التي تم إرسالها ولكن لم يتم تسليمها بعد.

إذا أبطل النظام الأساسي "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية" (RBM) رسالة بنجاح، سيتم حذف الرسالة من قائمة انتظار رسائل المستخدم ولن يتم تسليمها مطلقًا.

تعرض هذه الطريقة على الفور 200 OK، سواء تم إبطال الرسالة بنجاح أم لا.

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

طلب 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

مطلوبة. المعرِّف الفريد للوكيل

نص الطلب

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

نص الاستجابة

في حال نجاح هذا الإجراء، يكون نص الاستجابة فارغًا.

نطاقات التفويض

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

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

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.