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}/capabilities」，其中 {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 建議動作，可在地圖應用程式中查看地點。
ACTION_OPEN_URL_IN_WEBVIEW 建議在 WebView 中開啟網址。
ACTION_COMPOSE 撰寫文字/音訊/影片訊息的建議操作。