Perbarui nama grup kontak yang ada yang dimiliki oleh pengguna terautentikasi.
Nama grup kontak yang diperbarui 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
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 entitas 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 oleh 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 hanya diisi untuk permintaan GET dan hanya akan menampilkan anggota sebanyak |
contactGroup.memberCount |
Hanya output. Jumlah total kontak dalam grup, terlepas dari jumlah anggota maksimum yang ditentukan dalam permintaan. |
contactGroup.clientData[] |
Data klien grup. |
updateGroupFields |
Opsional. Mask kolom untuk membatasi kolom di grup yang diperbarui. Beberapa kolom dapat ditentukan dengan memisahkannya dengan koma. Jika tidak ditetapkan atau ditetapkan ke kosong, nilai defaultnya adalah
|
readGroupFields |
Opsional. Mask kolom untuk membatasi kolom mana di grup yang ditampilkan. Jika tidak ditetapkan atau ditetapkan ke kosong, nilai defaultnya adalah
|
Isi respons
Jika berhasil, isi respons memuat instance ContactGroup
.
Cakupan Otorisasi
Memerlukan cakupan OAuth berikut ini:
https://www.googleapis.com/auth/contacts
Untuk mendapatkan informasi lebih lanjut, lihat Panduan otorisasi.