Method: people.createContact

Buat kontak baru dan tampilkan referensi orang untuk kontak tersebut.

Permintaan menampilkan error 400 jika lebih dari satu kolom ditentukan pada kolom yang merupakan singleton untuk sumber kontak:

  • biografi
  • ulang tahun
  • gender
  • names

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:createContact

URL menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
personFields

string (FieldMask format)

Wajib. Mask kolom untuk membatasi kolom mana pada setiap orang yang ditampilkan. Beberapa kolom dapat ditentukan dengan memisahkannya menggunakan koma. Jika tidak disetel, setelan default-nya adalah semua kolom. 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 permintaan

Isi permintaan memuat instance Person.

Isi respons

Jika berhasil, isi respons akan berisi instance Person.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.