Method: people.updateContact

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Perbarui data kontak untuk kontak yang ada. Data non-kontak apa pun tidak akan diubah. Semua data non-kontak pada orang yang akan diperbarui akan diabaikan. Semua kolom yang ditentukan dalam updateMask akan diganti.

Server akan 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 kontak telah berubah sejak datanya dibaca. Klien harus mendapatkan orang terbaru dan menggabungkan pembaruan mereka ke orang terbaru.

Server akan menampilkan error 400 jika memberships sedang diperbarui dan tidak ada keanggotaan grup kontak yang ditentukan pada orang tersebut.

Server akan 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

string

Nama resource untuk orang, yang ditetapkan oleh server. String ASCII dalam bentuk people/{person_id}.

Parameter kueri

Parameter
updatePersonFields

string (FieldMask format)

Wajib diisi. Mask kolom untuk membatasi kolom mana pada orang tersebut yang diperbarui. Beberapa kolom dapat ditentukan dengan memisahkannya dengan koma. Semua kolom yang diperbarui akan diganti. Nilai yang valid adalah:

  • addresses
  • biografi
  • ulang tahun
  • calendarUrls
  • dataklien
  • alamatEmail
  • acara
  • ID eksternal
  • gender
  • imClients
  • minat
  • lokalitas
  • lokasi
  • channel
  • Kata Kunci Lain-Lain
  • nama
  • nama panggilan
  • pekerjaan
  • organisasi
  • nomor telepon
  • hubungan
  • sipAddress
  • Url
  • Buatan pengguna
personFields

string (FieldMask format)

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:

  • addresses
  • ageRanges
  • biografi
  • ulang tahun
  • calendarUrls
  • dataklien
  • coverFoto
  • alamatEmail
  • acara
  • ID eksternal
  • gender
  • imClients
  • minat
  • lokalitas
  • lokasi
  • channel
  • metadata
  • Kata Kunci Lain-Lain
  • nama
  • nama panggilan
  • pekerjaan
  • organisasi
  • nomor telepon
  • foto
  • hubungan
  • sipAddress
  • keterampilan
  • Url
  • Buatan pengguna
sources[]

enum (ReadSourceType)

Opsional. Masker dari jenis sumber yang akan ditampilkan. Jika tidak ditetapkan, setelan defaultnya adalah READ_SOURCE_TYPE_CONTACT dan READ_SOURCE_TYPE_PROFILE.

Isi permintaan

Isi permintaan memuat instance Person.

Isi respons

Jika berhasil, isi respons memuat instance Person.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/contacts

Untuk mendapatkan informasi lebih lanjut, lihat Panduan otorisasi.