แสดงรายการ "รายชื่อติดต่ออื่นๆ" ทั้งหมด ซึ่งก็คือรายชื่อติดต่อที่ไม่ได้อยู่ในกลุ่มรายชื่อติดต่อ "รายชื่อติดต่ออื่นๆ" มักจะเป็นรายชื่อติดต่อที่สร้างขึ้นโดยอัตโนมัติจากการโต้ตอบ
โทเค็นการซิงค์จะหมดอายุภายใน 7 วันหลังจากการซิงค์เต็มรูปแบบ คำขอที่มีโทเค็นการซิงค์ที่หมดอายุแล้วจะได้รับข้อผิดพลาดพร้อมกับ google.rpc.ErrorInfo โดยให้เหตุผล "EXPIRED_SYNC_TOKEN" ในกรณีไคลเอ็นต์ข้อผิดพลาดดังกล่าว ควรส่งคำขอซิงค์แบบเต็มโดยไม่มี syncToken
หน้าแรกของคำขอซิงค์แบบเต็มจะมีโควต้าเพิ่มเติม หากเกินโควต้า ระบบจะแสดงข้อผิดพลาด 429 โควต้านี้ได้รับการแก้ไขแล้ว และจะเพิ่มไม่ได้
เมื่อระบุ
แล้ว ระบบจะแสดงผลทรัพยากรที่ถูกลบตั้งแต่การซิงค์ครั้งล่าสุดเป็นบุคคลที่ตั้งค่า syncToken
เป็น "จริง"PersonMetadata.deleted
เมื่อมีการระบุ
หรือ pageToken
พารามิเตอร์คำขออื่นๆ ทั้งหมดต้องตรงกับการเรียกครั้งแรกsyncToken
การเขียนอาจมีความล่าช้าในการนำไปใช้งานหลายนาทีสำหรับคำขอซิงค์ การซิงค์ที่เพิ่มขึ้นไม่ได้มีไว้สำหรับกรณีการใช้งานแบบอ่านหลังเขียน
ดูตัวอย่างการใช้งานได้ที่แสดงรายชื่อติดต่ออื่นๆ ของผู้ใช้ที่มีการเปลี่ยนแปลง
คำขอ HTTP
GET https://people.googleapis.com/v1/otherContacts
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
pageToken |
ไม่บังคับ โทเค็นของหน้าเว็บที่ได้รับจากการตอบกลับก่อนหน้านี้ เมื่อใส่เลขหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้กับ |
pageSize |
ไม่บังคับ จำนวน "รายชื่อติดต่ออื่นๆ" ที่จะรวมไว้ในคำตอบ ค่าที่ใช้ได้ต้องอยู่ระหว่าง 1 ถึง 1000 ค่าเริ่มต้นคือ 100 หากไม่ได้ตั้งค่าไว้หรือตั้งค่าเป็น 0 |
requestSyncToken |
ไม่บังคับ การตอบสนองควรแสดง ดูรายละเอียดเพิ่มเติมเกี่ยวกับลักษณะการซิงค์ได้ที่ |
syncToken |
ไม่บังคับ โทเค็นการซิงค์ที่ได้รับจากการตอบกลับก่อนหน้า เมื่อซิงค์ พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุกับ ดูรายละเอียดเพิ่มเติมเกี่ยวกับลักษณะการซิงค์ได้ที่ |
readMask |
ต้องระบุ ฟิลด์มาสก์เพื่อจํากัดว่าจะให้ระบบแสดงช่องใดของผู้ใช้แต่ละราย คุณระบุได้หลายช่องโดยคั่นด้วยเครื่องหมายคอมมา ค่าที่ถูกต้องจะขึ้นอยู่กับสิ่งที่ ReadSourceType ใช้ หากใช้ READ_SOURCE_TYPE_CONTACT ค่าที่ถูกต้องจะเป็นดังนี้
หากใช้ READ_SOURCE_TYPE_PROFILE ค่าที่ถูกต้องจะเป็นดังนี้
|
sources[] |
ไม่บังคับ มาสก์ของประเภทแหล่งที่มาที่จะแสดงผล ค่าเริ่มต้นคือ ค่าที่เป็นไปได้สำหรับช่องนี้คือ ไม่อนุญาตการระบุ |
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
การตอบกลับคำขอ "รายชื่อติดต่ออื่นๆ" ของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"otherContacts": [
{
object ( |
ช่อง | |
---|---|
otherContacts[] |
รายการ "รายชื่อติดต่ออื่นๆ" แสดงเป็นทรัพยากรบุคคล "รายชื่อติดต่ออื่นๆ" รองรับข้อมูลบางช่องแบบจำกัด ดูรายละเอียดเพิ่มเติมได้ที่ ListOtherContactsRequest.request_mask |
nextPageToken |
โทเค็นที่ส่งเป็น |
nextSyncToken |
โทเค็นที่ส่งเป็น |
totalSize |
จำนวนรายชื่อติดต่ออื่นๆ ทั้งหมดในรายการที่ไม่มีการใส่เลขหน้า |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/contacts.other.readonly
โปรดดูข้อมูลเพิ่มเติมที่คู่มือการให้สิทธิ์