Method: people.updateContact

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

เซิร์ฟเวอร์จะแสดงข้อผิดพลาด 400 หากไม่ได้ระบุ person.metadata.sources ให้อัปเดตรายชื่อติดต่อ หรือหากไม่มีแหล่งที่มาของรายชื่อติดต่อ

เซิร์ฟเวอร์แสดงข้อผิดพลาด 400 โดยมีเหตุผลว่า "failedPrecondition" หาก person.metadata.sources.etag แตกต่างจากแท็กของรายชื่อติดต่อ ซึ่งบ่งบอกว่ารายชื่อติดต่อมีการเปลี่ยนแปลงตั้งแต่มีการอ่านข้อมูล ลูกค้าควรได้รับบริการล่าสุดและผสานการอัปเดตเป็นเวอร์ชันล่าสุด

เซิร์ฟเวอร์จะแสดงข้อผิดพลาด 400 หาก memberships ได้รับการอัปเดตและไม่ได้ระบุการเป็นสมาชิกกลุ่มในรายชื่อติดต่อของบุคคลนั้น

เซิร์ฟเวอร์จะแสดงข้อผิดพลาด 400 หากมีการระบุมากกว่า 1 ช่องในช่องที่เป็น Singleton สําหรับแหล่งที่มาของรายชื่อติดต่อ:

  • ชีวประวัติ
  • วันเกิด
  • เพศ
  • ชื่อ

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

คำขอ HTTP

PATCH https://people.googleapis.com/v1/{person.resourceName=people/*}:updateContact

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
person.resourceName

string

ชื่อทรัพยากรของบุคคล ที่เซิร์ฟเวอร์กําหนด สตริง ASCII ในรูปแบบ people/{person_id}

พารามิเตอร์การค้นหา

พารามิเตอร์
updatePersonFields

string (FieldMask format)

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

  • ที่อยู่
  • ชีวประวัติ
  • วันเกิด
  • URL ของปฏิทิน
  • ClientData
  • อีเมล
  • กิจกรรม
  • รหัสภายนอก
  • เพศ
  • imClients
  • ความสนใจ
  • ภาษา
  • สถานที่ตั้ง
  • ของช่อง
  • คีย์เวิร์ดเบ็ดเตล็ด
  • ชื่อ
  • ชื่อเล่น
  • อาชีพ
  • องค์กร
  • หมายเลขโทรศัพท์
  • ความสัมพันธ์
  • ที่อยู่ SIP
  • URL
  • ผู้ใช้กําหนด
personFields

string (FieldMask format)

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

  • ที่อยู่
  • ช่วงอายุ
  • ชีวประวัติ
  • วันเกิด
  • URL ของปฏิทิน
  • ClientData
  • รูปภาพปก
  • อีเมล
  • กิจกรรม
  • รหัสภายนอก
  • เพศ
  • imClients
  • ความสนใจ
  • ภาษา
  • สถานที่ตั้ง
  • ของช่อง
  • ข้อมูลเมตา
  • คีย์เวิร์ดเบ็ดเตล็ด
  • ชื่อ
  • ชื่อเล่น
  • อาชีพ
  • องค์กร
  • หมายเลขโทรศัพท์
  • รูปภาพ
  • ความสัมพันธ์
  • ที่อยู่ SIP
  • ทักษะ
  • URL
  • ผู้ใช้กําหนด
sources[]

enum (ReadSourceType)

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

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

เนื้อความของคำขอมีอินสแตนซ์ของ Person

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

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

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

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

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

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