Method: people.updateContactPhoto

Perbarui foto kontak.

Permintaan yang berubah untuk pengguna yang sama harus dikirim secara berurutan untuk menghindari peningkatan latensi dan kegagalan.

Permintaan HTTP

PATCH https://people.googleapis.com/v1/{resourceName=people/*}:updateContactPhoto

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
resourceName

string

Wajib. Nama resource orang

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "photoBytes": string,
  "personFields": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
Kolom
photoBytes

string (bytes format)

Wajib. Byte foto mentah

String berenkode base64.

personFields

string (FieldMask format)

Opsional. Mask kolom untuk membatasi kolom pada orang yang ditampilkan. Beberapa kolom dapat ditentukan dengan memisahkannya menggunakan koma. Nilai defaultnya adalah kosong jika tidak ditetapkan, yang akan melewati mutate dapatkan pasca-mutasi. Nilai yang valid adalah:

  • addresses
  • ageRanges
  • biografi
  • ulang tahun
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • acara
  • externalIds
  • gender
  • imClients
  • minat
  • locales
  • lokasi
  • channel
  • metadata
  • miscKeywords
  • names
  • nama panggilan
  • pekerjaan
  • organizations
  • phoneNumbers
  • foto
  • relasi
  • sipAddresses
  • keterampilan
  • urls
  • userDefined
sources[]

enum (ReadSourceType)

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

Isi respons

Respons untuk memperbarui foto kontak.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "person": {
    object (Person)
  }
}
Kolom
person

object (Person)

Orang yang diperbarui, jika personFields ditetapkan di UpdateContactPhotoRequest; jika tidak, setelan ini tidak akan disetel.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.