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 ( |
Kolom | |
---|---|
contacts[] |
Wajib diisi. Kontak yang akan dibuat. Mengizinkan hingga 200 kontak dalam satu permintaan. |
readMask |
Wajib diisi. Mask kolom untuk membatasi kolom mana pada setiap orang akan ditampilkan dalam respons. Beberapa kolom dapat ditentukan dengan memisahkannya menggunakan koma. Jika mask baca dibiarkan kosong, post-mutate-get akan dilewati dan tidak ada data yang akan ditampilkan dalam respons. Nilai yang valid adalah:
|
sources[] |
Opsional. Mask dari jenis sumber yang akan ditampilkan dalam pembacaan mutasi postingan. Jika tidak disetel, setelan defaultnya adalah |
Isi respons
Jika tidak berhasil, BatchCreateContactsErrorDetails
yang berisi daftar error untuk setiap kontak yang tidak valid akan ditampilkan.
Respons terhadap permintaan untuk membuat batch kontak.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"createdPeople": [
{
object ( |
Kolom | |
---|---|
createdPeople[] |
Kontak yang dibuat, kecuali jika permintaan |
Cakupan otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/contacts
Untuk informasi selengkapnya, lihat Panduan otorisasi.
ContactToCreate
Wrapper yang berisi data orang untuk mengisi sumber yang baru dibuat.
Representasi JSON |
---|
{
"contactPerson": {
object ( |
Kolom | |
---|---|
contactPerson |
Wajib diisi. Data orang untuk mengisi sumber yang baru dibuat. |