Method: phones.testers.create

از کاربر دعوت می‌کند تا یک عامل را آزمایش کند.

کاربر دعوت‌شده باید قابلیت RCS داشته باشد و پلتفرم RCS for Business بتواند به او دسترسی داشته باشد. وقتی یک عامل، کاربری را برای آزمایش دعوت می‌کند، عامل مدیریت پلتفرم RCS for Business پیامی به کاربر ارسال می‌کند و از او می‌خواهد که تأیید کند که می‌خواهد آزمایش‌کننده‌ی عامل باشد. پس از تأیید کاربر، او به یک آزمایش‌کننده تبدیل می‌شود.

عاملی که هنوز راه‌اندازی نشده است، فقط می‌تواند با کاربرانی که آزمایش‌کننده‌ی آن عامل هستند، تعامل داشته باشد. اگر عاملی که راه‌اندازی نشده است، سعی کند پیام، رویداد یا فراخوانی قابلیتی را به یک غیر آزمایش‌کننده ارسال کند، پلتفرم RCS برای کسب‌وکار، خطای 403 PERMISSION_DENIED را برمی‌گرداند.

یک عامل می‌تواند هر روز 20 درخواست تستر ارسال کند، که در مجموع حداکثر 200 درخواست تستر می‌شود. اگر درخواست‌های تستر را بیشتر از این محدودیت‌ها ارسال کنید، پلتفرم RCS for Business پاسخ 429 RESOURCE_EXHAUSTED را برمی‌گرداند.

منسوخ شده: این روش در تاریخ ۳۱ ژانویه ۲۰۲۶ منسوخ خواهد شد. لطفاً برای اطلاعات بیشتر به روش جدید Testers در Business Communications API مراجعه کنید.

درخواست HTTP

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

این URL از سینتکس Transcoding در 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 .