Method: users.batchGet

Lấy số điện thoại đã bật RCS cho một 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 đối với những người dùng được chỉ định. Chỉ những số điện thoại có hỗ trợ RCS của nhà mạng có nhân viên hỗ trợ mới được trả lại.

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 nhân viên hỗ trợ.

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
}
Các 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. Mã nhận dạng duy nhất của nhân viên hỗ trợ.

Nội dung phản hồi

Phản hồi bằng dữ liệu người dùng về khả năng tiếp cận bằng 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
}
Các trường
reachableUsers[]

string

Danh sách số điện thoại của người dùng mà RBM có thể liên lạc. Chỉ bao gồm những người dùng sử dụng nhà mạng có nhân viên hỗ trợ.
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ố lượng 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 mà có thể kết nối với RCS trên mọi 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 Tổng quan về OAuth 2.0.