- Yêu cầu HTTP
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- ContactToCreate (Tạo)
- Hãy làm thử!
Tạo một loạt địa chỉ liên hệ mới và trả về PersonResponse cho
Bạn phải gửi 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 ( |
Trường | |
---|---|
contacts[] |
Bắt buộc. Địa chỉ liên hệ cần tạo. Cho phép tối đa 200 người liên hệ trong một yêu cầu duy nhất. |
readMask |
Bắt buộc. Mặt nạ trường (field mask) để hạn chế những trường của 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 để trống mặt nạ đọc, thì hàm sau biến đổi 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à:
|
sources[] |
Không bắt buộc. Mặt nạ cho biết các loại nguồn cần trả về khi đọc thay đổi bài đăng. Giá trị mặc định là |
Nội dung phản hồi
Nếu không thành công, hãy trả về BatchCreateContactsErrorDetails
chứa danh sách lỗi của từng địa chỉ liên hệ không hợp lệ.
Phản hồi cho yêu cầu tạo một loạt danh bạ.
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 ( |
Trường | |
---|---|
createdPeople[] |
Các mục liên hệ đã được tạo, trừ phi yêu cầu |
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 bài viết Hướng dẫn uỷ quyền.
ContactToCreate
Một trình bao bọc chứa dữ liệu người dùng để điền nguồn mới tạo.
Biểu diễn dưới dạng JSON |
---|
{
"contactPerson": {
object ( |
Trường | |
---|---|
contactPerson |
Bắt buộc. Dữ liệu người để điền một nguồn mới tạo. |