Method: phones.getCapabilities

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

Tải trọng được trả về sẽ chỉ định liệu người dùng có thể tiếp cận được bằng RBM hay không và nếu có thì những tính năng RBM nào mà người dùng hỗ trợ. Nếu không thể liên hệ với người dùng bằng RBM, nền tảng RBM sẽ trả về 404 NOT_FOUND.

Một nhân viên hỗ trợ chưa ra mắt chỉ có thể yêu cầu các chức năng dành cho những người dùng là người thử nghiệm nhân viên hỗ trợ đó. Nếu một tác nhân chưa khởi chạy yêu cầu chức năng của một người không phải kiểm thử, thì nền tảng RBM sẽ trả về 403 PERMISSION_DENIED.

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

Các tham số
name

string

Trường này được 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 tại Hoa Kỳ +1-222-333-4444, điểm cuối kết quả sẽ là https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/capabilities.

Tham số truy vấn

Các tham số
requestId

string

Mã nhận dạng duy nhất của yêu cầu, do nhân viên hỗ trợ chỉ định. Đây phải là mã nhận dạng duy nhất (UUID), như được xác định tại https://tools.ietf.org/html/rfc4122. Nếu mã yêu cầu khớp với mã mà nhân viên hỗ trợ dùng cho 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. Mã nhận dạng duy nhất của nhân viên hỗ trợ.

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 mà 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)
  ]
}
Các trường
features[]

enum (Feature)

Danh sách các tính năng 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 Tổng quan về OAuth 2.0.

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 xác định.
REVOCATION Thu hồi. Nếu người dùng hỗ trợ thu hồi, tác nhân có thể thu hồi thông báo đã gửi trước khi nền tảng RBM gửi thông báo.
RICHCARD_STANDALONE Thẻ thông tin độc lập.
ACTION_CREATE_CALENDAR_EVENT Hành động được đề xuất để tạo sự kiện trên lịch.
ACTION_DIAL Hành động được đề xuất để gọi một số.
ACTION_OPEN_URL Thao tác được đề xuất để mở URL.
ACTION_SHARE_LOCATION Hành động được đề xuất để chia sẻ vị trí.
ACTION_VIEW_LOCATION Hành động được đề xuất để xem vị trí trong ứng dụng bản đồ.