可能原因:
1.没有添加查询的自定义字段
2.自定义字段设置了权限
用户自定义字段介绍:
自定义资料字段是各 App 根据各自业务需要而设置的用户数据。通过自定义资料,各 App 可以将一些额外数据附加到用户资料上,并通过现有接口进行读写操作。
自定义资料字段的申请
App 管理员可以通过即时通信 IM 控制台>【应用配置】>【功能配置】 申请自定义资料字段,申请提交后,自定义资料字段将在5分钟内生效。 申请自定义资料字段时,需要为每一个自定义资料字段提交如下资料:
- 自定义资料字段的名称(Key):详情可参见 自定义资料字段的命名规范
- 自定义资料字段的类型(Value):详情可参见 资料字段
- 自定义资料字段的读权限及写权限:详情可参见 资料字段
自定义资料字段的命名规范
自定义资料字段的命名规则如下:
- 自定义资料字段的名称包括前缀和关键字两部分。
- 自定义资料字段的前缀是:Tag_Profile_Custom。
- 关键字:必须是英文字母,且长度不得超过8字节,建议用一个英文单词或该英文单词的缩写。
- 示例:某 App 要申请的自定义字段的关键字是 Test,则自定义资料字段的名称是:Tag_Profile_Custom_Test。
排查步骤:
1.问题详情:
按照拉取资料(https://cloud.tencent.com/document/product/269/1639) 接口请求包体请求的
报错信息如下:
"ErrorCode": 40007,
"ErrorInfo": "Err_Profile_Forbiden_By_Read_Priv:Tag_Profile_Custom_Test",
2.自己调用排查:
用REST API联调工具排查如下https://avc.cloud.tencent.com/im/APITester/APITester.html#v4/profile/portrait_get
按照文档的请求包体操作:
看报错提示自定义字段没有权限,去掉"Tag_Profile_Custom_Test"此字段返回正常。
查看资料管理(https://cloud.tencent.com/document/product/269/1500) 需要控制台设置自定义字段并且赋予权限。
这里添加了两个字段并赋予了管理员权限:
再次调用查询成功:
建议:
此类问题最好详细看下官网说明。
群维度的自定义字段介绍和操作:
即时通信 IM 支持 App 根据业务需求,在群组和群成员两个维度上设置自定义字段。群组维度最多支持20个字段,群成员维度最多支持5个字段。利用自定义字段,App 可以将一些额外数据附加到群组之上,并可以通过现有接口进行读写操作。自定义字段设置并使用后无法删除。
1.在控制台添加群自定义字段和群成员自定义字段
这里是添加的所有群类型的自定义字段,实际操作可根据业务需求添加。
2.获取自定义字段
调用接口:获取群详细资料(https://cloud.tencent.com/document/product/269/1616)
3.设置自定义字段的值
先设置群自定义字段的值,调用接口:修改群基础资料(https://cloud.tencent.com/document/product/269/1620)
再设置群成员自定义字段的值,调用接口:修改群成员资料(https://cloud.tencent.com/document/product/269/1623)
4.查询下自定义字段的值
重复第二步操作,结果图如下: