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

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