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)

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

  • emailAddresses
  • ข้อมูลเมตา
  • names
  • phoneNumbers

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

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

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

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

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

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

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

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