Method: people.updateContact

• คำขอ HTTP
• พารามิเตอร์เส้นทาง
• พารามิเตอร์การค้นหา
• เนื้อความของคำขอ
• เนื้อหาการตอบกลับ
• ขอบเขตการให้สิทธิ์
• ลองใช้งาน

อัปเดตข้อมูลติดต่อของผู้ติดต่อที่มีอยู่ และจะไม่แก้ไขข้อมูลที่ไม่ใช่รายชื่อติดต่อ ระบบจะไม่สนใจข้อมูลที่ไม่ใช่รายชื่อติดต่อของบุคคลในการอัปเดต ระบบจะแทนที่ช่องทั้งหมดที่ระบุใน 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

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