Method: phones.testers.create

エージェントをテストするようにユーザーを招待します。

招待ユーザーは RCS が有効で、RBM プラットフォームから到達可能である必要があります。エージェントがユーザーをテスターに招待すると、RBM プラットフォーム管理エージェントは、エージェントのテスターになることの確認をユーザーに求めるメッセージを送信します。確認すると、ユーザーはテスターになります。

まだ起動していないエージェントは、そのエージェントのテスターであるユーザーとのみやり取りできます。起動されていないエージェントが非テスターにメッセージ、イベント、または機能のコールバックを送信しようとすると、RBM プラットフォームは 403 PERMISSION_DENIED エラーを返します。

エージェントは、1 日に 20 件のテスター リクエストを送信できます(合計最大 200 件のテスター リクエストを送信できます)。これらの上限を超えるテスター リクエストを送信すると、RBM プラットフォームは 429 RESOURCE_EXHAUSTED レスポンスを返します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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 の概要をご覧ください。