Method: otherContacts.copyOtherContactToMyContactsGroup

Sao chép "Người liên hệ khác" vào một người liên hệ mới trong nhóm "myDanh bạ" của người dùng

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/{resourceName=otherContacts/*}:copyOtherContactToMyContactsGroup

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

Tham số đường dẫn

Thông số
resourceName

string

Bắt buộc. Tên tài nguyên của "Người liên hệ khác" cần sao chép.

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 
{
  "copyMask": string,
  "readMask": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
Trường
copyMask

string (FieldMask format)

Bắt buộc. Mặt nạ trường (field mask) để hạn chế những trường được sao chép vào địa chỉ liên hệ mới. Các giá trị hợp lệ là:

  • emailAddresses
  • names
  • phoneNumbers
readMask

string (FieldMask format)

Không bắt buộc. Mặt nạ trường (field mask) để hạn chế những trường trên người được trả về. 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. Mặc định là mặt nạ sao chép có siêu dữ liệu và các trường thành viên nếu bạn không đặt. Các giá trị hợp lệ là:

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

enum (ReadSourceType)

Không bắt buộc. Mặt nạ cho biết các loại nguồn cần trả về. 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 thành công, nội dung phản hồi sẽ chứa một phiên bản của Person.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau đây:

  • https://www.googleapis.com/auth/contacts.other.readonly
  • 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.