Method: phones.getCapabilities

Lấy các chức năng liên quan đến RBM của người dùng.

Tải trọng được trả về chỉ định xem người dùng có thể được liên hệ qua RBM hay không và nếu có thì người dùng hỗ trợ những tính năng nào của RBM.

Xử lý lỗi: lỗi 404 NOT_FOUND sẽ được trả về khi không thể liên hệ với người dùng qua RBM. Điều này bao gồm nhiều trường hợp: (1) Thiết bị của người dùng không hỗ trợ RCS hoặc đã tắt RCS. (2) Người dùng đang sử dụng mạng di động mà tác nhân không được khởi chạy hoặc nơi lưu lượng truy cập RCS không được bật. (3) Một tác nhân chưa ra mắt yêu cầu các chức năng của một người dùng không phải là người kiểm thử.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
name

string

Trường này phân giải thành "phones/{E.164}/capabilities", trong đó {E.164} là số điện thoại của người dùng ở định dạng E.164. Ví dụ: đối với người dùng có số điện thoại ở Hoa Kỳ là +1-222-333-4444, điểm cuối thu được là https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/capabilities.

Tham số truy vấn

Thông số
requestId

string

Mã nhận dạng duy nhất của yêu cầu, do tác nhân chỉ định. Đây phải là một UUID, như được xác định trong https://tools.ietf.org/html/rfc4122. Nếu mã yêu cầu khớp với mã mà tác nhân đã dùng cho một yêu cầu trước đó, thì nền tảng RBM sẽ bỏ qua yêu cầu mới.
agentId

string

Bắt buộc. Giá trị nhận dạng riêng biệt của nhân viên.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Danh sách các tính năng được người dùng hỗ trợ

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "features": [
    enum (Feature)
  ]
}
Trường
features[]

enum (Feature)

Danh sách các tính năng của RBM mà thiết bị này hỗ trợ.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

Tính năng

Các loại tính năng RBM mà người dùng hỗ trợ.

Enum
FEATURE_UNSPECIFIED Chưa chỉ định.
RICHCARD_STANDALONE Thẻ thông tin chi tiết độc lập.
ACTION_CREATE_CALENDAR_EVENT Đề xuất hành động tạo sự kiện trên lịch.
ACTION_DIAL Hành động đề xuất để gọi đến một số điện thoại.
ACTION_OPEN_URL Thao tác được đề xuất để mở một URL trong trình duyệt.
ACTION_SHARE_LOCATION Hành động đề xuất để chia sẻ vị trí.
ACTION_VIEW_LOCATION Hành động đề xuất để xem một vị trí trong ứng dụng bản đồ.
ACTION_OPEN_URL_IN_WEBVIEW Thao tác được đề xuất để mở một URL trong webview.