Method: contactGroups.create

Buat grup kontak baru yang dimiliki oleh pengguna yang diautentikasi.

Nama grup kontak yang dibuat harus unik untuk grup kontak pengguna. Mencoba membuat grup dengan nama duplikat akan menampilkan error HTTP 409.

Permintaan yang berubah untuk pengguna yang sama harus dikirim secara berurutan untuk menghindari peningkatan latensi dan kegagalan.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "contactGroup": {
    object (ContactGroup)
  },
  "readGroupFields": string
}
Kolom
contactGroup

object (ContactGroup)

Wajib. Grup kontak yang akan dibuat.
readGroupFields

string (FieldMask format)

Opsional. Mask kolom untuk membatasi kolom mana dalam grup yang ditampilkan. Default-nya adalah metadata, groupType, dan name jika tidak disetel atau disetel ke kosong. Kolom yang valid adalah:

  • clientData
  • groupType
  • metadata
  • name

Isi respons

Jika berhasil, isi respons memuat instance ContactGroup yang baru dibuat.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.