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 pesan {i>error<i} HTTP 409.

Permintaan mutasi 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 diisi. Grup kontak yang akan dibuat.
readGroupFields

string (FieldMask format)

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

  • clientData
  • groupType
  • metadata
  • nama

Isi respons

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

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.