Method: contactGroups.create

创建由经过身份验证的用户拥有的新联系人群组。

创建的联系人群组名称对用户联系人群组必须是唯一的。尝试使用重复名称创建群组将返回 HTTP 409 错误。

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

HTTP 请求

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

网址采用 gRPC 转码语法。

请求正文

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

JSON 表示法 
{
  "contactGroup": {
    object (ContactGroup)
  },
  "readGroupFields": string
}
字段
contactGroup

object (ContactGroup)

必需。要创建的联系人群组。
readGroupFields

string (FieldMask format)

可选。字段掩码，用于限制返回组上的哪些字段。如果未设置或留空，则默认为 metadata、groupType 和 name。有效字段包括：

  • clientData
  • groupType
  • 元数据
  • name

响应正文

如果成功，响应正文将包含一个新创建的 ContactGroup 实例。

授权范围

需要以下 OAuth 范围：

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

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