Method: people.updateContact

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

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

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

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

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

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

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

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

คำขอ 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 ความสนใจ ภาษา สถานที่ตั้ง ของช่อง miscKeywords ชื่อ ชื่อเล่น อาชีพ องค์กร phoneNumbers ความสัมพันธ์ sipAddresses URL userDefined
personFields	string (FieldMask format) ไม่บังคับ หน้ากากฟิลด์เพื่อจํากัดฟิลด์ของบุคคลแต่ละคนที่จะแสดงผล คุณสามารถระบุหลายช่องได้โดยคั่นด้วยคอมมา ค่าเริ่มต้นคือทุกช่อง หากไม่ได้ตั้งค่าไว้ ค่าที่ใช้ได้มีดังนี้ ที่อยู่ ageRanges ชีวประวัติ วันเกิด calendarUrls clientData coverPhotos emailAddresses กิจกรรม externalIds เพศ imClients ความสนใจ ภาษา สถานที่ตั้ง ของช่อง ข้อมูลเมตา miscKeywords ชื่อ ชื่อเล่น อาชีพ องค์กร phoneNumbers รูปภาพ ความสัมพันธ์ sipAddresses ทักษะ URL userDefined
sources[]	enum (ReadSourceType) ไม่บังคับ มาสก์ของประเภทแหล่งที่มาที่จะแสดง ค่าเริ่มต้นคือ READ_SOURCE_TYPE_CONTACT และ READ_SOURCE_TYPE_PROFILE หากไม่ได้ตั้งค่าไว้

เนื้อความของคำขอ

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

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

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

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

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

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

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