Method: otherContacts.list

แสดงรายการ "รายชื่อติดต่ออื่นๆ" ทั้งหมด ซึ่งก็คือรายชื่อติดต่อที่ไม่ได้อยู่ในกลุ่มรายชื่อติดต่อ "รายชื่อติดต่ออื่นๆ" มักจะเป็นรายชื่อติดต่อที่สร้างขึ้นโดยอัตโนมัติจากการโต้ตอบ

โทเค็นการซิงค์จะหมดอายุภายใน 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

string

ไม่บังคับ โทเค็นของหน้าเว็บที่ได้รับจากการตอบกลับก่อนหน้านี้ nextPageToken ระบุข้อมูลนี้เพื่อเรียกหน้าถัดไป

เมื่อใส่เลขหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้กับ otherContacts.list ต้องตรงกับการเรียกแรกที่ระบุโทเค็นของหน้าเว็บ
pageSize

integer

ไม่บังคับ จำนวน "รายชื่อติดต่ออื่นๆ" ที่จะรวมไว้ในคำตอบ ค่าที่ใช้ได้ต้องอยู่ระหว่าง 1 ถึง 1000 ค่าเริ่มต้นคือ 100 หากไม่ได้ตั้งค่าไว้หรือตั้งค่าเป็น 0
requestSyncToken

boolean

ไม่บังคับ การตอบสนองควรแสดง nextSyncToken ในหน้าผลการค้นหาหน้าสุดท้ายหรือไม่ คุณใช้คีย์นี้เพื่อรับการเปลี่ยนแปลงเพิ่มเติมนับตั้งแต่คำขอล่าสุดได้โดยการตั้งค่าในคำขอ syncToken

ดูรายละเอียดเพิ่มเติมเกี่ยวกับลักษณะการซิงค์ได้ที่ otherContacts.list
syncToken

string

ไม่บังคับ โทเค็นการซิงค์ที่ได้รับจากการตอบกลับก่อนหน้า nextSyncToken โปรดระบุเพื่อดึงเฉพาะทรัพยากรที่เปลี่ยนแปลงตั้งแต่คำขอล่าสุด

เมื่อซิงค์ พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุกับ otherContacts.list ต้องตรงกับการเรียกแรกที่ระบุโทเค็นการซิงค์

ดูรายละเอียดเพิ่มเติมเกี่ยวกับลักษณะการซิงค์ได้ที่ otherContacts.list
readMask

string (FieldMask format)

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

หากใช้ READ_SOURCE_TYPE_CONTACT ค่าที่ถูกต้องจะเป็นดังนี้

  • emailAddresses
  • ข้อมูลเมตา
  • names
  • phoneNumbers
  • ภาพถ่าย

หากใช้ READ_SOURCE_TYPE_PROFILE ค่าที่ถูกต้องจะเป็นดังนี้

  • ที่อยู่
  • ageRanges
  • ชีวประวัติ
  • วันเกิด
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • กิจกรรม
  • externalIds
  • เพศ
  • imClients
  • ความสนใจ
  • locales
  • สถานที่ตั้ง
  • ของช่อง
  • ข้อมูลเมตา
  • miscKeywords
  • names
  • ชื่อเล่น
  • อาชีพ
  • organizations
  • phoneNumbers
  • ภาพถ่าย
  • ความสัมพันธ์
  • sipAddresses
  • ทักษะ
  • urls
  • userDefined
sources[]

enum (ReadSourceType)

ไม่บังคับ มาสก์ของประเภทแหล่งที่มาที่จะแสดงผล ค่าเริ่มต้นคือ READ_SOURCE_TYPE_CONTACT หากไม่ได้ตั้งค่าไว้

ค่าที่เป็นไปได้สำหรับช่องนี้คือ

ไม่อนุญาตการระบุ READ_SOURCE_TYPE_PROFILE โดยไม่ระบุ READ_SOURCE_TYPE_CONTACT

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

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

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

การตอบกลับคำขอ "รายชื่อติดต่ออื่นๆ" ของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์

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

การแสดง JSON 
{
  "otherContacts": [
    {
      object (Person)
    }
  ],
  "nextPageToken": string,
  "nextSyncToken": string,
  "totalSize": integer
}
ช่อง
otherContacts[]

object (Person)

รายการ "รายชื่อติดต่ออื่นๆ" แสดงเป็นทรัพยากรบุคคล "รายชื่อติดต่ออื่นๆ" รองรับข้อมูลบางช่องแบบจำกัด ดูรายละเอียดเพิ่มเติมได้ที่ ListOtherContactsRequest.request_mask
nextPageToken

string

โทเค็นที่ส่งเป็น pageToken เพื่อเรียกดูหน้าถัดไปได้ หากเว้นช่องนี้ไว้ ก็จะไม่เห็นหน้าต่อๆ ไป
nextSyncToken

string

โทเค็นที่ส่งเป็น syncToken เพื่อเรียกการเปลี่ยนแปลงนับตั้งแต่คำขอครั้งล่าสุดได้ คำขอต้องตั้งค่า requestSyncToken เพื่อส่งโทเค็นการซิงค์
totalSize

integer

จำนวนรายชื่อติดต่ออื่นๆ ทั้งหมดในรายการที่ไม่มีการใส่เลขหน้า

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

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

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

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