*此内容使用人工智能（Beta）翻译，可能包含错误。若要查看英文页面，请点按 此处。

CreatorStoreProduct

在创作者商店中代表一个产品。该资源用于管理创作者商店的资产分发和价格。

属性

pathstring

创建者商店产品的资源路径。

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

basePriceobject

产品的基础价格。了解更多信息，请参阅金钱。每种产品类型（例如 pluginAssetId）支持一组特定价格。目前只支持设置基价在美元。

根据类型，每个创作者商店产品都有一个固定的支持价格集；查看 productType 属性获取完整列表。例如，要将插件价格设置为 $4.99，使用以下基础价格：

"basePrice": {

  "currencyCode": "USD",

  "quantity": {

    "significand": 4990000000,

    "exponent": -9

  }

}

注意：指数 必须 为 -9，和值必须采用此格式。对应的 十进制 格式是 significand * 10^exponent 。

如果你想将插件价格设置为 $0 (即免费)，使用以下 base_price

"basePrice": {

  "currencyCode": "USD",

  "quantity": {

    "significand": 0,

    "exponent": 0

  }

}

注意：您仍然必须将 currencyCode 设置为美元，即使是免费产品。

实际购买价格基于此基价，但由于地区特定考虑，经常略有不同。

将此设置为零以使产品免费。.

purchasePriceobject

用户的有效购买价格，在考虑到本地因素后。.

publishedboolean

卖家是否打算在创作者商店分发创作者商店产品。卖家可能打算分发产品，但由于卖家或基础创作者商店产品的某些限制，产品可能无法购买。见 restrictions 和 purchasable 获取更多细节。.

restrictionsarray<enum>
仅输出

对产品的限制。产品可以在一次启用多个限制。

可能的值：

| 值 | 描述 | | --- | --- | | RESTRICTION_UNSPECIFIED | 未指定限制。| | SOLD_ITEM_RESTRICTED | 正在出售的物品已被 Roblox 限制详情可以通过直接查找那个物品来获得。| | SELLER_TEMPORARILY_RESTRICTED | 产品受限，因为卖家的帐户暂时被 Roblox 限制。| | SELLER_PERMANENTLY_RESTRICTED | 产品受限，因为卖家的帐户永久被 Roblox 限制。| | SELLER_NO_LONGER_ACTIVE | 产品受限，因为卖家的帐户已被删除或其他原因不再活跃。 |. 可能的值：

purchasableboolean
仅输出

产品是否可购买。

为了使这个值为真，published必须为真，而restrictions必须为空。如果此值为 false，产品可能无法由任何用户获取。.

请为seller选择其中一项：

userSellerstring
仅输出

Roblox 用户出售产品。.

groupSellerstring
仅输出

Roblox 组卖出产品。.

请为productType选择其中一项：

modelAssetIdstring
不可改变

创作者商店产品是一个拥有此资产ID的模型。.

pluginAssetIdstring
不可改变

创作者商店产品是一个具有此资产 ID 的插件。

支持的基础价格为 USD：$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.

audioAssetIdstring
不可改变

创作者商店产品是具有此资产 ID 的音频文件。.

decalAssetIdstring
不可改变

创作者商店产品是带有此资产ID的贴花。.

meshPartAssetIdstring
不可改变

创作者商店产品是一个拥有此资产ID的网格部分。.

videoAssetIdstring
不可改变

创作者商店产品是带有此资产ID的视频。.

fontFamilyAssetIdstring
不可改变

创作者商店产品是具有此资产 ID 的字体家族。.

基本网址
https://apis.roblox.com
CreatorStoreProduct 资源
{

  "path": "creator-store-products/123",

  "basePrice": {

    "currencyCode": "string",

    "quantity": {

      "significand": "integer",

      "exponent": "integer"

    }

  },

  "purchasePrice": {

    "currencyCode": "string",

    "quantity": {

      "significand": "integer",

      "exponent": "integer"

    }

  },

  "published": true,

  "restrictions": [

    "RESTRICTION_UNSPECIFIED"

  ],

  "purchasable": true,

  "userSeller": "string",

  "modelAssetId": "string"

}

CreatorStoreProduct

创建创作者商店产品
Beta

POST /cloud/v2/creator-store-products

