Perbarui nama grup kontak yang ada yang dimiliki oleh pengguna yang diautentikasi.
Nama grup kontak yang diperbarui 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
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 dari 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 diterjemahkan dan diformat dalam lokalitas akun pelihat atau lokalitas header HTTP |
contactGroup.memberResourceNames[] |
Hanya output. Daftar nama sumber daya 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 anggota maksimum yang ditentukan dalam permintaan. |
contactGroup.clientData[] |
Data klien grup. |
updateGroupFields |
Opsional. Mask kolom untuk membatasi kolom pada grup yang akan diperbarui. Beberapa kolom dapat ditentukan dengan memisahkannya menggunakan koma. Jika tidak disetel atau disetel ke kosong, defaultnya adalah
|
readGroupFields |
Opsional. Mask kolom untuk membatasi kolom mana dalam grup yang ditampilkan. Default-nya adalah
|
Isi respons
Jika berhasil, isi respons akan berisi instance ContactGroup
.
Cakupan otorisasi
Memerlukan cakupan OAuth berikut ini:
https://www.googleapis.com/auth/contacts
Untuk informasi selengkapnya, lihat Panduan otorisasi.