服务端 API/通讯录/自定义用户字段/概述
#  自定义用户字段 Custom user fields 资源概述

##  资源定义
由企业自定义的用户字段，用于不同企业基于自身管理诉求灵活表征用户信息，自定义字段由[企业管理员](https://www.larksuite.com/hc/zh-CN/articles/360048488029)在[企业管理后台 - 组织架构 - 成员字段管理](https://www.larksuite.com/admin/contacts/employee-field-new/custom) 里进行创建、更新操作，可以通过接口可获取企业的所有自定义字段。

![image.png](//sf16-sg.larksuitecdn.com/obj/open-platform-opendoc-sg/e6800efa88ea61103ac231e092ce52f9_z0kACWCTj9.png?lazyload=true&width=1640&height=776)

![image.png](//sf16-sg.larksuitecdn.com/obj/open-platform-opendoc-sg/69c13775666697ce31b179fb2d0bb659_7tb2K7PuJE.png?lazyload=true&width=1640&height=933)

##  字段说明

名称 | 类型 | 描述
---|---|---
items | custom_attr\[\] | 自定义字段定义
  ∟ id | string | 自定义字段id
&emsp;&emsp;∟&nbsp;type | string | 自定义字段类型，可选值有:<br>- `TEXT`：纯文本，用于纯文本描述人员，如备注<br>- `HREF`：静态 URL，用于人员 Profile 跳转链接<br>- `ENUMERATION`：枚举，用于结构化描述人员，如民族<br>- `GENERIC_USER`：用户，用于描述人和人关系，如 HRBP<br>- `PICTURE_ENUM`：枚举图片，以结构化的图片描述人员，如在人员 Profile 展示荣誉徽章
&emsp;&emsp;∟&nbsp;options | custom_attr_options | 选项定义，当type为`ENUMERATION`或者`PICTURE_ENUM`时此项有值，列举所有可选项
&emsp;&emsp;&emsp;∟&nbsp;default_option_id | string | 默认选项id
&emsp;&emsp;&emsp;∟&nbsp;option_type | string | 选项类型<br>**可选值有**：<br>- `TEXT`：文本选项<br>- `PICTURE`：图片选项
&emsp;&emsp;&emsp;∟&nbsp;options | custom_attr_option\[\] | 选项列表
&emsp;&emsp;&emsp;&emsp;∟&nbsp;id | string | 枚举类型选项id
&emsp;&emsp;&emsp;&emsp;∟&nbsp;value | string | 枚举选项值，当option_type为`TEXT`为文本值，当option_type为`PICTURE`时为图片链接
&emsp;&emsp;&emsp;&emsp;∟&nbsp;name | string | 名称，仅option_type为PICTURE时有效
&emsp;&emsp;∟&nbsp;i18n_name | i18n_content\[\] | 自定义字段的字段名称
&emsp;&emsp;&emsp;∟&nbsp;locale | string | 语言版本
&emsp;&emsp;&emsp;∟&nbsp;value | string | 字段名
&emsp;∟&nbsp;page_token | string | 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token
&emsp;∟&nbsp;has_more | boolean | 是否还有更多项

###  数据示例
```json
 "items": [
     {
		"id": "C-6965457429001748507",
		"type": "TEXT",
		"options": {
			"default_option_id": "qasdefgr",
			"option_type": "TEXT",
			"options": [
				{
					"id": "qasdefgr",
					"value": "Option",
					"name": "Name"
				}
			]
		},
		"i18n_name": [
			{
				"locale": "zh_cn",
				"value": "专家"
			}
		]
    }
]
```