添加创作者商店产品。仅在您的产品从未在创作者商店分发时使用此方法；否则，使用 PATCH 方法来更新产品。

范围
creator-store-product:write
请求请求正文CreatorStoreProduct
答复CreatorStoreProduct
POST /cloud/v2/creator-store-products
curl -L -X POST 'https://apis.roblox.com/cloud/v2/creator-store-products' \

  -H 'x-api-key: {your-api-key}' \

  -H 'Content-Type: application/json' \

  --data '{

  "basePrice": {

    "currencyCode": "string",

    "quantity": {

      "significand": "integer",

      "exponent": "integer"

    }

  },

  "purchasePrice": {

    "currencyCode": "string",

    "quantity": {

      "significand": "integer",

      "exponent": "integer"

    }

  },

  "published": true

}'
答复
{

  "path": "creator-store-products/123",

  "basePrice": {

    "currencyCode": "string",

    "quantity": {

      "significand": "integer",

      "exponent": "integer"

    }

  },

  "purchasePrice": {

    "currencyCode": "string",

    "quantity": {

      "significand": "integer",

      "exponent": "integer"

    }

  },

  "published": true,

  "restrictions": [

    "RESTRICTION_UNSPECIFIED"

  ],

  "purchasable": true,

  "userSeller": "string",

  "modelAssetId": "string"

}

CreatorStoreProduct

获取创作者商店产品
Beta

GET /cloud/v2/creator-store-products/{creator_store_product_id}

获取创作者商店产品。

范围
creator-store-product:read
请求路径参数
creator_store_product_idstring
必填

创建者商店产品ID。.

答复CreatorStoreProduct
GET /cloud/v2/creator-store-products/{creator_store_product_id}
curl -L -X GET 'https://apis.roblox.com/cloud/v2/creator-store-products/{creator_store_product_id}' \

  -H 'x-api-key: {your-api-key}'
答复
{

  "path": "creator-store-products/123",

  "basePrice": {

    "currencyCode": "string",

    "quantity": {

      "significand": "integer",

      "exponent": "integer"

    }

  },

  "purchasePrice": {

    "currencyCode": "string",

    "quantity": {

      "significand": "integer",

      "exponent": "integer"

    }

  },

  "published": true,

  "restrictions": [

    "RESTRICTION_UNSPECIFIED"

  ],

  "purchasable": true,

  "userSeller": "string",

  "modelAssetId": "string"

}

CreatorStoreProduct

更新创作者商店产品
Beta

PATCH /cloud/v2/creator-store-products/{creator_store_product_id}

更新创作者商店产品。

范围
creator-store-product:write
请求路径参数
creator_store_product_idstring
必填

创建者商店产品ID。.

查询参数
updateMaskstring

要更新的字段列表。. 此字符串格式为 FieldMask。

allowMissingboolean

如果设置为真，且创建者商店产品未找到，将创建一个创建者商店产品。在这种情况下，update_mask被忽略。.

请求正文CreatorStoreProduct
答复CreatorStoreProduct
PATCH /cloud/v2/creator-store-products/{creator_store_product_id}
curl -L -X PATCH 'https://apis.roblox.com/cloud/v2/creator-store-products/{creator_store_product_id}?updateMask={string}&allowMissing={boolean}' \

  -H 'x-api-key: {your-api-key}' \

  -H 'Content-Type: application/json' \

  --data '{

  "basePrice": {

    "currencyCode": "string",

    "quantity": {

      "significand": "integer",

      "exponent": "integer"

    }

  },

  "purchasePrice": {

    "currencyCode": "string",

    "quantity": {

      "significand": "integer",

      "exponent": "integer"

    }

  },

  "published": true

}'
答复
{

  "path": "creator-store-products/123",

  "basePrice": {

    "currencyCode": "string",

    "quantity": {

      "significand": "integer",

      "exponent": "integer"

    }

  },

  "purchasePrice": {

    "currencyCode": "string",

    "quantity": {

      "significand": "integer",

      "exponent": "integer"

    }

  },

  "published": true,

  "restrictions": [

    "RESTRICTION_UNSPECIFIED"

  ],

  "purchasable": true,

  "userSeller": "string",

  "modelAssetId": "string"

}