Method: phones.testers.create

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

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

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

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

تم إيقافها نهائيًا: سيتم إيقاف هذه الطريقة نهائيًا في 31 يناير 2026. يُرجى الاطّلاع على طريقة "المختبِرون" الجديدة في Business Communications API لمزيد من المعلومات.

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