管理您在[創作者商店](/production/creator-store)的存在。[創建](#Cloud_CreateCreatorStoreProduct)和[更新](#Cloud_UpdateCreatorStoreProduct)資產的產品列表，並[搜尋工具箱](#Toolbox_SearchCreatorStoreAssets)以使用各種過濾器查詢資產。

音頻文件的持續時間（以秒為單位）。

特定於音頻的搜索過濾器參數。

要包含的音頻類型（例如音樂、音效）

音頻的最大持續時間（以秒為單位）。如果包含，必須大於或等於 1。

音頻的最小持續時間（以秒為單位）。如果包含，必須大於或等於 0。

批量刪除保存操作的響應模型。

目前不支持自定義集合。
此字段應省略。

已棄用：請參考 'userId' 和 'groupId' 屬性。
創建者類型和 ID。例如用戶/123 或組/456。

群組 ID。如果資產是群組擁有，則必需。

此值僅存在於基於群組的創建者中，表示最近更新資產的創建者的用戶 ID。

此值僅存在於基於群組的創建者中，表示最近更新資產的創建者的名稱。

創建者的用戶 ID。當資產是個別用戶擁有時必需。

表示模型具有的能力（例如沙盒）。
僅對模型資產類型存在；當可用時，AMRS 在響應中包括它。

控制在插入時是否會對具有腳本的模型進行沙盒。

表示創建者商店中的一個產品。此資源用於管理資產在創建者商店中的分發和定價。

創建者商店產品是具有此資產 ID 的音頻文件。

創建者商店產品是具有此資產 ID 的貼圖。

創建者商店產品是具有此資產 ID 的字體系列。

創建者商店產品是具有此資產 ID 的網格部件。

創建者商店產品是具有此資產 ID 的模型。

創建者商店產品的資源路徑。

格式： `creator-store-products/{creator_store_product_id}`

創建者商店產品是具有此資產 ID 的插件。

支持的基礎價格（以美元計）：$0、$4.99、$5.99、$6.99、$7.99、$8.99、
$9.99、$10.99、$11.99、$12.99、$13.99、$14.99、$15.99、$16.99、$17.99、
$18.99、$19.99、$24.99、$29.99、$34.99、$39.99、$44.99、$49.99、$59.99、
$69.99、$79.99、$89.99、$99.99、$149.99、$199.99、$249.99

賣方是否打算在創建者商店中分發創建者商店產品。賣方可能打算分發產品，但由於賣方或基礎創建者商店產品的某些限制，產品可能無法購買。請參見
`restrictions` 和 `purchasable` 獲取更多詳細信息。

該產品是否可以購買。

要使此值為真，`published` 必須為真，且 `restrictions` 必須為空。如果此值為假，則任何用戶均無法獲得該產品。

應用於產品的限制。一個產品可以同時具有多個活動限制。

可能的值：

  | 值 | 描述 |
  | --- | --- |
  | RESTRICTION_UNSPECIFIED | 未指定的限制。 |
  | SOLD_ITEM_RESTRICTED | 出售的物品已被 Roblox 限制。詳細信息可以通過直接查找該物品獲得。 |
  | SELLER_TEMPORARILY_RESTRICTED | 產品被限制，因為賣方的帳戶暫時受到 Roblox 限制。 |
  | SELLER_PERMANENTLY_RESTRICTED | 產品被限制，因為賣方的帳戶永久受到 Roblox 限制。 |
  | SELLER_NO_LONGER_ACTIVE | 產品被限制，因為賣方的帳戶已被刪除或以其他方式不再有效。 |

創建者商店產品是具有此資產 ID 的視頻。

以類似科學計數法的形式表示十進制數。

示例：
 - 17            === `{significand: 17   exponent: 0}（或僅 {significand:
   17}`
 - -0.005        === `{significand: -5   exponent: -3}`
 - 33.5 百萬  === `{significand: 335  exponent: 5}`
 - 11/8 (1.375)  === `{significand: 1375 exponent: -3}`

請注意，Decimal 的範圍超過 JSON `number`（雙精度）以及 `decimal64` 的範圍。

表示在有效數內小數點的位置。

當指數為 0 時，Decimal 的值僅是 `significand` 的值。

當指數大於 0 時，表示重要位數後面有多少個尾隨零。

當指數小於 0 時，表示有多少個重要位數（以及必要的隱式前導零）在小數點後面。

保存的記錄，包含資產詳細信息。

代表資產中各種實例類型的計數。
查看[Instance](https://create.roblox.com/docs/reference/engine/classes/Instance)。

模型中工作室實例類型的數量。
請參見 [Instance](https://create.roblox.com/docs/reference/engine/classes/Instance)。
這些細分為特定類型，例如 MeshPart、Part、Script、
Tool、Animation 等。

模型中網格的摘要（如果存在）。

模型實例類型的列表。請參見 Toolbox.Service.Models.Internal.InstanceCounts 和 [Instance](https://create.roblox.com/docs/reference/engine/classes/Instance) 獲取更多詳細信息。

如果包含，排除具有這些子類型的資產。

此過濾器僅包括以下 [Instance](https://create.roblox.com/docs/reference/engine/classes/Instance) 類型在模型中。

如果包含，僅搜索具有這些子類型的資產。

表示其貨幣類型的金額。

示例：
 - 五美元 === `{currency_code: "USD" quantity: {significand: 5}}`

貨幣代碼。

這可能是 ISO 4217 中定義的三位字母貨幣代碼。

API 可能會定義不包含在 ISO 4217 標準中的其他貨幣代碼（例如，虛擬貨幣或加密貨幣）。這些必須以 `X-` 開頭，以便區分潛在的未來 ISO 4217 代碼。例如，`"USD"` 是美國美元的 ISO 4217 代碼。

表示要從中提取條目的音樂排行榜（如果有）。

提供對象網格特徵的摘要，例如三角形和頂點計數。

按媒體類型分組的項目的預覽資產 ID。

包含搜索查詢的查詢更正信息。

原始搜索查詢的建議拼寫更正。

表示音頻類型值，這些值將在 Swagger UI 中正確顯示。

表示「子集」的 Toolbox.Service.CategoryType 選項，並代表可以從工具箱搜索 API 搜索的完整「類別」（或資產類型）集。

用於搜索創建者商店資產的請求模型。

創建者的組 ID。在查詢中只能存在 'userId' 和 'groupId' 之一。

要通過其搜索的圖像文件。圖像必須以 base64 編碼以便用於搜索。在一個查詢中只能存在 'query' 和 'image' 之一。

結果是否應僅包括由已驗證創建者創建的資產。

要返回的資產數量。不能大於 100。

資產的最高價格（以分為單位）。如果包含，必須大於或等於 0。

資產的最低價格（以分為單位）。如果包含，必須大於或等於 0。

要檢索的頁碼，從 0 開始。在查詢中只能存在 'pageNumber' 和 'pageToken' 之一。

所需搜索結果頁面的標識符。在查詢中只能存在 'pageNumber' 和 'pageToken' 之一。

用於篩選結果的搜索術語。在一個查詢中只能存在 'query' 和 'image' 之一。

要搜索的資產類型。當 Toolbox.Service.SearchCreatorStoreAssetsRequest.CategoryPath
解析為資產類型時是可選的；否則必填。

指示在響應中將填充哪些字段。

按照什麼類別對搜索結果進行排序。

可選的泳道識別符（例如 "趨勢"、"必要"、"定價"）。

創建者的用戶 ID。在查詢中只能存在 'userId' 和 'groupId' 之一。

SearchCreatorStoreAssets 端點的響應。

搜索查詢返回的創建者商店資產列表。

用於搜索資產的過濾關鍵字（如適用）。

查看下一頁結果的頁碼標識符。

查詢更正信息，如果有可用的更正。

此視圖控制哪些字段填充在搜索響應中。更輕的視圖將導致更快的響應時間和更高的可靠性。

根據此類別對搜索結果進行排序。

資產的類別路徑（如果存在）。
例如 "3d__characters"

如果在特定宇宙中創建資產，則為宇宙 ID。

按資產類型分組的資產預覽資產 ID。

資產是否可以在創作者商店中購買。

已經 UpVotes 的投票總數的百分比。

可配置的密鑰，允許對 Roblox 資源進行細粒度訪問。詳細信息請參見 https://create.roblox.com/docs/cloud/auth/api-keys。

x-api-key

表示 Roblox 用戶身份的瀏覽器 Cookie。請勿分享此物。分享此物會允許他人以您的身份登錄，並竊取您的 Robux 和物品。我們不建議使用 Cookie 來調用端點。在可能的情況下，請改用帶有 x-api-key 標頭的 API 密鑰或 OAuth 2.0 進行身份驗證。

.ROBLOSECURITY

構建或授權應用程序以訪問 Roblox 資源。詳細信息請參見 https://create.roblox.com/docs/cloud/auth/oauth2-overview。

Roblox API。詳情請參見 https://create.roblox.com/docs/cloud/open-cloud。

Roblox API

添加創作者商店產品。僅在您的產品從未
在創作者商店上發佈過的情況下使用此方法；否則，請使用 `PATCH` 方法以
更新產品。

CreatorStoreProduct

creator-store-product:write

creator_store_product_id

creator-store-product:read

updateMask

如果設置為 true，且找不到創作者商店產品，則會創建創作者商店
產品。在這種情況下，將忽略 `update_mask`。

allowMissing

targetType

targetId

目前不支持自定義集合。應省略此字段。

collectionName

creator-store-save:write

要過濾的資產 ID。如果提供，必須同時提供 targetType。

sortBy

sortDirection

limit

page

keyword

hideOwnedAssets

creator-store-save:read

批量刪除保存。
每個請求最多 5000 個保存。

獲取單個創作者商店資產的詳細信息。

要搜索的資產類型。當請求中存在 categoryPath 時是可選的；否則必填。

searchCategoryType

query

搜尋模型時，與搜尋結果相關的子類型。

modelSubTypes

搜尋模型時，與搜尋結果無關的子類型。

excludedModelSubTypes

已棄用：請改為參考 'userId' 和 'groupId' 屬性。創作者類型和 ID。例如 "user/123" 或 "group/456"

creator

創作者的用戶 ID。在查詢中只能存在 'userId' 和 'groupId' 之一。

userId

創作者的群組 ID。在查詢中只能存在 'userId' 和 'groupId' 之一。

groupId

期望的搜尋結果頁面的標識符。在查詢中只能存在 'pageNumber' 和 'pageToken' 之一。

pageToken

pageNumber

maxPageSize

要對搜索結果進行排序的類別。

sortCategory

搜尋音頻時，音頻資產的最小持續時間。如果包含，必須大於或等於 0。

audioMinDurationSeconds

搜尋音頻時，音頻資產的最大持續時間。如果包含，必須大於或等於 0。

audioMaxDurationSeconds

搜尋音頻時，音頻資產的藝術家名稱。

audioArtist

搜尋音頻時，音頻資產的專輯名稱。

audioAlbum

搜索音訊時，音訊資產的類型。

audioTypes

搜索模型時，過濾以下 [Instance](https://create.roblox.com/docs/reference/engine/classes/Instance) 類型是否包含在模型中。

includedInstanceTypes

結果是否僅包括由經過驗證的創作者創建的資產。

includeOnlyVerifiedCreators

資產的最小價格（以分為單位）。如果包含，必須大於或等於 0。

minPriceCents

資產的最大價格（以分為單位）。如果包含，必須大於或等於 0。

maxPriceCents

facets

categoryPath

searchView

musicChartType

swimlane

Creator Store

体验

虚拟形象

素材

范例和项目

引擎 API

Open Cloud API

Studio

分析

平台

教程

创作者计划

教育

课程

学习

此方法是异步的，会返回一个`Operation`对象，该对象表示操作的当前状态。它包含一个端点路径，您可以轮询该路径以获取实际响应和相关的元数据。有关长时间运行操作的更多信息，请参阅[文档]({longRunningOperationsLink})。

以下部分描述了操作完成时提供的响应和元数据对象。

Beta 测试终点已准备好公开使用。可能出现导致功能无法正常运作的更改，但几率极低。

这些 Open Cloud 文档页面将于 2026 年 3 月 31 日移除。届时你将被自动重定向到新的 Open Cloud 文档。{linkStart}了解更多{linkEnd}

这些旧 Open Cloud 页面将于 2026 年 3 月 31 日移除并重定向。{linkStart}了解更多{linkEnd}

实验性终端节点已准备好供公众使用，但随着 API 协定的最终确定，可能偶尔会出现重大变更。

此终端节点可通过使用 API 密钥的 {httpServiceLinkStart}HttpService{httpServiceLinkEnd} 在体验中调用。

此字段可能在创建资源时被设置，但可能无法在后续请求中修改。

这些字段可能在创建资源时被设置，但可能无法在后续请求中修改。

此字段可以在请求中提供，但永远不会包括在答复中。

旧版验证方法。始终首选使用 API 密钥或 OAuth 2.0（如有）。

每个 API 密钥：每个 IP 地址每 {periodInSeconds} 秒有 {maxInPeriod} 次请求

无需身份验证即可调用。通常会显著降低速率限制。始终首选使用 API 密钥或 OAuth 2.0（如有）。

对于每个分组，只需提供架构中的以下字段之一，其余字段可以排除。

你可以随时重新选择加入。{linkStart}提供反馈。{linkEnd}

你正在查看旧版文档。{linkStart}提供反馈。{linkEnd}

你可以随时退出，并重定向回旧的引用页面。{linkStart}在这里提供反馈。{linkEnd}

你正在查看全新改版的文档。{linkStart}提供反馈。{linkEnd}

此字段可能被设置为响应，但在请求中将被忽略。

注意：在高流量期间，速率限制可能会更低。某些终端节点有额外的速率限制。[进一步了解速率限制]({link})。

用户或群组所有 API 密钥每天 {limit} 个请求

用户或群组所有 API 密钥每小时 {limit} 个请求

用户或群组所有 API 密钥每分钟 {limit} 个请求

用户或群组所有 API 密钥每秒 {limit} 个请求

每个 API 密钥所有者每分钟 {limit} 个请求

每个 App 用户每天 {limit} 个请求

每个 App 用户每小时 {limit} 个请求

每个 App 用户每分钟 {limit} 个请求

每个 App 用户每秒 {limit} 个请求

每个 API 密钥所有者每秒 {limit} 个请求

范围可以控制你的凭据拥有哪些权限。你的凭据只能访问你所选范围支持的终端节点。

稳定终端节点已准备好投入生产使用，在其生命周期内几乎不会发生重大变更。

此目标允许你将密钥的访问权限限制为选定的{requiredParts}

此目标允许你将密钥的访问权限限制为选定的{requiredParts}和{optionalParts}

目标类型用于限制你的凭据可操作的资源。即使你的帐户拥有其他资源的权限，也只能处理选定的资源。某些范围没有目标部件，在这种情况下，你的所有相关资源都可进行操作。

对于用户拥有的 API 密钥，无需选择宇宙顶级部件。在这种情况下，你的 API 密钥可以访问你拥有的所有个人体验，以及你在群组中拥有相应权限的群组体验。

尚不支持试用需要 API 密钥或 OAuth 2.0 验证的终端节点

为了安全起见，已停用高风险操作的 Cookie 验证。

关键风险终端节点非常敏感，为了安全起见，已停用“试用”

注意：此代码示例中不包含验证标头。你可能需要添加验证标头，以便此命令能够正常运作。

这是会修改或删除关键数据的高风险终端节点。测试时要格外小心。

此 API 终端节点已被归类为高风险，可能会影响实时数据或用户帐户。

对高风险 API 的已验证请求可能会进行无法撤销的更改。请在继续之前仔细查看你的请求参数。

这是会取回数据的低风险终端节点。通常可以安全测试。

这是会修改数据的中风险终端节点。请使用非关键帐户仔细测试，因为更改可能是永久性的。

为了确保你帐户的安全，请不要在此处粘贴来自其他来源的文本，或将此页面的信息发送给其他人。

你即将使用实际帐户凭据测试实时 API 终端节点。

只有在你了解即将进行的 API 调用的影响后才能继续。在测试之前，请仔细查看 API 文档。

将使用已验证的会话进行 API 调用

这些是可能影响你帐户或数据的真实 API 调用

某些操作可能会修改或删除数据

此终端节点已被以下推荐的替代终端节点取代：

调用此终端节点需要以下范围。如需
有关生成正确密钥的更多信息，请参阅 [管理 API 密钥]({apiKeyReferenceDocLink})。

如需有关生成密钥的更多信息，请参阅 [管理 API 密钥]({apiKeyReferenceDocLink})。

相对于基础 URL 的路径，下列端点是可用的。

此字符串格式为 [FieldMask](/cloud/reference/types#fieldmask)。

JSON 值可以是 “null”、“boolean”、“string”、“number”、“array” 或 “object”。

你的 OAuth 2.0 应用程序需要以下范围才能使用此终端节点。如需进一步了解如何注册 OAuth 2.0 应用程序，请参阅 [App 注册和审核]({oauth2ReferenceDocLink})。

如需进一步了解如何注册 OAuth 2.0 应用程序，请参阅 [App 注册和审核]({oauth2ReferenceDocLink})。

下列对象描述了接受或返回的有效载荷。请参阅每个单独的端点，以了解更多关于这些对象用途的信息。

调用此终端节点需要以下范围。

资源路径

若要使用此端点，你的 OAuth 2.0 应用程序需要以下范围。关于如何注册 OAuth 2.0 应用程序的更多信息，请查看【应用程序注册及评价】({oauth2ReferenceDocLink})。

Creator Store

Assets

不推荐