Perbarui batch kontak dan tampilkan peta nama resource ke PersonResponses untuk kontak yang diperbarui.
Permintaan yang berubah untuk pengguna yang sama harus dikirim secara berurutan untuk menghindari peningkatan latensi dan kegagalan.
Permintaan HTTP
POST https://people.googleapis.com/v1/people:batchUpdateContacts
URL menggunakan sintaksis gRPC Transcoding.
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "contacts": { string: { object ( |
Kolom | |
---|---|
contacts |
Wajib. Peta nama resource ke data orang yang akan diperbarui. Memungkinkan hingga 200 kontak dalam satu permintaan. Objek yang berisi daftar pasangan |
updateMask |
Wajib. Mask kolom untuk membatasi kolom pada orang yang akan diperbarui. Beberapa kolom dapat ditentukan dengan memisahkannya menggunakan koma. Semua kolom yang ditentukan akan diganti, atau dihapus jika dibiarkan kosong untuk setiap orang. Nilai yang valid adalah:
|
readMask |
Wajib. Mask kolom untuk membatasi kolom mana pada setiap orang yang ditampilkan. Beberapa kolom dapat ditentukan dengan memisahkannya menggunakan koma. Jika mask baca dibiarkan kosong, post-mutate-get akan dilewati dan tidak ada data yang akan ditampilkan dalam respons. Nilai yang valid adalah:
|
sources[] |
Opsional. Mask untuk jenis sumber yang akan ditampilkan. Jika tidak ditetapkan, setelan defaultnya adalah |
Isi respons
Jika tidak berhasil, tampilkan BatchUpdateContactsErrorDetails
, daftar error yang sesuai dengan setiap kontak.
Respons terhadap permintaan untuk memperbarui sekumpulan kontak.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"updateResult": {
string: {
object ( |
Kolom | |
---|---|
updateResult |
Peta nama resource ke kontak yang diperbarui, kecuali jika permintaan Objek yang berisi daftar pasangan |
Cakupan otorisasi
Memerlukan cakupan OAuth berikut ini:
https://www.googleapis.com/auth/contacts
Untuk informasi selengkapnya, lihat Panduan otorisasi.