Docs 主页 → 开发应用程序 → Atlas Device SDKs
自定义用户数据 — Swift SDK
读取用户的自定义数据
您可以通过当前登录用户的 User对象读取该用户的自定义用户数据。您无法通过User对象编辑自定义用户数据。要编辑自定义用户数据，请参阅更新自定义用户数据。要读取数据，请访问已登录用户的User对象上的customData属性：
警告
自定义数据可能已过时
当基础数据发生变化时，Atlas App Services 不会立即动态更新客户端用户自定义数据文档的值。相反，每当用户刷新其访问令牌时，App Services 都会获取最新版本的自定义用户数据，而大多数联系 App Services 后端的 SDK 操作都会使用该令牌。如果令牌在其默认30分钟到期时间之前未刷新，则 Swift SDK 会在下次调用后端时刷新令牌。自定义用户数据可能会过时长达30分钟，加上 SDK 下次调用后端之前的时间。
注意
如果您需要最新版本的自定义用户数据，请使用refreshCustomDataWithCompletion方法请求最新版本的用户自定义数据。
创建用户的自定义数据文档
要为用户创建自定义用户数据，请在自定义用户数据集合中创建 MongoDB 文档。 文档的用户 ID 字段应包含用户的用户 ID。
提示
在 App Services 用户界面中，检查Custom User Data标签页下的 App Users页面，查找并配置自定义用户数据设置，包括：
自定义用户数据集群、数据库和collection
用于将自定义用户数据文档映射到用户的用户 ID 字段
以下示例使用MongoDB 远程访问将包含当前登录用户的用户ID和favoriteColor值的文档插入自定义用户数据集合：
在创建自定义用户数据文档时，您可以向其中添加任意数量的字段和值。用户 ID 字段是文档要在User对象上作为自定义用户数据使用的唯一要求。
更新用户的自定义数据
您可以使用MongoDB Data Access 、 Atlas Device Sync 、 MongoDB Compass或MongoDB Atlas Data Explorer 更新自定义用户数据。
要使用 MongoDB 数据访问更新用户的自定义用户数据，请编辑其用户 ID 字段包含该用户的用户 ID 的 MongoDB 文档。 以下示例使用MongoDB 数据访问来更新包含自定义用户数据集合中当前登录用户的用户 ID 的文档的favoriteColor字段：
提示
要确定用户的 ID，请访问User.id属性或在Users标签页下App Users页面上的 App Services 用户界面中查找该用户。