อัปเดตชื่อของกลุ่มรายชื่อติดต่อที่มีอยู่ซึ่งเป็นของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว
ชื่อกลุ่มรายชื่อติดต่อที่อัปเดตต้องไม่ซ้ำกันสำหรับกลุ่มรายชื่อติดต่อของผู้ใช้ การพยายามสร้างกลุ่มที่มีชื่อซ้ำจะแสดงข้อผิดพลาด HTTP 409
ควรส่งคำขอเปลี่ยนแปลงคำขอสำหรับผู้ใช้รายเดียวกันตามลำดับเพื่อหลีกเลี่ยงเวลาในการตอบสนองและความล้มเหลวที่เพิ่มขึ้น
คำขอ HTTP
PUT https://people.googleapis.com/v1/{contactGroup.resourceName=contactGroups/*}
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
contactGroup.resourceName |
ชื่อทรัพยากรสำหรับกลุ่มรายชื่อติดต่อที่เซิร์ฟเวอร์กำหนด สตริง ASCII ในรูปแบบของ |
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างต่อไปนี้
การแสดง JSON |
---|
{
"contactGroup": {
"resourceName": string,
"etag": string,
"metadata": {
"updateTime": string,
"deleted": boolean
},
"groupType": enum ( |
ช่อง | |
---|---|
contactGroup.etag |
แท็กเอนทิตี HTTP ของทรัพยากร ใช้สำหรับการตรวจสอบเว็บแคช |
contactGroup.metadata |
เอาต์พุตเท่านั้น ข้อมูลเมตาเกี่ยวกับกลุ่มรายชื่อติดต่อ |
contactGroup.groupType |
เอาต์พุตเท่านั้น ประเภทกลุ่มรายชื่อติดต่อ |
contactGroup.name |
ชื่อกลุ่มรายชื่อติดต่อที่ตั้งโดยเจ้าของกลุ่มหรือชื่อกลุ่มของระบบ สำหรับ |
contactGroup.formattedName |
เอาต์พุตเท่านั้น ชื่อที่มีการแปลและจัดรูปแบบในภาษาของบัญชีผู้ดูหรือภาษาส่วนหัว HTTP ของ |
contactGroup.memberResourceNames[] |
เอาต์พุตเท่านั้น รายชื่อทรัพยากรของผู้ติดต่อที่เป็นสมาชิกของกลุ่มผู้ติดต่อ ช่องนี้จะมีการป้อนข้อมูลให้กับคำขอ GET เท่านั้น และจะแสดงเฉพาะสมาชิกจำนวน |
contactGroup.memberCount |
เอาต์พุตเท่านั้น จำนวนรายชื่อติดต่อทั้งหมดในกลุ่มโดยไม่คำนึงถึงจำนวนสมาชิกสูงสุดที่ระบุไว้ในคำขอ |
contactGroup.clientData[] |
ข้อมูลไคลเอ็นต์ของกลุ่ม |
updateGroupFields |
ไม่บังคับ ฟิลด์มาสก์เพื่อจำกัดการอัปเดตฟิลด์ในกลุ่ม คุณระบุได้หลายช่องโดยคั่นด้วยเครื่องหมายคอมมา ค่าเริ่มต้นคือ
|
readGroupFields |
ไม่บังคับ ฟิลด์มาสก์เพื่อจำกัดฟิลด์ในกลุ่มที่จะแสดงผล ค่าเริ่มต้นคือ
|
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ ContactGroup
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/contacts
โปรดดูข้อมูลเพิ่มเติมที่คู่มือการให้สิทธิ์