ระบุรายชื่อติดต่อในรายชื่อติดต่ออื่นๆ ของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์ซึ่งตรงกับคำค้นหา ข้อความค้นหาตรงกับฟิลด์ names, emailAddresses และ phoneNumbers ของรายชื่อติดต่อที่มาจากแหล่งที่มาของ OTHER_CONTACT
สำคัญ: ก่อนค้นหา ไคลเอ็นต์ควรส่งคำขออุ่นเครื่องที่มีคำค้นหาว่างเปล่าเพื่ออัปเดตแคช โปรดดู https://developers.google.com/people/v1/other-contacts#search_the_users_other_contacts
คำขอ HTTP
GET https://people.googleapis.com/v1/otherContacts:search
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์การค้นหา
| พารามิเตอร์ | |
|---|---|
query |
ต้องระบุ การค้นหาด้วยข้อความธรรมดาสำหรับคำขอ คำค้นหาใช้เพื่อจับคู่วลีนำหน้าของช่องกับบุคคล เช่น คนที่ชื่อ "foo name" จะจับคู่กับคำค้นหา เช่น "f", "fo", "foo", "foo n", "nam" ฯลฯ แต่ไม่จับคู่กับ "oo n" |
pageSize |
ไม่บังคับ จำนวนผลลัพธ์ที่จะแสดงผล ค่าเริ่มต้นจะเป็น 10 หากไม่ได้กำหนดช่องไว้ หรือตั้งค่าเป็น 0 ค่าที่มากกว่า 30 จะถูกจำกัดไว้ที่ 30 |
readMask |
ต้องระบุ ฟิลด์มาสก์เพื่อจํากัดว่าจะให้ระบบแสดงช่องใดของผู้ใช้แต่ละราย คุณระบุได้หลายช่องโดยคั่นด้วยเครื่องหมายคอมมา ค่าที่ใช้ได้มีดังนี้
|
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ SearchResponse
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/contacts.other.readonly
โปรดดูข้อมูลเพิ่มเติมที่คู่มือการให้สิทธิ์