Method: users.batchGet

Lấy các số điện thoại hỗ trợ RCS cho danh sách người dùng.

Tải trọng được trả về chứa danh sách số điện thoại hỗ trợ RCS mà nền tảng RBM có thể truy cập dành cho những người dùng được chỉ định. Chỉ những số điện thoại có hỗ trợ RCS của một nhà mạng có hỗ trợ nhân viên hỗ trợ mới được trả về.

Tải trọng được trả về cũng chứa các giá trị có thể dùng để ước tính phạm vi tiếp cận tiềm năng của một danh sách số điện thoại bất kể trạng thái khởi chạy của tác nhân.

Tối đa 600 truy vấn mỗi phút (QPM).

Yêu cầu HTTP

POST https://rcsbusinessmessaging.googleapis.com/v1/users:batchGet

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

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "users": [
    string
  ],
  "agentId": string
}
Trường
users[]

string

Danh sách số điện thoại của người dùng ở định dạng E.164.
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 phản hồi

Phản hồi có dữ liệu người dùng về khả năng truy cập RBM.

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 
{
  "reachableUsers": [
    string
  ],
  "totalRandomSampleUserCount": integer,
  "reachableRandomSampleUserCount": integer
}
Trường
reachableUsers[]

string

Danh sách số điện thoại của người dùng mà RBM có thể liên hệ. Chỉ bao gồm những người dùng sử dụng những nhà mạng mà nhân viên hỗ trợ được ra mắt.
totalRandomSampleUserCount

integer

Số lượng số điện thoại được chọn ngẫu nhiên từ reachableUsers. Thông thường, giá trị này chiếm khoảng 75% tổng số điện thoại được yêu cầu. Giá trị này là 0 nếu số điện thoại được yêu cầu nhỏ hơn 500.
reachableRandomSampleUserCount

integer

Số lượng số điện thoại trong danh sách được chọn ngẫu nhiên có thể truy cập bằng RCS trên tất cả các nhà mạng, bất kể trạng thái ra mắt của nhân viên hỗ trợ. Tỷ lệ giữa giá trị này và totalRandomSampleUserCount có thể ước tính phạm vi tiếp cận tiềm năng của một danh sách người dùng.

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.