- Permintaan HTTP
- Parameter lokasi
- Parameter kueri
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- Cobalah!
Memperbarui data kontak untuk kontak yang ada. Semua data non-kontak tidak akan diubah. Semua data non-kontak di orang yang akan diperbarui akan diabaikan. Semua kolom yang ditentukan dalam updateMask
akan diganti.
Server menampilkan error 400 jika person.metadata.sources
tidak ditentukan untuk kontak yang akan diperbarui atau jika tidak ada sumber kontak.
Server menampilkan error 400 dengan alasan "failedPrecondition"
jika person.metadata.sources.etag
berbeda dengan etag kontak, yang menunjukkan bahwa kontak telah berubah sejak datanya dibaca. Klien harus mendapatkan orang terbaru dan menggabungkan pembaruan mereka ke dalam orang terbaru. Jika melakukan pembaruan berurutan untuk orang yang sama, etag dari respons updateContact
harus digunakan untuk menghindari kegagalan.
Server menampilkan error 400 jika memberships
sedang diperbarui dan tidak ada keanggotaan grup kontak yang ditentukan pada orang tersebut.
Server menampilkan error 400 jika lebih dari satu kolom ditentukan pada kolom yang merupakan singleton untuk sumber kontak:
- biografi
- ulang tahun
- gender
- nama
Permintaan mutasi untuk pengguna yang sama harus dikirim secara berurutan untuk menghindari peningkatan latensi dan kegagalan.
Permintaan HTTP
PATCH https://people.googleapis.com/v1/{person.resourceName=people/*}:updateContact
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
person.resourceName |
Nama resource untuk orang, yang ditetapkan oleh server. String ASCII dalam bentuk |
Parameter kueri
Parameter | |
---|---|
updatePersonFields |
Wajib. Mask kolom untuk membatasi kolom yang diperbarui pada orang tersebut. Beberapa kolom dapat ditentukan dengan memisahkannya dengan koma. Semua kolom yang diperbarui akan diganti. Nilai yang valid adalah:
|
personFields |
Opsional. Mask kolom untuk membatasi kolom mana pada setiap orang yang ditampilkan. Beberapa kolom dapat ditentukan dengan memisahkannya dengan koma. Jika tidak ditetapkan, setelan defaultnya adalah semua kolom. Nilai yang valid adalah:
|
sources[] |
Opsional. Masker jenis sumber yang akan ditampilkan. Jika tidak ditetapkan, setelan defaultnya adalah |
Isi permintaan
Isi permintaan memuat instance Person
.
Isi respons
Jika berhasil, isi respons memuat instance Person
.
Cakupan otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/contacts
Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.