即时通信 IM 资料管理

一、资料系统简介

·即时通信 IM 提供资料的存储能力，确保你的数据具备异地容灾、多地部署和自动扩容/缩容的能力，帮助你从服务器宕机、多拷贝主从复制和扩容缩容等复杂处理流程中得到完全地解放。

·即时通信 IM 提供业界通用的业务处理流程，帮助你在用户资料的业务逻辑上彻底地解放。

·即时通信 IM 提供专业的运营流程和运营团队，保障99.9%的稳定服务质量，帮助你为用户提供具有稳定口碑的服务。

·即时通信 IM 提供简单易用的服务接口和快捷接入的帮助指引，全程为你提供星级服务。

使用即时通信 IM 的资料托管服务，可以得到以下能力：

·标配资料字段的存储、读写能力。

·自定义资料字段的存储、读写能力。

二、资料字段

资料是用来描述用户属性的一组数据，即时通信 IM 资料系统支持标配资料字段和自定义资料字段。资料字段有如下特性：

·资料字段通过 Key-Value 来表示。

·Key 为 String 类型，其命名仅支持英文大小写字母、数字、下划线。

·Value 有以下几种类型：
a. uint32_t 类型的整数（自定义资料字段不支持）。
b. uint64_t 类型的整数（自定义资料字段不支持）。
c. string 类型的字符串（string 的长度不得超过500字节）。
d. bytes 类型的一段 buffer（buffer 的长度不得超过500字节）。

三、标配资料字段

目前即时通信 IM 支持的标配资料字段如下：

四、自定义资料字段

自定义资料字段是各 App 根据各自业务需要而设置的用户数据。通过自定义资料，各 App 可以将一些额外数据附加到用户资料上，并通过现有接口进行读写操作。

五、自定义资料字段的申请

App 管理员可以通过 即时通信 IM 控制台> 消息服务Chat >功能配置 > 用户自定义字段，单击新增，在页面配置后单击确定，申请提交后，自定义资料字段将在10分钟内生效。

申请自定义资料字段时，需要为每一个自定义资料字段提交如下资料：

·自定义资料字段的名称（Key）：详情可参见 自定义资料字段的命名规范

·自定义资料字段的类型（Value）：详情可参见 资料字段

六、自定义资料字段的命名规范

自定义资料字段的命名规则如下：

·自定义资料字段的名称包括前缀和关键字两部分。

·自定义资料字段的前缀是：Tag_Profile_Custom。

·关键字：必须是英文字母，且长度不得超过8字符，建议用一个英文单词或该英文单词的缩写。

·示例：某 App 要申请的自定义字段的关键字是 Test，则自定义资料字段的名称是：Tag_Profile_Custom_Test。

七、相关文档

·用户资料与关系链（Android）

·用户资料与关系链（iOS）

·用户资料（Web & 小程序 & uni-app）