*此內容是使用 AI（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必須為空。如果此值為假，產品可能無法由任何用戶獲得。.

seller 請選擇其中一項：

userSellerstring
僅限輸出

Roblox 用戶出售產品。.

groupSellerstring
僅限輸出

販售產品的 Roblox 群組。.

productType 請選擇其中一項：

modelAssetIdstring
不可改變

創作者商店的產品是一個擁有此資產ID的模型。.

pluginAssetIdstring
不可改變

創作者商店的產品是一個具有此資產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.

audioAssetIdstring
不可改變

創作者商店的產品是具有此資產識別碼的音頻文件。.

decalAssetIdstring
不可改變

創作者商店產品是一個裝有此資產ID的貼花。.

meshPartAssetIdstring
不可改變

創作者商店的產品是具有此資產識別符號的網格零件。.

videoAssetIdstring
不可改變

創作者商店的產品是一個包含此資產ID的視頻。.

fontFamilyAssetIdstring
不可改變

創作者商店的產品是具有此資產識別符號的字體家族。.

基本網址
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"

}