Method: contactGroups.create

สร้างกลุ่มรายชื่อติดต่อใหม่ที่เป็นของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์

ชื่อกลุ่มรายชื่อติดต่อที่สร้างขึ้นต้องไม่ซ้ำกันสำหรับกลุ่มรายชื่อติดต่อของผู้ใช้ การพยายามสร้างกลุ่มที่มีชื่อซ้ำจะแสดงข้อผิดพลาด HTTP 409

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

คำขอ HTTP

POST https://people.googleapis.com/v1/contactGroups

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

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

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "contactGroup": {
    object (ContactGroup)
  },
  "readGroupFields": string
}
ช่อง
contactGroup

object (ContactGroup)

ต้องระบุ กลุ่มรายชื่อติดต่อที่จะสร้าง
readGroupFields

string (FieldMask format)

ไม่บังคับ ฟิลด์มาสก์เพื่อจำกัดฟิลด์ในกลุ่มที่จะแสดงผล ค่าเริ่มต้นคือ metadata, groupType และ name หากไม่ได้ตั้งค่าไว้หรือตั้งเป็นค่าว่าง ช่องที่ถูกต้องมีดังนี้

  • clientData
  • groupType
  • ข้อมูลเมตา
  • ชื่อ

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

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ ContactGroup ที่สร้างขึ้นใหม่

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

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

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

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