Method: phones.testers.create

邀請使用者測試代理程式。

受邀使用者必須啟用 RCS，且可透過 RCS for Business 平台聯絡。當代理程式邀請使用者成為測試人員時，RCS Business Messaging 平台管理代理程式會傳送訊息給使用者，要求確認是否要成為代理程式的測試人員。使用者確認後，就會成為測試人員。

尚未發布的代理只能與該代理的測試人員互動。如果未發布的代理程式嘗試將訊息、事件或功能回呼傳送給非測試人員，RCS 企業通訊平台會傳回 403 PERMISSION_DENIED 錯誤。

代理商每天最多可傳送 20 個測試人員要求，總共最多 200 個。如果傳送的測試人員要求超過上述限制，RCS 企業即時通訊平台會傳回 429 RESOURCE_EXHAUSTED 回應。

已淘汰：這個方法將於 2026 年 1 月 31 日淘汰。詳情請參閱 Business Communications API 中的新 Testers 方法。

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 的執行個體。

回應主體

如果成功，回應主體會包含新建立的 Tester 執行個體。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/rcsbusinessmessaging

詳情請參閱OAuth 2.0 Overview。