- 资源: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 | 
                
                   
 客户端指定的客户端数据值。  | 
              
方法 | 
            |
|---|---|
                
 | 
              通过指定联系人群组资源名称列表,获取经过身份验证的用户拥有的联系人群组列表。 | 
                
 | 
              创建由经过身份验证的用户拥有的新联系人群组。 | 
                
 | 
              通过指定联系人群组资源名称,删除经过身份验证的用户拥有的现有联系人群组。 | 
                
 | 
              通过指定联系人群组资源名称,获取经过身份验证的用户拥有的特定联系人群组。 | 
                
 | 
              列出经过身份验证的用户拥有的所有联系人群组。 | 
                
 | 
              更新经过身份验证的用户拥有的现有联系人群组的名称。 |