Method: phones.getCapabilities

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

Trọng tải được trả về chỉ định xem có thể tiếp cận người dùng bằng RBM hay không và nếu có thì người dùng hỗ trợ tính năng RBM nào. 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 tác nhân chưa được khởi chạy chỉ có thể yêu cầu các chức năng cho những người dùng là người kiểm thử tác nhân đó. Nếu một nhân viên hỗ trợ chưa ra mắt yêu cầu các chức năng của một người chưa kiểm 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

Thông số
name

string

Trường này chuyển thành "phones/{E.164}/chức năng", 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ả 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 đã sử 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 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 đượ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 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 bài viết 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 chỉ định.
REVOCATION Thu hồi. Nếu người dùng hỗ trợ tính năng 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 chi tiết độ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 để quay số.
ACTION_OPEN_URL Thao tác được đề xuất để mở một URL trong trình duyệt.
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 đồ.
ACTION_OPEN_URL_IN_WEBVIEW Thao tác được đề xuất để mở URL trong webview.
ACTION_COMPOSE Thao tác được đề xuất để soạn tin nhắn văn bản/âm thanh/video.