Method: users.batchGet

รับหมายเลขโทรศัพท์ที่เปิดใช้ RCS สำหรับรายชื่อผู้ใช้

เพย์โหลดที่ส่งคืนจะประกอบด้วยรายการหมายเลขโทรศัพท์ที่เปิดใช้ RCS ซึ่งเข้าถึงได้โดยแพลตฟอร์ม RBM ของผู้ใช้ที่ระบุ มีเพียงหมายเลขโทรศัพท์ที่เปิดใช้ RCS สำหรับผู้ให้บริการที่เปิดใช้ตัวแทนเท่านั้น

เพย์โหลดที่แสดงผลยังมีค่าที่สามารถใช้เพื่อประมาณการเข้าถึงที่เป็นไปได้ของรายการหมายเลขโทรศัพท์ โดยไม่คำนึงถึงสถานะการเปิดใช้งานของ Agent

สูงสุด 600 ข้อความค้นหาต่อนาที (QPM)

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง gRPC

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "users": [
    string
  ],
  "agentId": string
}
ช่อง
users[]

string

รายการหมายเลขโทรศัพท์ของผู้ใช้ในรูปแบบ E.164
agentId

string

ต้องระบุ ตัวระบุที่ไม่ซ้ำกันของตัวแทน

เนื้อหาการตอบกลับ

การตอบสนองด้วยข้อมูลผู้ใช้ความสามารถในการเข้าถึง RBM

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "reachableUsers": [
    string
  ],
  "totalRandomSampleUserCount": integer,
  "reachableRandomSampleUserCount": integer
}
ช่อง
reachableUsers[]

string

รายการหมายเลขโทรศัพท์ของผู้ใช้ที่ RBM เข้าถึงได้ รวมเฉพาะผู้ใช้ของผู้ให้บริการที่มีการเปิดใช้งานตัวแทนเท่านั้น
totalRandomSampleUserCount

integer

จำนวนหมายเลขโทรศัพท์ที่สุ่มเลือกจาก reachableUsers โดยทั่วไปค่านี้คือประมาณ 75% ของหมายเลขโทรศัพท์ที่ขอทั้งหมด ค่านี้คือ 0 หากจำนวนหมายเลขโทรศัพท์ที่ขอน้อยกว่า 500 รายการ
reachableRandomSampleUserCount

integer

จำนวนหมายเลขโทรศัพท์จากรายชื่อที่เลือกแบบสุ่มซึ่งติดต่อ RCS ได้จากผู้ให้บริการทั้งหมด ไม่ว่าสถานะการเปิดใช้ของตัวแทนจะเป็นอย่างไร อัตราส่วนระหว่างค่านี้กับ totalRandomSampleUserCount สามารถประมาณค่าการเข้าถึงที่เป็นไปได้สำหรับรายชื่อผู้ใช้

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0