Method: people.updateContact

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

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

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