Method: phones.getCapabilities

取得使用者的 RBM 相關功能。

傳回的酬載會指定能否透過 RBM 觸及使用者；如果是，系統會指定使用者支援的 RBM 功能。如果無法透過 RBM 觸及使用者，RBM 平台會傳回 404 NOT_FOUND。

未啟動的代理程式只能為具備該代理程式測試人員的使用者要求功能。如果某個未啟動的代理程式要求非測試人員的功能，RBM 平台會傳回 403 PERMISSION_DENIED。

HTTP 要求

GET https://rcsbusinessmessaging.googleapis.com/v1/{name=phones/*}/capabilities

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

這個欄位會解析為「phones/{E.164}/功能」，其中 {E.164} 是 E.164 格式的使用者電話號碼。舉例來說，如果使用者的美國電話號碼為 +1-222-333-4444，產生的端點為 https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/capabilities。

查詢參數

參數
requestId

string

要求的專屬 ID，由服務專員指派。這必須是 https://tools.ietf.org/html/rfc4122 中定義的 UUID。如果要求 ID 與代理程式用於先前要求的 ID 相符，RBM 平台會忽略新的要求。
agentId

string

必要欄位。代理程式的專屬 ID。

要求主體

要求主體必須為空白。

回應主體

使用者支援的功能清單

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "features": [
    enum (Feature)
  ]
}
欄位
features[]

enum (Feature)

這部裝置支援的 RBM 功能清單。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

功能

使用者支援的 RBM 功能類型。

列舉
FEATURE_UNSPECIFIED 未指定。
REVOCATION 撤銷。如果使用者支援撤銷功能，代理程式可撤銷在 RBM 平台傳送訊息前傳送的訊息。
RICHCARD_STANDALONE 獨立的複合式資訊卡。
ACTION_CREATE_CALENDAR_EVENT 此為建立日曆活動的建議動作。
ACTION_DIAL 建議撥打電話號碼的動作。
ACTION_OPEN_URL 建議採取的動作，以便開啟網址。
ACTION_SHARE_LOCATION 分享地點的建議動作。
ACTION_VIEW_LOCATION 建議在地圖應用程式中查看地點的建議動作。