Quản lý sự hiện diện của bạn trên [Cửa hàng Tạo](https://production/creator-store). [Tạo](#Cloud_CreateCreatorStoreProduct) và [cập nhật](#Cloud_UpdateCreatorStoreProduct) danh sách sản phẩm cho tài sản của bạn, và [tìm kiếm trong hộp công cụ](#Toolbox_SearchCreatorStoreAssets) cho các tài sản bằng các bộ lọc khác nhau.


Đại diện cho một tài sản âm thanh.

Loại âm thanh (Âm nhạc hoặc Âm thanh hiệu ứng).

Thời gian của tệp âm thanh tính bằng giây.

Các tham số bộ lọc tìm kiếm đặc thù cho âm thanh.

Các loại âm thanh để bao gồm (ví dụ: Âm nhạc, Âm thanh hiệu ứng)

Thời gian tối đa cho âm thanh tính bằng giây. Nếu được bao gồm, phải lớn hơn hoặc bằng 1.

Thời gian tối thiểu cho âm thanh tính bằng giây. Nếu được bao gồm, phải lớn hơn hoặc bằng 0.

Chỉ ra bảng xếp hạng âm nhạc nào để lọc.

Mô hình yêu cầu để xóa hàng loạt các bản lưu

Danh sách các lưu trữ đang được xóa

Mô hình phản hồi cho thao tác xóa hàng loạt bản lưu

Số lượng bản lưu đã được xóa thành công

Mô hình yêu cầu để tạo một bản lưu

Các bộ sưu tập tùy chỉnh hiện không được hỗ trợ.
Trường này nên được bỏ qua.

Mô hình đại diện cho một người tạo.

Đã lỗi thời: Vui lòng tham khảo các thuộc tính 'userId' và 'groupId' thay vào đó.
Loại và ID của người tạo. Ví dụ: user/123 hoặc group/456.

ID nhóm. Cần thiết nếu tài sản thuộc sở hữu của nhóm.

Giá trị này chỉ tồn tại cho những người tạo dựa trên nhóm và đại diện cho ID người dùng của người tạo đã cập nhật tài sản gần đây nhất.

Giá trị này chỉ tồn tại cho những người tạo dựa trên nhóm và đại diện cho tên của người tạo đã cập nhật tài sản gần đây nhất.

ID người dùng của người tạo. Cần thiết nếu tài sản thuộc sở hữu của người dùng cá nhân.

Liệu người tạo đã được xác minh hay chưa.

Đại diện cho một tài sản trong cửa hàng của người tạo.

Chi tiết sản phẩm của tài sản.

Chi tiết bỏ phiếu của tài sản.

Đại diện cho các khả năng mà một mô hình có (ví dụ: gói).
Chỉ xuất hiện cho các loại tài sản mô hình; AMRS bao gồm nó trong phản hồi khi có sẵn.

Kiểm soát xem mô hình có được bao bọc khi chèn hay không khi nó có các kịch bản.

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

Sản phẩm của cửa hàng người tạo là một tệp âm thanh với ID tài sản này.

Sản phẩm của cửa hàng người tạo là một decal với ID tài sản này.

Sản phẩm của cửa hàng người tạo là một họ font với ID tài sản này.

Sản phẩm của cửa hàng người tạo là một phần lưới với ID tài sản này.

Sản phẩm của cửa hàng người tạo là một mô hình với ID tài sản này.

Đường dẫn tài nguyên của sản phẩm của cửa hàng người tạo.

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

Sản phẩm của cửa hàng người tạo là một tiện ích với ID tài sản này.

Giá cơ bản hỗ trợ bằng USD: 0 đô la, 4,99 đô la, 5,99 đô la, 6,99 đô la, 7,99 đô la, 8,99 đô la,
9,99 đô la, 10,99 đô la, 11,99 đô la, 12,99 đô la, 13,99 đô la, 14,99 đô la, 15,99 đô la, 16,99 đô la,
17,99 đô la, 18,99 đô la, 19,99 đô la, 24,99 đô la, 29,99 đô la, 34,99 đô la, 39,99 đô la, 44,99 đô la, 49,99 đô la, 59,99 đô la,
69,99 đô la, 79,99 đô la, 89,99 đô la, 99,99 đô la, 149,99 đô la, 199,99 đô la, 249,99 đô la.

Liệu người bán có dự định phân phối sản phẩm cửa hàng người tạo trên
Cửa hàng người tạo hay không. Một người bán có thể dự đị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 người 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.

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

Để giá trị này là đúng, `published` phải đú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.

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 | Hạn chế không xác định. |
  | SOLD_ITEM_RESTRICTED | Mặt hàng đang bán đã bị giới hạn bởi Roblox. Chi tiết có thể có thể tìm thấy bằng
việc tìm kiếm mặt hàng đó trực tiếp. |
  | SELLER_TEMPORARILY_RESTRICTED | Sản phẩm bị hạn chế vì tài khoản 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 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 người bán đã bị xóa hoặc
không còn hoạt động nữa. |

Sản phẩm của cửa hàng người tạo là một video với ID tài sản này.

Đại diện cho một tài sản decal.

Đại diện cho một số thập phân theo dạng tương tự như ký hiệu khoa học.

Ví dụ:
 - 17            === `{significand: 17   exponent: 0} (hoặc chỉ {significand:
   17})`
 - -0.005        === `{significand: -5   exponent: -3}`
 - 33,5 triệu  === `{significand: 335  exponent: 5}`
 - 11/8 (1.375)  === `{significand: 1375 exponent: -3}`

Lưu ý rằng phạm vi của một Decimal vượt quá của một JSON `number` (double), cũng như
của một `decimal64`.

Đại diện cho vị trí của dấu thập phân trong significand.

Khi số mũ là 0, giá trị của Decimal chỉ đơn thuần là giá trị của
`significand`.

Khi số mũ lớn hơn 0, đại diện cho số lượng số 0 theo sau sau các chữ số đáng kể.

Khi số mũ nhỏ hơn 0, đại diện cho số lượng chữ số đáng kể (và bất kỳ 0 dẫn trước nào, nếu cần) xuất hiện sau
dấu thập phân.

Mô hình yêu cầu để xóa một bản lưu

Mô hình phản hồi để lấy bản lưu.

Tổng số lượng lưu trữ phù hợp với truy vấn.

Một bản ghi lưu, đã được làm đầy với chi tiết tài sản.

Liệu tài sản có được sở hữu bởi người dùng hay không.

Đại diện cho số lượng các loại thể hiện khác nhau trong một tài sản.
Xem [Instance](https://create.roblox.com/docs/reference/engine/classes/Instance).

Khả năng kịch bản cho tài sản (sandboxing)

Liệu mô hình có kịch bản hay không.

Số lượng các loại thể loại studio trong mô hình.
Xem [Instance](https://create.roblox.com/docs/reference/engine/classes/Instance).
Những điều này được chia thành các loại cụ thể, chẳng hạn như MeshPart, Part, Script,
Tool, Animation, v.v.

Tóm tắt các lưới bên trong mô hình, nếu có.

Số lượng kịch bản có trong mô hình.

Các loại con mà mô hình thuộc về.

Danh sách các loại thể loại mô hình. Xem Công cụ tìm kiếm dịch vụ.models.internal.InstanceCounts và [Instance](https://create.roblox.com/docs/reference/engine/classes/Instance) để biết thêm chi tiết.

Tham số lọc tìm kiếm đặc trưng cho mô hình.

Nếu bao gồm, loại bỏ tài sản có các loại con này.

Lọc các loại [Instance](https://create.roblox.com/docs/reference/engine/classes/Instance) sau được bao gồm trong mô hình.

Nếu bao gồm, tìm kiếm tài sản chỉ với các loại con này.

Các loại con mô hình được hỗ trợ.

Biểu thị một số tiền với loại tiền tệ của nó.

Ví dụ:
 - Năm đô la Mỹ === `{currency_code: "USD" quantity: {significand: 5}}`

Mã loại tiền tệ.

Điều này có thể là mã tiền tệ ba chữ cái được định nghĩa trong ISO 4217.

Các API có thể định nghĩa các mã tiền tệ bổ sung không có trong tiêu chuẩn ISO
4217 (ví dụ: tiền tệ ảo hoặc tiền điện tử). Những điều này
phải bắt đầu bằng `X-`, nhằm phân biệt với các mã ISO 4217 có thể trong tương lai. Ví dụ, `"USD"` là mã ISO 4217 cho đô la Mỹ.

Biểu thị biểu đồ âm nhạc mà để lấy các mục từ, nếu có.

Cung cấp tóm tắt về các đặc điểm của lưới của một đối tượng, chẳng hạn như số lượng tam giác và đỉnh.

Số lượng tổng các tam giác trong lưới của đối tượng.

Số lượng tổng các đỉnh trong lưới của đối tượng.

Liệu plugin có chứa các script hay không.

Các ID tài sản xem trước nhóm cho một mục, được phân tách theo loại phương tiện.

Danh sách có sắp xếp của các ID tài sản xem trước hình ảnh.

Danh sách có sắp xếp của các ID tài sản xem trước video.

Chứa thông tin sửa truy vấn cho một truy vấn tìm kiếm.

Sửa chính tả đề xuất cho truy vấn tìm kiếm gốc.

Các khía cạnh của một truy vấn.

Các khía cạnh đã được áp dụng cho tìm kiếm.

Các khía cạnh chưa được sử dụng và vẫn còn khả dụng.

Danh mục để sắp xếp các bản lưu.

Đại diện cho các giá trị loại âm thanh sẽ được hiển thị đúng trong giao diện người dùng Swagger.

Đại diện cho một "một tập con" của các tùy chọn Toolbox.Service.CategoryType và đại diện cho toàn bộ tập
các "danh mục" (hoặc loại tài sản) có thể được tìm kiếm từ API tìm kiếm Toolbox.

Mô hình yêu cầu để tìm kiếm tài sản Creator Store.

Các bộ lọc tìm kiếm cụ thể cho âm thanh.

Các từ khóa bổ sung để tìm kiếm theo.

ID Nhóm của người sáng tạo. Chỉ một trong các 'userId' và 'groupId' có thể xuất hiện trong một truy vấn.

Tệp hình ảnh để tìm kiếm theo. Ảnh phải được mã hóa base64 để được sử dụng trong tìm kiếm. Chỉ một trong các 'query' và 'image' có thể xuất hiện trong một truy vấn.

Liệu kết quả có chỉ nên bao gồm tài sản được tạo bởi các nhà sáng tạo đã xác minh hay không.

Số lượng tài sản được trả về. Không được lớn hơn 100.

Giá tối đa của tài sản tính bằng xu. Nếu có, phải lớn hơn hoặc bằng 0.

Giá tối thiểu của tài sản tính bằng xu. Nếu có, phải lớn hơn hoặc bằng 0.

Các bộ lọc tìm kiếm cụ thể cho mô hình.

Số trang để lấy, bắt đầu từ 0. Chỉ một trong các 'pageNumber' và 'pageToken' có thể xuất hiện trong một truy vấn.

ID cho trang kết quả tìm kiếm mong muốn. Chỉ một trong các 'pageNumber' và 'pageToken' có thể xuất hiện trong một truy vấn.

Các thuật ngữ tìm kiếm được sử dụng để lọc kết quả. Chỉ một trong các 'query' và 'image' có thể xuất hiện trong một truy vấn.

Loại tài sản để tìm kiếm bên trong. Tùy chọn khi Toolbox.Service.SearchCreatorStoreAssetsRequest.CategoryPath
giải quyết thành một loại tài sản; nếu không thì bắt buộc.

Chỉ ra các trường nào sẽ được điền trong phản hồi.

Danh mục để sắp xếp kết quả tìm kiếm theo.

Hướng sắp xếp của kết quả tìm kiếm.

Mã định danh làn sóng tùy chọn (ví dụ: "trending", "essential", "priced").

ID Người dùng của người sáng tạo. Chỉ một trong các 'userId' và 'groupId' có thể xuất hiện trong một truy vấn.

Phản hồi cho điểm cuối SearchCreatorStoreAssets.

Danh sách tài sản cửa hàng người sáng tạo được trả về bởi truy vấn tìm kiếm.

Từ khóa đã lọc được sử dụng để tìm kiếm tài sản, nếu áp dụng.

Mã trang để xem trang tiếp theo của kết quả.

Thông tin chỉnh sửa truy vấn, nếu có một chỉnh sửa sẵn có cho truy vấn tìm kiếm.

Các khía cạnh đã áp dụng và có sẵn của một truy vấn.

Tổng số kết quả cho truy vấn tìm kiếm đã cho.

Giao diện này điều khiển các trường nào được điền trong phản hồi tìm kiếm. Một
giao diện nhẹ hơn sẽ dẫn đến tốc độ phản hồi nhanh hơn và độ tin cậy cao hơn.

Mô hình cho một Liên kết Xã hội.

Lấy hoặc thiết lập loại liên kết.

Danh mục để sắp xếp kết quả tìm kiếm.

Đại diện cho hướng sắp xếp kết quả

Đại diện cho tài sản hiệu ứng âm thanh.

Danh mục con của hiệu ứng âm thanh.

Đường dẫn Danh mục của tài sản, nếu tồn tại.
e.g. "3d__characters"

ID vũ trụ nếu tài sản được tạo trong một vũ trụ cụ thể.

Định danh duy nhất của tài sản.

Các ID tài sản xem trước của tài sản được nhóm theo loại tài sản.

Các liên kết mạng xã hội liên quan đến tài sản.

Thời gian tài sản được cập nhật lần cuối.

Thông tin sản phẩm của cửa hàng người sáng tạo của tài sản.

Liệu tài sản có thể được mua trong Cửa hàng Nhà phát triển hay không.

Giá của tài sản, bao gồm mã tiền tệ.

Lấy hoặc thiết lập có thể bỏ phiếu.

Lấy hoặc thiết lập phiếu bầu xuống.

Lấy phiếu bầu của người dùng.

Lấy hoặc thiết lập hiển thị phiếu bầu.

Phần trăm tổng số phiếu bầu đã được bỏ phiếu lên

Lấy hoặc thiết lập phiếu bầu của người dùng.

Một khóa có thể cấu hình cho phép truy cập chi tiết đến các tài nguyên của Roblox. Xem https://create.roblox.com/docs/cloud/auth/api-keys để biết thêm thông tin.

x-api-key

Một cookie trình duyệt đại diện cho danh tính của người dùng Roblox. KHÔNG CHIA SẺ ĐIỀU NÀY. Việc chia sẻ này sẽ cho phép ai đó đăng nhập như bạn và đánh cắp Robux và vật phẩm của bạn. Chúng tôi không khuyên bạn nên sử dụng cookie để gọi các điểm cuối. Khi có thể, hãy sử dụng khóa API với tiêu đề x-api-key hoặc OAuth 2.0 thay vào đó để xác thực.

.ROBLOSECURITY

Xây dựng hoặc ủy quyền ứng dụng để truy cập tài nguyên Roblox. Xem https://create.roblox.com/docs/cloud/auth/oauth2-overview để biết thêm thông tin.

API Roblox. Xem https://create.roblox.com/docs/cloud/open-cloud để biết thêm chi tiết.

API Roblox

Thêm một sản phẩm Cửa hàng Người 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 Người 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.

Tạo Sản phẩm Cửa hàng Người sáng tạo

CreatorStoreProduct

creator-store-product:write

Lấy một sản phẩm Cửa hàng Người sáng tạo.

ID sản phẩm cửa hàng người sáng tạo.

creator_store_product_id

Lấy Sản phẩm Cửa hàng Người sáng tạo

creator-store-product:read

Cập nhật một sản phẩm Cửa hàng Người sáng tạo.

Danh sách các trường để cập nhật.

updateMask

Nếu được thiết lập là true, và sản phẩm cửa hàng người sáng tạo không được tìm thấy, một sản phẩm cửa hàng người sáng tạo
sẽ được tạo. Trong tình huống này, `update_mask` sẽ bị bỏ qua.

allowMissing

Cập nhật Sản phẩm Cửa hàng Người sáng tạo

targetType

targetId

Các bộ sưu tập tùy chỉnh hiện không được hỗ trợ. Trường này nên được bỏ qua.

collectionName

creator-store-save:write

ID của tài sản để lọc theo. Nếu được cung cấp, loại mục đích cũng phải được cung cấp.

sortBy

sortDirection

Số lượng bản lưu tối đa để trả về

limit

Số trang sẽ trả về, bắt đầu từ 1

page

keyword

Có ẩn các tài sản đã sở hữu hay không

hideOwnedAssets

Lấy bản lưu từ một bộ sưu tập.

creator-store-save:read

Xóa hàng loạt bản lưu.
Tối đa 5000 bản lưu cho mỗi yêu cầu.

Lấy chi tiết cho một tài sản Creator Store duy nhất.

ID của tài sản để lấy chi tiết.

Lấy chi tiết tài sản của Creator Store

Tìm kiếm tài sản trong Creator Store.

Loại tài sản để tìm kiếm bên trong. Tùy chọn khi categoryPath có trong yêu cầu; nếu không thì bắt buộc.

searchCategoryType

Các từ tìm kiếm được sử dụng để lọc các kết quả.

query

Khi tìm kiếm mô hình, các loại phụ liên quan đến kết quả tìm kiếm.

modelSubTypes

Khi tìm kiếm mô hình, các loại phụ không liên quan đến kết quả tìm kiếm.

excludedModelSubTypes

Đã hết hạn: Vui lòng tham khảo các thuộc tính 'userId' và 'groupId' thay vào đó. Loại và ID của người tạo. Ví dụ: "user/123" hoặc "group/456"

creator

ID người dùng của người tạo. Chỉ một trong 'userId' và 'groupId' có thể xuất hiện trong một truy vấn.

userId

ID nhóm của người tạo. Chỉ một trong 'userId' và 'groupId' có thể xuất hiện trong một truy vấn.

groupId

Định danh cho trang kết quả tìm kiếm mong muốn. Chỉ một trong 'pageNumber' và 'pageToken' có thể xuất hiện trong một truy vấn.

pageToken

Số trang để lấy, bắt đầu từ 0. Chỉ một trong 'pageNumber' và 'pageToken' có thể xuất hiện trong một truy vấn.

pageNumber

Số lượng tài sản sẽ được trả về. Không thể lớn hơn 100.

maxPageSize

Hướng sắp xếp của các kết quả tìm kiếm.

Danh mục để sắp xếp các kết quả tìm kiếm theo.

sortCategory

Khi tìm kiếm âm thanh, thời gian tối thiểu của các tài sản âm thanh. Nếu có bao gồm, phải lớn hơn hoặc bằng 0.

audioMinDurationSeconds

Khi tìm kiếm âm thanh, thời gian tối đa của các tài sản âm thanh. Nếu có bao gồm, phải lớn hơn hoặc bằng 0.

audioMaxDurationSeconds

Khi tìm kiếm âm thanh, tên nghệ sĩ của các tài sản âm thanh.

audioArtist

Khi tìm kiếm âm thanh, tên album của các tài sản âm thanh.

audioAlbum

Tìm kiếm tài sản trong Creator Store

Creator Store

Assets

Không khuyến khích