跳转至

custom_fields

feishu.directory.custom_fields

custom_field_text

Python
custom_field_text(value: Any) -> str

从 Directory 自定义字段的 text_value 取出一段纯文本。

支持裸字符串，或飞书的 {default_value, i18n_value} 结构。不解释字段业务含义。

源代码位于： feishu/directory/custom_fields.py
Python
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
def custom_field_text(value: Any) -> str:
    r"""
    从 Directory 自定义字段的 `text_value` 取出一段纯文本。

    支持裸字符串，或飞书的 `{default_value, i18n_value}` 结构。不解释字段业务含义。
    """
    if isinstance(value, str):
        return value.strip()
    if not isinstance(value, dict):
        return ""
    default = str(value.get("default_value") or "").strip()
    if default:
        return default
    translations = value.get("i18n_value") or {}
    if not isinstance(translations, dict):
        return ""
    for locale in ("en_us", "zh_cn", "ja_jp"):
        translated = str(translations.get(locale) or "").strip()
        if translated:
            return translated
    return next((str(item).strip() for item in translations.values() if str(item).strip()), "")

custom_fields_by_key

Python
custom_fields_by_key(base_info: Mapping[str, Any]) -> dict[str, str]

将 base_info.custom_field_values 展成 {field_key: text}。

调用方自行把 field_key 映射到业务名；SDK 不内置任何租户字段表。

源代码位于： feishu/directory/custom_fields.py
Python
51
52
53
54
55
56
57
58
59
60
61
62
63
64
def custom_fields_by_key(base_info: Mapping[str, Any]) -> dict[str, str]:
    r"""
    将 `base_info.custom_field_values` 展成 `{field_key: text}`。

    调用方自行把 `field_key` 映射到业务名；SDK 不内置任何租户字段表。
    """
    values: dict[str, str] = {}
    for raw in base_info.get("custom_field_values") or []:
        if not isinstance(raw, dict):
            continue
        key = str(raw.get("field_key") or "").strip()
        if key:
            values[key] = custom_field_text(raw.get("text_value"))
    return values