*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.

CreatorStoreProduct

Đại diện cho một sản phẩm trong Cửa hàng Nhà sáng tạo. Tài nguyên này được sử dụng để quản lý phân phối và giá cả của tài sản trong Cửa hàng Nhà sáng tạo.

Thuộc Tính

pathstring

Con đường tài nguyên của sản phẩm cửa hàng sáng tạo.

Định dạng: creator-store-products/{creator_store_product_id}.

basePriceobject

Giá cơ bản của sản phẩm.Để biết thêm thông tin, xem Tiền .Mỗi loại sản phẩm (như pluginAssetId ) hỗ trợ một bộ giá cụ thể.Hiện tại, chỉ cài đặt một giá cơ bản bằng USD được hỗ trợ.

Tùy thuộc vào loại, mỗi sản phẩm Cửa hàng Nhà sáng tạo có một bộ giá cố định được hỗ trợ; xem thuộc tính productType để có danh sách đầy đủ.Ví dụ, để đặt giá của một plugin lên $4.99, hãy sử dụng giá cơ sở sau:


"basePrice": {
  "currencyCode": "USD",
  "quantity": {
    "significand": 4990000000,
    "exponent": -9
  }
}

Lưu ý: Biểu số phải là -9, và đại lượng phải ở trong định dạng này. Định dạng Thập phân tương ứng là significand * 10^exponent .

Nếu bạn muốn đặt giá của một plugin lên $0 (tức là miễn phí), hãy sử dụng base_price sau đây


"basePrice": {
  "currencyCode": "USD",
  "quantity": {
    "significand": 0,
    "exponent": 0
  }
}

Lưu ý: Bạn vẫn phải đặt currencyCode sang USD, ngay cả đối với sản phẩm miễn phí.

Giá mua thực tế dựa trên giá cơ sở này, nhưng thường khác nhau một chút do các xem xét cụ thể địa phương.

Đặt điều này thành không để làm cho sản phẩm miễn phí.

purchasePriceobject

Giá mua hiệu quả cho người dùng, sau khi trừ đi các xem xét cụ thể địa phương.

publishedboolean

Whether người bán có ý định phân phối sản phẩm Cửa hàng Nhà sáng tạo trên Cửa hàng Nhà sáng tạo.Một người bán có thể có ý định phân phối một sản phẩm, nhưng do một số hạn chế đối với người bán hoặc sản phẩm Cửa hàng Sáng tạo cơ bản, sản phẩm có thể không có sẵn để mua.Xem restrictions và purchasable để biết thêm chi tiết.

restrictionsarray<enum>

Chỉ Xuất

Các hạn chế áp dụng cho sản phẩm. Một sản phẩm có thể có nhiều hạn chế hoạt động cùng một lúc.

Các giá trị có thể:

| Giá trị | Mô tả | | --- | --- | | RESTRICTION_UNSPECIFIED | Giới hạn không xác định.| | SOLD_ITEM_RESTRICTED | Vật phẩm đang được bán đã bị hạn chế bởi Roblox Chi tiết có thể có sẵn bằng cách tìm kiếm trực tiếp vật phẩm đó.| | SELLER_TEMPORARILY_RESTRICTED | Sản phẩm bị hạn chế vì tài khoản của người bán bị hạn chế tạm thời bởi Roblox.| | SELLER_PERMANENTLY_RESTRICTED | Sản phẩm bị hạn chế vì tài khoản của người bán bị hạn chế vĩnh viễn bởi Roblox.| | SELLER_NO_LONGER_ACTIVE | Sản phẩm bị hạn chế vì tài khoản của người bán đã bị xóa hoặc không còn hoạt động nữa. |. Giá trị có thể:

purchasableboolean

Chỉ Xuất

Liệu sản phẩm có thể mua được không.

Để giá trị này là đúng, published phải là đúng và restrictions phải trống.Nếu giá trị này là sai, sản phẩm có thể không được mua bởi bất kỳ người dùng nào.

Một trong những thông tin sau đây cho seller:

userSellerstring

Chỉ Xuất

Người dùng Roblox bán sản phẩm.

groupSellerstring

Chỉ Xuất

Nhóm Roblox bán sản phẩm.

Một trong những thông tin sau đây cho productType:

modelAssetIdstring

Bất Biến

Sản phẩm Cửa hàng Nhà sáng tạo là một mô hình với ID tài sản này.

pluginAssetIdstring

Bất Biến

Sản phẩm Cửa hàng Nhà sáng tạo là một plugin với ID tài sản này.

Giá cơ bản được hỗ trợ bằng 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,.

audioAssetIdstring

Bất Biến

Sản phẩm Cửa hàng Nhà sáng tạo là một tập tin âm thanh với ID tài sản này.

decalAssetIdstring

Bất Biến

Sản phẩm Cửa hàng Nhà sáng tạo là một nhãn dán với ID tài sản này.

meshPartAssetIdstring

Bất Biến

Sản phẩm Cửa hàng Nhà sáng tạo là một phần khối có ID tài sản này.

videoAssetIdstring

Bất Biến

Sản phẩm Cửa hàng Nhà sáng tạo là một video với ID tài sản này.

fontFamilyAssetIdstring

Bất Biến

Sản phẩm Cửa hàng Nhà sáng tạo là một gia đình phông chữ với ID tài sản này.

URL Cơ Sở

https://apis.roblox.com

Tài nguyên 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

Tạo sản phẩm Cửa hàng Nhà sáng tạo
Bản Beta

POST /cloud/v2/creator-store-products

Thêm một sản phẩm Cửa hàng Nhà sáng tạo.Chỉ sử dụng phương pháp này nếu sản phẩm của bạn chưa bao giờ được phân phối trên Cửa hàng Nhà sáng tạo; nếu không, hãy sử dụng phương pháp PATCH để cập nhật sản phẩm.

Phạm Vi

creator-store-product:write

Yêu CầuYêu Cầu Cơ ThểCreatorStoreProduct

Phản HồiCreatorStoreProduct

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
}'

Phản Hồi

{
  "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

Nhận sản phẩm Cửa hàng Nhà sáng tạo
Bản Beta

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

Nhận sản phẩm Cửa hàng Nhà sáng tạo.

Phạm Vi

creator-store-product:read

Yêu CầuTham Số Đường Dẫn

creator_store_product_idstring

Bắt Buộc

ID cửa hàng sản xuất người tạo.

Phản HồiCreatorStoreProduct

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}'

Phản Hồi

{
  "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

Cập nhật sản phẩm Cửa hàng Nhà sáng tạo
Bản Beta

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

Cập nhật sản phẩm Cửa hàng Nhà sáng tạo.

Phạm Vi

creator-store-product:write

Yêu CầuTham Số Đường Dẫn

creator_store_product_idstring

Bắt Buộc

ID cửa hàng sản xuất người tạo.

Tham Số Truy Vấn

updateMaskstring

Danh sách các trường để cập nhật. Chuỗi này được định dạng là Mặt nạ trường.

allowMissingboolean

Nếu được đặt thành true, và sản phẩm cửa hàng sáng tạo không được tìm thấy, một sản phẩm cửa hàng sáng tạo được tạo ra. Trong trường hợp này, update_mask được bỏ qua.

Yêu Cầu Cơ ThểCreatorStoreProduct

Phản HồiCreatorStoreProduct

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
}'

Phản Hồi

{
  "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

Thuộc Tính

CreatorStoreProduct

Tạo sản phẩm Cửa hàng Nhà sáng tạoBản Beta

CreatorStoreProduct

Nhận sản phẩm Cửa hàng Nhà sáng tạoBản Beta

CreatorStoreProduct

Cập nhật sản phẩm Cửa hàng Nhà sáng tạoBản Beta

Tạo sản phẩm Cửa hàng Nhà sáng tạo
Bản Beta

Nhận sản phẩm Cửa hàng Nhà sáng tạo
Bản Beta

Cập nhật sản phẩm Cửa hàng Nhà sáng tạo
Bản Beta