Method: phones.testers.create

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

招待されたユーザーは、RCS が有効になっており、RCS for Business プラットフォームからアクセスできる必要があります。エージェントがユーザーをテスターに招待すると、RCS for Business プラットフォーム管理エージェントからユーザーに、エージェントのテスターになることを確認するメッセージが送信されます。ユーザーが確認すると、テスターになります。

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

エージェントは 1 日あたり 20 件のテスター リクエストを送信でき、テスター リクエストの合計数は最大 200 件です。これらの上限を超えるテスター リクエストを送信すると、RCS for Business プラットフォームから 429 RESOURCE_EXHAUSTED レスポンスが返されます。

非推奨: このメソッドは 2026 年 1 月 31 日に非推奨となります。詳しくは、Business Communications API の新しい Testers メソッドをご覧ください。

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 Overview をご覧ください。