Method: people.batchCreateContacts

Buat batch kontak baru dan tampilkan PersonResponses untuk

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

Permintaan HTTP

POST https://people.googleapis.com/v1/people:batchCreateContacts

URL menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "contacts": [
    {
      object (ContactToCreate)
    }
  ],
  "readMask": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
Kolom
contacts[]

object (ContactToCreate)

Wajib diisi. Kontak yang akan dibuat. Mengizinkan hingga 200 kontak dalam satu permintaan.

readMask

string (FieldMask format)

Wajib diisi. Mask kolom untuk membatasi kolom mana pada setiap orang yang ditampilkan dalam respons. Beberapa kolom dapat ditentukan dengan memisahkannya dengan koma. Jika mask baca dibiarkan kosong, post-mutate-get akan dilewati dan tidak ada data yang akan ditampilkan dalam respons. 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 di postingan mengubah mutasi. Jika tidak ditetapkan, setelan defaultnya adalah READ_SOURCE_TYPE_CONTACT dan READ_SOURCE_TYPE_PROFILE.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Jika tidak berhasil, akan menampilkan BatchCreateContactsErrorDetails yang berisi daftar error untuk setiap kontak yang tidak valid.

Respons terhadap permintaan untuk membuat batch kontak.

Representasi JSON
{
  "createdPeople": [
    {
      object (PersonResponse)
    }
  ]
}
Kolom
createdPeople[]

object (PersonResponse)

Kontak yang dibuat, kecuali jika permintaan readMask kosong.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk mendapatkan informasi lebih lanjut, lihat Panduan otorisasi.

ContactToCreate

Wrapper yang berisi data orang untuk mengisi sumber yang baru dibuat.

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

object (Person)

Wajib diisi. Data orang untuk mengisi sumber yang baru dibuat.