Perbarui nama grup kontak yang ada milik pengguna yang diautentikasi.
Nama grup kontak yang diperbarui harus unik bagi 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
PUT https://people.googleapis.com/v1/{contactGroup.resourceName=contactGroups/*}
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
contactGroup.resourceName |
Nama resource untuk grup kontak, yang ditetapkan oleh server. String ASCII, dalam bentuk |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"contactGroup": {
"resourceName": string,
"etag": string,
"metadata": {
"updateTime": string,
"deleted": boolean
},
"groupType": enum ( |
Kolom | |
---|---|
contactGroup.etag |
Tag entity HTTP resource. Digunakan untuk validasi cache web. |
contactGroup.metadata |
Hanya output. Metadata tentang grup kontak. |
contactGroup.groupType |
Hanya output. Jenis grup kontak. |
contactGroup.name |
Nama grup kontak yang ditetapkan oleh pemilik grup atau nama yang diberikan sistem untuk grup sistem. Untuk |
contactGroup.formattedName |
Hanya output. Nama yang diterjemahkan dan diformat dalam lokalitas akun pelihat atau lokalitas header HTTP |
contactGroup.memberResourceNames[] |
Hanya output. Daftar nama resource narahubung yang merupakan anggota grup kontak. Kolom ini hanya diisi untuk permintaan GET dan hanya akan menampilkan anggota sebanyak |
contactGroup.memberCount |
Hanya output. Jumlah total kontak dalam grup terlepas dari jumlah maksimum anggota yang ditentukan dalam permintaan. |
contactGroup.clientData[] |
Data klien grup. |
updateGroupFields |
Opsional. Mask kolom untuk membatasi kolom mana di grup yang diperbarui. Beberapa kolom dapat ditentukan dengan memisahkannya menggunakan koma. Jika tidak disetel atau disetel ke kosong, setelan defaultnya adalah
|
readGroupFields |
Opsional. Mask kolom untuk membatasi kolom mana pada grup yang ditampilkan. Default-nya adalah
|
Isi respons
Jika berhasil, isi respons memuat instance ContactGroup
.
Cakupan otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/contacts
Untuk informasi selengkapnya, lihat Panduan otorisasi.