创建由经过身份验证的用户拥有的新联系人群组。
您为联系人群组创建的联系人群组名称必须是独一无二的。尝试使用重复名称创建群组将返回 HTTP 409 错误。
应按顺序发送同一用户的 mutate 请求,以避免延迟时间增加和失败。
HTTP 请求
POST https://people.googleapis.com/v1/contactGroups
网址采用 gRPC 转码语法。
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{
"contactGroup": {
object ( |
字段 | |
---|---|
contactGroup |
必需。要创建的联系人群组。 |
readGroupFields |
可选。用于限制返回组中哪些字段的字段掩码。如果未设置或为空,则默认设置为
|
响应正文
如果成功,响应正文将包含一个新创建的 ContactGroup
实例。
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/contacts
有关详情,请参阅授权指南。