---
title: 世界数据管理
slug: world-sdk-guide-ch/viNFgBFvwHA_-BHpj9e8W
docTags: 
createdAt: 2024-09-02T08:34:13.134Z
---

您可以通过世界数据管理功能查看和更改用户数据。

:::hint{type="danger"}
**❗️ 注意**
世界开发者必须添加自己的API才能使用该功能。
请参考以下指南了解如何添加API。\[[多人世界数据存储](docId\:tlOLhCWEokjPzYT-v2F4H)]
:::



## 数据管理

您可以在每个世界控制台的“数据管理”菜单中访问和编辑世界的数据库。

数据管理中总共有4个项目。所有项目都是根据使用相应世界的用户ID搜索用户特定的信息。

- 数据管理: \[[多重世界数据存储](docId\:tlOLhCWEokjPzYT-v2F4H)] 允许您查看和编辑保存的用户信息。
- 库存: 您可以查看和编辑与在“产品”菜单中创建的物品/物品包/货币包相关的用户信息。
- 余额: 您可以查看和编辑与在“货币”菜单中创建的货币相关的用户信息。
- 产品支付历史（ZEM）: 您可以查看世界中每个支付交易的产品支付历史和收据ID。



![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-HIoMOjODKoERy8iVmB106-20240904-102410.png)



:::hint{type="danger"}
**❗️ 注意**
链接的世界数据是从评审完成后发布时记录的。
:::



## 数据存储

\[[多重世界数据存储](docId\:tlOLhCWEokjPzYT-v2F4H)] 允许您查看保存的用户信息。

- 用于搜索的 ZEPETO ID 可以在应用程序中的用户资料中找到。
- 搜索数据的标准时间会显示，如果用户正在玩，数据会继续变化。此时，您可以通过日期旁边的刷新按钮或刷新 (F5) 将数据更新到最新。



![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-_jDN1GRCXefTxdBfeCvKE-20240904-102410.png)



![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-kwAzTrDVfpjmV259hi3c3-20240904-102410.png)



- 每个存储的数据以键/值的形式存储，可以通过更改键进行搜索。
- 在键列表中，仅暴露实际存储在相应用户数据库中的键值。
- 您还可以搜索和更改键值。



- 如果您按右侧的“编辑”按钮，它将转换为编辑状态。在编辑状态下，保存的值可以自由更改。
- 在编辑过程中，关键值不能更改。
- 编辑后，保存数据以实际反映。如果编辑时的数据与实际用户的数据不同，将生成警告消息。



:::hint{type="danger"}
**❗️ 注意**

- 如果以下规则不满足，数据将无法正常保存。
  - 如果没有值
  - 当输入无法存储在值中的值时
- 数据存储限制
  - 键长度限制：50个字符
    - 键中只允许字母、数字和下划线（\_）
  - 每个用户ID的最大键数：1000
  - 最大值数据大小：500,000个字符
    - 请注意，当值数据存储在实际服务器上时，它与内部标识符一起序列化。请考虑这一点，并留有安全余地使用。
- 数据存储API调用限制
  - 获取（每分钟）：200次
  - 设置（每分钟）：200次
:::

:::hint{type="danger"}
**❗️ 注意**
如果用户在实时世界中玩耍，数据被覆盖的风险很高。在点击保存按钮之前，请务必检查！
:::



## 库存

您可以查看和编辑与在“产品”菜单中创建的物品/物品包/货币包相关的用户信息。

- 用于搜索的ZEPETO ID可以在应用程序中的用户资料中找到。
- 搜索数据的标准时间会显示，如果用户正在玩，数据会持续变化。这时，您可以通过日期旁边的刷新按钮或刷新（F5）将数据更新到最新。
- ID：存储物品的唯一ID值
- 名称：保存物品的名称
- 数量：存储物品的数量（最多2,147,483,647）
- 更新：物品信息更新的日期

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-Wut_sxz-RtdqNanwuzw8S-20240904-102410.png)



:::hint{type="success"}
**👍 **每条信息都可以编辑，因此管理员可以随意修改数据库中输入的值。然而，您可以一次批量编辑最多100条数据。
:::



:::hint{type="info"}
**📘 **请参考以下指南。 \[[多重世界数据存储](docId\:tlOLhCWEokjPzYT-v2F4H)]
:::



在库存中搜索用户 ZEPETO ID 时，用户数据库屏幕显示如下历史记录。



- 您可以按添加按钮添加一个未保存在数据库中的新项目。然而，只有预先创建的产品可以作为新产品添加。
- 切换到编辑模式时，按钮不会出现。



![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-YSgKi_AR9cwHy6SGN-zcP-20240904-102410.png)

**日志**

- 您可以在日志菜单中查看实时数据库中所做的所有编辑。
  - 您可以一次搜索最多90天的数据。
    - 可以查看2023年创建的数据。



![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-5X82IN6gYzQZggWJJmvpt-20240904-102410.png)



在库存中点击日志历史按钮，然后点击右上角的下载按钮，将特定日期的所有日志下载为Excel文件。

- 最多只能下载100,000次浏览。



![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-mWF6v6Rypibld5eZD90A7-20240904-102411.png)



## 余额

在“货币”菜单中，您可以查看和编辑与创建的货币相关的用户信息。

- 用于搜索的ZEPETO ID可以在应用程序中的用户资料中找到。
- 搜索数据的标准时间会显示，如果用户正在玩，数据会持续变化。此时，您可以通过日期旁边的刷新按钮或刷新（F5）将数据更新到最新。
- ID：保存的货币的唯一ID值
- 名称：保存的货币的名称
- 数量：存储的货币数量（最多2,147,483,647）
- 更新：货币信息更新的日期

:::hint{type="success"}
**👍 **每条信息都可以编辑，因此管理员可以随意修改输入到数据库中的值。然而，您可以一次批量编辑最多100条数据。
:::



![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-THjTvIneAoDFSxWJksNDU-20240904-102410.png)



:::hint{type="info"}
**📘 **请参考以下指南。 \[[货币化您的世界！设置产品和货币](docId\:Uw6k8dr1wHl1WgQBlq64g)]
:::



在余额中搜索用户ZEPETO ID时，显示如下的用户数据库屏幕及历史记录。

- 您可以按添加按钮添加一个未保存在数据库中的新项目。然而，只有预先创建的货币可以作为新货币添加。
- 切换到编辑模式时，按钮不会出现。



![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-f_z9lW6ouBvYTBfDDP00J-20240904-102411.png)

**日志**

- 您可以在日志菜单中检查实时数据库中所做的所有编辑。
  - 您可以一次搜索最多90天。
    - 可以查看2023年创建的数据。
- 收据ID仅在付款完成时记录。未在此处记录的付款为未成功付款。
- 您可以一次搜索最多90天。

:::hint{type="success"}
**👍 **通过利用产品付款历史，您可以确定用户的产品交易是否在现实中实际进行，并回应相关查询。
:::

- 日期：日志留下的日期
- 收据ID：收据的ID
- 产品ID：购买的产品ID
- ZEM：购买时支付的产品的ZEM

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-12JuBXQ4Jttqa8VtSYUXz-20240904-102411.png)



点击销售历史（ZEM）右上角的下载按钮，将指定日期的所有日志下载为Excel文件。

- 最多只能下载100,000次查看。



![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-egWyQYNBJDljP0D3AuuQp-20240904-102410.png)