Method: otherContacts.search

ระบุรายการรายชื่อติดต่อในรายชื่อติดต่ออื่นๆ ของผู้ใช้ที่ตรวจสอบสิทธิ์แล้วซึ่งตรงกับคําค้นหา คําค้นหาจะจับคู่ในช่อง 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

string

ต้องระบุ การค้นหาข้อความธรรมดาสําหรับคําขอ คําค้นหาจะใช้เพื่อจับคู่วลีคํานําหน้าของช่องในแต่ละรายการ เช่น คนที่มีชื่อ "foo name" ตรงกับคําค้นหา เช่น "f", "fo", "foo", "foo n", "nam" ฯลฯ แต่ไม่ตรงกับ "oo n"

pageSize

integer

ไม่บังคับ จํานวนผลการค้นหาที่จะแสดง ค่าเริ่มต้นจะเป็น 10 หากไม่ได้กําหนดค่าช่องไว้หรือตั้งค่าเป็น 0 ค่าที่มากกว่า 30 จะค่าสูงสุดเป็น 30

readMask

string (FieldMask format)

ต้องระบุ มาสก์ช่องเพื่อจํากัดช่องที่จะแสดงต่อคนแต่ละคน คุณระบุช่องหลายช่องได้โดยคั่นด้วยคอมมา ค่าที่ใช้ได้มีดังนี้

  • อีเมล
  • ข้อมูลเมตา
  • ชื่อ
  • หมายเลขโทรศัพท์

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

เนื้อหาของคำขอต้องว่างเปล่า

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

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ SearchResponse

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

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

  • https://www.googleapis.com/auth/contacts.other.readonly

สําหรับข้อมูลเพิ่มเติม โปรดดูคู่มือการให้สิทธิ์