Method: phones.testers.create

تدعو هذه الطريقة مستخدمًا لاختبار وكيل.

يجب أن يكون المستخدم المدعو مفعّلاً لخدمات RCS ويمكن الوصول إليه من خلال منصة RBM. عندما يدعو وكيل مستخدمًا ليصبح مختبِرًا، يرسل وكيل إدارة منصة RBM رسالة إلى المستخدم يطلب منه فيها تأكيد رغبته في اختبار الوكيل. بعد أن يؤكّد المستخدم ذلك، يصبح من المختبِرين.

لا يمكن للوكيل الذي لم يتم إطلاقه بعد التفاعل إلا مع المستخدمين الذين يختبرون هذا الوكيل. إذا حاول وكيل غير مُطلق إرسال رسالة أو حدث أو معاودة الاتصال بشأن إمكانية إلى مستخدم غير مختبِر، ستعرض منصة RBM الخطأ 403 PERMISSION_DENIED.

يمكن للوكيل إرسال 20 طلبًا للمختبِرين كل يوم، وبإجمالي 200 طلب كحد أقصى. في حال إرسال طلبات إلى المختبِرين تتجاوز هذه الحدود، ستعرض منصة RBM الردّ 429 RESOURCE_EXHAUSTED.

طلب HTTP

POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/testers

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

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

المعلمات
parent

string

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

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

المعلمات
agentId

string

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

نص الطلب

يحتوي نص الطلب على مثال Tester.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال تم إنشاؤه حديثًا Tester.

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

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

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

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