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
  • ประเภทกลุ่ม
  • ข้อมูลเมตา
  • name

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

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

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

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

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

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