Method: people.batchCreateContacts

Tạo một loạt địa chỉ liên hệ mới và trả về PersonResponses cho

Bạn nên gửi các yêu cầu thay đổi cho cùng một người dùng theo tuần tự để tránh tăng độ trễ và lỗi.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "contacts": [
    {
      object (ContactToCreate)
    }
  ],
  "readMask": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
Trường
contacts[]

object (ContactToCreate)

Bắt buộc. Người liên hệ cần tạo. Cho phép tối đa 200 địa chỉ liên hệ trong một yêu cầu.
readMask

string (FieldMask format)

Bắt buộc. Mặt nạ trường để hạn chế trường nào trên mỗi người được trả về trong phản hồi. Bạn có thể chỉ định nhiều trường bằng cách dùng dấu phẩy để phân tách các trường. Nếu mặt nạ đọc bị để trống, thì post-mutate-get sẽ bị bỏ qua và không có dữ liệu nào được trả về trong phản hồi. Các giá trị hợp lệ là:

  • địa chỉ
  • ageRanges
  • tiểu sử
  • ngày sinh
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • sự kiện
  • externalIds
  • giới tính
  • imClients
  • sở thích
  • ngôn ngữ
  • vị trí
  • của kênh
  • siêu dữ liệu
  • miscKeywords
  • tên
  • biệt hiệu
  • nghề nghiệp
  • tổ chức
  • phoneNumbers
  • ảnh
  • quan hệ
  • sipAddresses
  • kỹ năng
  • url
  • userDefined
sources[]

enum (ReadSourceType)

Không bắt buộc. Mặt nạ chứa các loại nguồn sẽ trả về trong lần đọc thay đổi bài đăng. Giá trị mặc định là READ_SOURCE_TYPE_CONTACT và READ_SOURCE_TYPE_PROFILE nếu không được đặt.

Nội dung phản hồi

Nếu không thành công, hàm sẽ trả về BatchCreateContactsErrorDetails chứa danh sách lỗi cho mỗi người liên hệ không hợp lệ.

Phản hồi cho yêu cầu tạo một loạt địa chỉ liên hệ.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "createdPeople": [
    {
      object (PersonResponse)
    }
  ]
}
Trường
createdPeople[]

object (PersonResponse)

Danh bạ đã được tạo, trừ khi yêu cầu readMask trống.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.

ContactToCreate

Một trình bao bọc chứa dữ liệu về người dùng để điền vào một nguồn mới tạo.

Biểu diễn dưới dạng JSON 
{
  "contactPerson": {
    object (Person)
  }
}
Trường
contactPerson

object (Person)

Bắt buộc. Dữ liệu về người dùng để điền sẵn một nguồn mới tạo.