Method: phones.getCapabilities

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

傳回的酬載會指定是否可透過 RBM 聯絡使用者，以及使用者支援哪些 RBM 功能。

錯誤處理：如果無法透過 RBM 聯絡使用者，系統會傳回 404 NOT_FOUND 錯誤。包括多種情況：(1) 使用者的裝置不支援 RCS 或已停用 RCS。(2) 使用者位於行動網路上，但該網路未啟動代理程式，或未啟用 RCS 流量。(3) 未發布的代理程式要求非測試人員的使用者權限。

HTTP 要求

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

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

路徑參數

參數
name

string

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

查詢參數

參數
requestId

string

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

string

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

要求主體

要求主體必須為空白。

回應主體

使用者支援的功能清單

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

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

enum (Feature)

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱OAuth 2.0 Overview。

功能

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

列舉
FEATURE_UNSPECIFIED 不指定。
RICHCARD_STANDALONE 獨立複合式資訊卡。
ACTION_CREATE_CALENDAR_EVENT 建議建立日曆活動。
ACTION_DIAL 建議撥打電話號碼。
ACTION_OPEN_URL 建議在瀏覽器中開啟網址。
ACTION_SHARE_LOCATION 分享位置資訊的建議動作。
ACTION_VIEW_LOCATION 建議動作：在地圖應用程式中查看地點。
ACTION_OPEN_URL_IN_WEBVIEW 建議在 WebView 中開啟網址的動作。