Method: contactGroups.create

Buat grup kontak baru yang dimiliki oleh pengguna terautentikasi.

Nama grup kontak yang dibuat harus unik untuk grup kontak pengguna. Mencoba membuat grup dengan nama duplikat akan menampilkan error 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 di grup yang ditampilkan. Jika tidak ditetapkan atau ditetapkan ke kosong, nilai defaultnya adalah metadata, groupType, dan name. Kolom yang valid adalah:

  • dataklien
  • grupJenis
  • 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 mendapatkan informasi lebih lanjut, lihat Panduan otorisasi.