- 资源:ContactGroup
          <ph type="x-smartling-placeholder">- </ph>
            
- JSON 表示法
 
- ContactGroupMetadata
          <ph type="x-smartling-placeholder">- </ph>
            
- JSON 表示法
 
- GroupType
- GroupClientData
          <ph type="x-smartling-placeholder">- </ph>
            
- JSON 表示法
 
- 方法
资源:ContactGroup
联系人群组。
| JSON 表示法 | 
|---|
| { "resourceName": string, "etag": string, "metadata": { object ( | 
| 字段 | |
|---|---|
| resourceName | 
 联系人群组的资源名称,由服务器分配。ASCII 字符串,格式为  | 
| etag | 
 资源的 HTTP 实体标记。用于网络缓存验证。 | 
| metadata | 
 仅限输出。联系人群组的元数据。 | 
| groupType | 
 仅限输出。联系人群组类型。 | 
| name | 
 由群组所有者设置的联系人群组名称,或系统群组为系统提供的名称。 对于  | 
| formattedName | 
 仅限输出。根据查看者的账号语言区域或系统群组名称的  | 
| memberResourceNames[] | 
 仅限输出。属于联系人群组联系人的联系人资源名称列表。系统只会针对 GET 请求填充此字段,并且在 get 请求中仅返回与  | 
| memberCount | 
 仅限输出。群组中的联系人总数,与请求中指定的成员数量上限无关。 | 
| clientData[] | 
 该群组的客户数据。 | 
ContactGroupMetadata
联系人群组的元数据。
| JSON 表示法 | 
|---|
| { "updateTime": string, "deleted": boolean } | 
| 字段 | |
|---|---|
| updateTime | 
 仅限输出。上次更新群组的时间。 时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例: | 
| deleted | 
 仅限输出。如果联系人群组资源已被删除,则为 true。仅为包含同步令牌的  | 
GroupType
一种联系人群组类型。
| 枚举 | |
|---|---|
| GROUP_TYPE_UNSPECIFIED | 未指定。 | 
| USER_CONTACT_GROUP | 用户定义的联系人群组。 | 
| SYSTEM_CONTACT_GROUP | 系统定义的联系人群组。 | 
GroupClientData
由客户端填充的任意客户端数据。允许重复的键和值。
| JSON 表示法 | 
|---|
| { "key": string, "value": string } | 
| 字段 | |
|---|---|
| key | 
 客户端数据的客户端指定键。 | 
| value | 
 客户端指定的客户端数据值。 | 
| 方法 | |
|---|---|
| 
 | 通过指定联系人群组资源名称列表,获取经过身份验证的用户拥有的联系人群组列表。 | 
| 
 | 创建由经过身份验证的用户拥有的新联系人群组。 | 
| 
 | 通过指定联系人群组资源名称,删除经过身份验证的用户拥有的现有联系人群组。 | 
| 
 | 通过指定联系人群组资源名称,获取经过身份验证的用户拥有的特定联系人群组。 | 
| 
 | 列出经过身份验证的用户拥有的所有联系人群组。 | 
| 
 | 更新经过身份验证的用户拥有的现有联系人群组的名称。 |