Method: people.updateContact

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

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

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

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

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

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

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

คำขอ HTTP

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

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

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

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

string

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

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

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

string (FieldMask format)

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

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

string (FieldMask format)

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

  • ที่อยู่
  • 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 หากไม่ได้ตั้งค่าไว้

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

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

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

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

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

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

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

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