new_releases 更新：查看
版本資訊瞭解新功能和產品更新。
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
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 |
parent |
string
「phones/{E.164}」，其中 {E.164} 是使用者的電話號碼 (採用 E.164 格式)。舉例來說，如果使用美國電話號碼「+1-222-333-4444」，產生的端點會是 https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/testers/。
|
查詢參數
| 參數 |
agentId |
string
必要欄位。代理程式的專屬 ID。
|
回應主體
如果成功，回應主體會包含新建立的 Tester 例項。
授權範圍
需要下列 OAuth 範圍：
https://www.googleapis.com/auth/rcsbusinessmessaging
詳情請參閱 OAuth 2.0 Overview。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-25 (世界標準時間)。
[null,null,["上次更新時間：2025-07-25 (世界標準時間)。"],[[["\u003cp\u003eUsers can be invited to test an agent, but they must be RCS-enabled and reachable by the RBM platform, and they must also confirm their desire to be a tester.\u003c/p\u003e\n"],["\u003cp\u003eUnlaunched agents can only interact with users who have been confirmed as testers, otherwise a \u003ccode\u003e403 PERMISSION_DENIED\u003c/code\u003e error will occur.\u003c/p\u003e\n"],["\u003cp\u003eAn agent is restricted to sending only 20 tester requests per day, with a maximum of 200 tester requests total, exceeding these limits results in a \u003ccode\u003e429 RESOURCE_EXHAUSTED\u003c/code\u003e error.\u003c/p\u003e\n"],["\u003cp\u003eThe URL endpoint for sending a request to invite a tester follows the format \u003ccode\u003ePOST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/testers\u003c/code\u003e where the phone number of the user must be in E.164 format.\u003c/p\u003e\n"],["\u003cp\u003eAn agent's unique identifier is required in the request as the \u003ccode\u003eagentId\u003c/code\u003e query parameter.\u003c/p\u003e\n"]]],[],null,["# Method: phones.testers.create\n\nInvites a user to test an agent.\n\nThe invited user must be RCS-enabled and reachable by the RBM platform. When an agent invites a user to become a tester, an RBM platform management agent sends a message to the user asking for confirmation that she wants to be a tester of the agent. Once the user confirms, she becomes a tester.\n\nAn agent that has not yet launched can only interact with users who are testers of that agent. If an unlaunched agent attempts to send a message, event, or capability callback to a non-tester, the RBM platform returns a `403 PERMISSION_DENIED` error.\n\nAn agent can send 20 tester requests each day with a total maximum of 200 tester requests. If you send tester requests above those limits, the RBM platform returns a `429 RESOURCE_EXHAUSTED` response.\n\n### HTTP request\n\n`POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/testers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` \"phones/{E.164}\", where {E.164} is the user's phone number in E.164 format. For example, with the US phone number +1-222-333-4444, the resulting endpoint would be \u003chttps://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/testers/\u003e. |\n\n### Query parameters\n\n| Parameters ||\n|-----------|---------------------------------------------------|\n| `agentId` | `string` Required. The agent's unique identifier. |\n\n### Request body\n\nThe request body contains an instance of [Tester](/business-communications/rcs-business-messaging/reference/rest/v1/phones.testers#Tester).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Tester](/business-communications/rcs-business-messaging/reference/rest/v1/phones.testers#Tester).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/rcsbusinessmessaging`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
