# 自定义用户字段资源介绍
自定义用户字段的作用是方便企业基于自身的管理诉求，灵活设计用户信息。当用户默认包含的属性字段不满足企业管理组织架构所需时，企业可以为用户添加自定义字段。
## 资源类型
自定义用户字段分为多种类型，各类型说明如下表所示。
类型 | 描述
---|---
文本类型 | 纯文本的用户属性。
网页类型 | 包含文本和跳转链接的用户属性，设置该类型的用户属性时，需要设置网页标题（文本）和网页地址（URL），其中支持为桌面端设置独立的网页地址。
枚举类型 | 包含一个或多个选项的用户属性，例如 **员工类型** 字段，可以设置正式、外包、顾问等企业成员类型枚举值。当为用户设置属性时，可以在这些枚举值中选择。
图片类型 | 该类型与枚举类型相似，不同的是对应的选项数据必须是图片数据，用于在成员名片页展示其对应的图片。例如展示用户获取的勋章图标等。
**注意事项**：**说明**：图片类型内测中，如需了解可咨询开放平台技术支持。
用户类型 | 该类型主要用于在成员名片页展示对企业其他人员的引用信息，从而实现成员名片页之间的跳转。例如将 **张三** 的 HRBP 字段展示为 **李四**，并支持点击跳转至李四的名片页。
## 使用说明
目前，通讯录 API 仅支持查询企业自定义用户字段。如需管理企业的自定义字段，则需要企业管理员登录[管理后台](https://feishu.cn/admin/index)，在 **组织架构** > **字段管理** 页面进行管理操作。相关操作说明，可参见[配置自定义字段](https://www.feishu.cn/hc/zh-CN/articles/973209819304#tabs0|lineguid-78X2n)。
如果在调用通讯录 API 时需要使用到自定义用户字段，则需要企业管理员登录[管理后台](https://feishu.cn/admin/index)，在 **组织架构** > **字段管理** 页面，进入 **字段设置** > **自定义字段** 页签内，点击 **API 调用设置**，并开启 **允许开放平台通讯录 API 调用** 开关。
## 字段说明
名称 | 类型 | 描述
---|---|---
items | custom_attr\[\] | 自定义字段信息。
∟ id | string | 自定义字段 ID。
∟ type | string | 自定义字段类型。可选值有:
- `TEXT`：文本类型
- `HREF`：网页类型
- `ENUMERATION`：枚举类型
- `GENERIC_USER`：用户类型
- `PICTURE_ENUM`：图片类型
∟ options | custom_attr_options | 选项定义，当 type 取值为 `ENUMERATION` 或者 `PICTURE_ENUM` 时此项有值，用于列举所有可选项。
∟ default_option_id | string | 默认选项 ID。
∟ option_type | string | 选项类型。可选值有：
- `TEXT`：文本选项
- `PICTURE`：图片选项
∟ options | custom_attr_option\[\] | 选项列表
∟ id | string | 枚举类型选项 ID。
∟ value | string | 选项值。
- 当 option_type 为 `TEXT` 时，取值为文本值。
- 当 option_type 为 `PICTURE` 时，取值为图片链接。
∟ name | string | 图片名称，仅 option_type 为 `PICTURE`时有值。
∟ i18n_name | i18n_content\[\] | 自定义字段的字段名称。
∟ locale | string | 语言版本。
∟ value | string | 字段名。
## 数据示例
```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": "专家"
}
]
}
]
```