Method: contactGroups.members.modify

修改经过身份验证的用户所拥有的联系人群组的成员。

唯一可以添加成员的系统联系人群组只有 contactGroups/myContacts 和 contactGroups/starred。其他系统联系人群组已被弃用，只能移除联系人。

HTTP 请求

POST https://people.googleapis.com/v1/{resourceName=contactGroups/*}/members:modify

网址采用 gRPC 转码语法。

路径参数

参数
resourceName

string

必需。要修改的联系人群组的资源名称。

请求正文

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

JSON 表示法 
{
  "resourceNamesToAdd": [
    string
  ],
  "resourceNamesToRemove": [
    string
  ]
}
字段
resourceNamesToAdd[]

string

可选。要添加的联系人的资源名称，格式为 people/{person_id}。resourceNamesToAdd 和 resourceNamesToRemove 中的资源名称总数不得超过 1000。
resourceNamesToRemove[]

string

可选。要移除的联系人的资源名称，格式为 people/{person_id}。resourceNamesToAdd 和 resourceNamesToRemove 中的资源名称总数不得超过 1000。

响应正文

对修改联系人群组成员请求的响应。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "notFoundResourceNames": [
    string
  ],
  "canNotRemoveLastContactGroupResourceNames": [
    string
  ]
}
字段
notFoundResourceNames[]

string

未找到的联系人资源名称。
canNotRemoveLastContactGroupResourceNames[]

string

无法从最后一个联系人群组中移除的联系人资源名称。

授权范围

需要以下 OAuth 范围：

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

有关详情，请参阅授权指南。