Method: phones.getCapabilities

取得使用者的 RCS for Business 相關功能。

傳回的酬載會指出是否能透過 RCS for Business 聯絡使用者，以及使用者支援哪些 RCS for Business 功能。

錯誤處理：如果無法透過 RCS for Business 聯絡使用者，系統會傳回 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://www.rfc-editor.org/info/rfc9562 所定義。如果要求 ID 與代理先前使用的要求 ID 相符，RCS for Business 平台會忽略新要求。
agentId

string

必填。代理的專屬 ID。

要求主體

要求主體必須為空白。

回應主體

使用者支援的功能清單。

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

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

enum (Feature)

這部裝置支援的 RCS for Business 功能清單。
carrier

string

僅供輸出。根據 Google RCS 後端，使用者電話號碼所屬的電信業者資訊。目前，這個欄位只會填入美國電話號碼。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱OAuth 2.0 Overview。

功能

使用者支援的 RCS for Business 功能類型。

列舉
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 中開啟網址。