Method: otherContacts.copyOtherContactToMyContactsGroup

复制“其他联系人”与用户的“myContacts”中的新联系人共享群组

应按顺序发送针对同一用户的 mutate 请求,以避免延迟时间增加和失败增加。

HTTP 请求

POST https://people.googleapis.com/v1/{resourceName=otherContacts/*}:copyOtherContactToMyContactsGroup

网址采用 gRPC 转码语法。

路径参数

参数
resourceName

string

必需。“其他联系人”的资源名称复制的模板。

请求正文

请求正文中包含结构如下的数据:

JSON 表示法
{
  "copyMask": string,
  "readMask": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
字段
copyMask

string (FieldMask format)

必需。用于限制将哪些字段复制到新联系人的字段掩码。有效值包括:

  • emailAddresses
  • 名字
  • phoneNumbers
readMask

string (FieldMask format)

可选。用于限制返回相应人员哪些字段的字段掩码。可以指定多个字段,只需用逗号分隔即可。如果未设置,则默认为包含元数据和成员资格字段的复制掩码。有效值包括:

  • addresses
  • ageRanges
  • 传记
  • 生日
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • 活动
  • externalIds
  • 性别
  • imClients
  • 兴趣
  • locales
  • 地理位置
  • memberships
  • 元数据
  • miscKeywords
  • 名字
  • 昵称
  • 职业
  • 组织
  • phoneNumbers
  • 照片
  • 关系
  • sipAddresses
  • skills
  • 网址
  • userDefined
sources[]

enum (ReadSourceType)

可选。要返回的来源类型的掩码。如果未设置,则默认为 READ_SOURCE_TYPE_CONTACTREAD_SOURCE_TYPE_PROFILE

响应正文

如果成功,则响应正文包含一个 Person 实例。

授权范围

需要以下 OAuth 范围之一:

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

有关详情,请参阅授权指南