[Creator Store](/production/creator-store)에서의 존재를 관리합니다. 자산에 대한 제품 목록을 [생성](#Cloud_CreateCreatorStoreProduct) 및 [업데이트](#Cloud_UpdateCreatorStoreProduct)하며, 다양한 필터를 사용하여 자산을 [툴박스에서 검색](#Toolbox_SearchCreatorStoreAssets)합니다.


오디오 유형(뮤직 또는 사운드 효과)입니다.

오디오 파일의 지속 시간(초)입니다.

오디오 전용 검색 필터 매개변수입니다.

필터링할 아티스트의 이름입니다.

포함할 오디오 유형(예: 음악, 사운드 효과)입니다.

오디오의 최대 지속 시간(초)입니다. 포함할 경우, 1 이상이어야 합니다.

오디오의 최소 지속 시간(초)입니다. 포함할 경우, 0 이상이어야 합니다.

어떤 음악 차트를 필터링할 지를 나타냅니다.

저장을 대량으로 삭제하기 위한 요청 모델입니다.

저장을 대량으로 삭제하는 작업에 대한 응답 모델입니다.

성공적으로 삭제된 저장의 수입니다.

저장을 생성하기 위한 요청 모델입니다.

현재 사용자 정의 컬렉션은 지원되지 않습니다.
이 필드는 생략해야 합니다.

제작자를 나타내는 모델입니다.

사용하지 마십시오: 대신 'userId' 및 'groupId' 속성을 참조하십시오.
제작자 유형 및 ID입니다. 예: user/123 또는 group/456.

그룹 ID입니다. 에셋이 그룹 소유인 경우 필수입니다.

이 값은 그룹 기반 제작자에게만 존재하며 에셋을 가장 최근에 업데이트한 제작자의 사용자 ID를 나타냅니다.

이 값은 그룹 기반 제작자에게만 존재하며 에셋을 가장 최근에 업데이트한 제작자의 이름을 나타냅니다.

제작자의 User ID입니다. 에셋이 개인 사용자 소유인 경우 필수입니다.

제작자가 인증되었는지 여부입니다.

제작자 스토어 자산을 나타냅니다.

에셋 제작자의 세부정보입니다.

모델이 가지는 기능을 나타냅니다(예: 샌드박싱).
오직 모델 에셋 유형에 대해서만 존재하며, AMRS가 사용 가능할 때 응답에 포함합니다.

모델에 스크립트가 있을 경우 삽입 시 샌드박스 처리할지 여부를 제어합니다.

제작자 스토어의 제품을 나타냅니다. 이 리소스는 제작자 스토어에서 에셋의 배포 및 가격 관리를 위해 사용됩니다.

제작자 스토어 제품은 이 에셋 ID를 가진 오디오 파일입니다.

제작자 스토어 제품은 이 에셋 ID를 가진 데칼입니다.

제작자 스토어 제품은 이 에셋 ID를 가진 글꼴 패밀리입니다.

제품을 판매하는 Roblox 그룹입니다.

제작자 스토어 제품은 이 에셋 ID를 가진 메시 파트입니다.

제작자 스토어 제품은 이 에셋 ID를 가진 모델입니다.

제작자 상점 제품의 리소스 경로입니다.

형식: `creator-store-products/{creator_store_product_id}`

제작자 스토어 제품은 이 에셋 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

판매자가 제작자 스토어에서 제품을 배포할 계획인지 여부입니다. 판매자가 제품을 배포하려는 의사는 있지만 판매자나 하위 제작자 스토어 제품에 대한 일부 제한 때문에,
제품이 구매 가능하지 않을 수 있습니다. 자세한 내용은 `restrictions`와 `purchasable`을 참조하십시오.

제품을 구매할 수 있는지 여부입니다.

이 값이 true가 되려면 `published`가 true여야 하며 `restrictions`는 비워져 있어야 합니다. 이 값이 false라면, 제품은 어떤 사용자에게도 얻을 수 없습니다.

제품에 적용된 제한 사항입니다. 제품은 동시에 여러 제한 사항이 활성화될 수 있습니다.

가능한 값:

  | 값 | 설명 |
  | --- | --- |
  | RESTRICTION_UNSPECIFIED | 명시되지 않은 제한 사항입니다. |
  | SOLD_ITEM_RESTRICTED | 판매되는 항목이 Roblox에 의해 제한되었습니다. 자세한 정보는 해당 항목을 직접 조회하여 확인할 수 있습니다. |
  | SELLER_TEMPORARILY_RESTRICTED | 제품은 판매자의 계정이 Roblox에 의해 일시적으로 제한되어 제한됩니다. |
  | SELLER_PERMANENTLY_RESTRICTED | 제품은 판매자의 계정이 Roblox에 의해 영구적으로 제한되었기 때문에 제한됩니다. |
  | SELLER_NO_LONGER_ACTIVE | 제품은 판매자의 계정이 삭제되었거나 더 이상 활성화되지 않기 때문에 제한됩니다. |

제품을 판매하는 Roblox 사용자입니다.

제작자 스토어 제품은 이 에셋 ID를 가진 비디오입니다.

과학적 표기법과 유사한 형식으로 소수 숫자를 나타냅니다.

예제:
 - 17            === `{significand: 17   exponent: 0} (또는 단순히 {significand:
   17})`
 - -0.005        === `{significand: -5   exponent: -3}`
 - 33.5 million  === `{significand: 335  exponent: 5}`
 - 11/8 (1.375)  === `{significand: 1375 exponent: -3}`

소수의 범위가 JSON `number`(이중) 및 `decimal64` 범위를 초과한다는 점에 유의하십시오.

유효 숫자 내에서 소수점의 위치를 나타냅니다.

지수가 0일 때, Decimal의 값은 단순히 `significand`의 값입니다.

지수가 0보다 클 때, 유효 숫자 다음에 오는 쌍의 숫자의 개수를 나타냅니다.

지수가 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) 유형이 모델에 포함되도록 필터링합니다.

포함되는 경우, 이러한 하위 유형이 있는 자산만 검색합니다.

지원되는 모델 하위 유형입니다.

통화 유형과 함께 금액을 나타냅니다.

예:
 - 5달러는 `{currency_code: "USD" quantity: {significand: 5}}`

통화 코드입니다.

이는 ISO 4217에 정의된 3자리 통화 코드일 수 있습니다.

API는 ISO 4217 표준에 포함되지 않은 추가 통화 코드를 정의할 수 있습니다(예: 가상 통화 또는 암호 화폐). 이러한 코드는 `X-`로 시작해야 하며, 이는 잠재적인 향후 ISO 4217 코드와 구분하기 위함입니다. 예를 들어, `"USD"`는 미국 달러에 대한 ISO 4217 코드입니다.

항목을 가져올 음악 차트를 나타냅니다(있는 경우)

삼각형 및 정점 수와 같은 객체의 메쉬 특성 요약을 제공합니다.

객체의 메시의 총 삼각형 수입니다.

객체의 메시의 총 정점 수입니다.

플러그인에 스크립트가 있는지 여부입니다.

플러그인에 있는 스크립트 수입니다.

항목에 대한 그룹화된 미리보기 자산 ID, 미디어 유형으로 구분됩니다.

이미지 미리보기 자산 ID의 정렬된 목록입니다.

비디오 미리보기 자산 ID의 정렬된 목록입니다.

검색 쿼리에 대한 쿼리 수정 정보를 포함합니다.

원본 검색 쿼리에 대한 권장 철자 수정입니다.

검색에 이미 적용된 패싯입니다.

사용되지 않은 여전히 사용 가능한 패싯입니다.

저장 내용을 정렬할 카테고리입니다.

Swagger UI에서 올바르게 표시될 오디오 유형 값을 나타냅니다.

이것은 Toolbox.Service.CategoryType 옵션의 "하위 집합"을 나타내며, Toolbox 검색 API에서 검색할 수 있는 전체 "카테고리"(또는 자산 유형)를 나타냅니다.

Creator Store 자산 검색을 위한 요청 모델.

제작자의 그룹 ID. 쿼리에서 'userId'와 'groupId' 중 하나만 존재할 수 있습니다.

검색할 이미 파일. 이미지는 검색에 사용되기 위해 base64로 인코딩되어야 합니다. 쿼리에서 'query'와 'image' 중 하나만 존재할 수 있습니다.

결과에 인증된 제작자만 포함해야 하는지 여부.

반환할 자산의 수. 100을 초과할 수 없습니다.

자산의 최대 가격 (센트 단위). 포함되면 0보다 크거나 같아야 합니다.

자산의 최소 가격 (센트 단위). 포함되면 0보다 크거나 같아야 합니다.

가져올 페이지 번호. 0부터 시작합니다. 쿼리에서 'pageNumber'와 'pageToken' 중 하나만 존재할 수 있습니다.

원하는 검색 결과 페이지의 식별자. 쿼리에서 'pageNumber'와 'pageToken' 중 하나만 존재할 수 있습니다.

결과를 필터링하는 데 사용되는 검색어. 쿼리에서 'query'와 'image' 중 하나만 존재할 수 있습니다.

검색할 자산 유형입니다. Toolbox.Service.SearchCreatorStoreAssetsRequest.CategoryPath
자산 유형으로 확인할 때 선택 사항이며; 그렇지 않으면 필수입니다.

응답에서 어떤 필드가 채워질지를 나타냅니다.

검색 결과를 정렬할 카테고리입니다.

선택적 스윔레인 식별자 (예: "트렌딩", "필수", "가격").

제작자의 사용자 ID. 쿼리에서 'userId'와 'groupId' 중 하나만 존재할 수 있습니다.

SearchCreatorStoreAssets 엔드포인트에 대한 응답.

검색 쿼리에 의해 반환된 생성자 스토어 자산 목록.

자산 검색에 사용된 필터링된 키워드(해당하는 경우).

다음 페이지 결과를 볼 수 있는 페이지 토큰.

검색 쿼리에 대한 수정 정보가 있는 경우.

쿼리에 적용된 및 사용 가능한 패싯.

주어진 검색 쿼리에 대한 총 결과 수.

이 뷰는 검색 응답에서 채워질 필드를 제어합니다. 더 간단한
뷰는 더 빠른 응답 시간과 더 높은 신뢰성을 생성합니다.

링크 유형을 가져오거나 설정합니다.

결과를 정렬할 방향을 나타냅니다.

사운드 효과 자산의 표현입니다.

자산의 카테고리 경로, 존재하는 경우.
e.g. "3d__characters"

자산이 특정 유니버스 내에서 만들어졌을 경우 유니버스 ID입니다.

자산 유형별로 그룹화된 자산의 미리 보기 자산 ID입니다.

자산과 관련된 소셜 링크입니다.

자산이 마지막으로 업데이트된 시간입니다.

자산의 크리에이터 상점 제품 정보입니다.

자산이 Creator Store에서 구매 가능한지 여부입니다.

투표할 수 있는지 가져오거나 설정합니다.

다운 투표를 가져오거나 설정합니다.

투표를 표시하거나 설정합니다.

성공을 가져오거나 설정합니다.

사용자 투표를 가져오거나 설정합니다.

Roblox 리소스에 대한 세부적인 접근을 허용하는 구성 가능한 키입니다. 자세한 내용은 https://create.roblox.com/docs/cloud/auth/api-keys를 참조하세요.

x-api-key

Roblox 사용자의 신원을 나타내는 브라우저 쿠키입니다. 이를 공유하지 마세요. 이를 공유하면 누군가 당신이 로그인하고 Robux와 아이템을 훔칠 수 있습니다. 엔드포인트를 호출할 때는 쿠키 사용을 권장하지 않습니다. 가능하다면 x-api-key 헤더나 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

크리에이터 스토어 제품을 가져옵니다.

크리에이터 스토어 제품 ID입니다.

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

반환할 페이지 번호로, 1부터 시작합니다.

page

keyword

소유 자산을 숨길지 여부입니다.

hideOwnedAssets

컬렉션에서 저장된 항목을 가져옵니다.

creator-store-save:read

저장을 일괄 삭제합니다.
요청당 최대 5000개의 저장 항목을 삭제할 수 있습니다.

단일 크리에이터 스토어 자산에 대한 세부정보를 가져옵니다.

세부정보를 검색할 자산 ID입니다.

크리에이터 스토어 자산 세부정보 가져오기

자산에 대해 크리에이터 스토어를 검색합니다.

검색할 자산 유형입니다. categoryPath가 요청에 존재할 때 선택 사항이며; 그렇지 않으면 필수입니다.

searchCategoryType

결과를 필터링하는 데 사용되는 검색어입니다.

query

모델을 검색할 때, 검색 결과와 연결된 하위 유형입니다.

modelSubTypes

모델을 검색할 때, 검색 결과와 연결되지 않은 하위 유형입니다.

excludedModelSubTypes

사용 중단: 'userId' 및 'groupId' 속성을 참조하십시오. 생성자 유형 및 ID입니다. 예: "user/123" 또는 "group/456"

creator

생성자의 사용자 ID입니다. 쿼리에는 'userId'와 'groupId' 중 하나만 포함될 수 있습니다.

userId

생성자의 그룹 ID입니다. 쿼리에는 'userId'와 'groupId' 중 하나만 포함될 수 있습니다.

groupId

원하는 검색 결과 페이지에 대한 식별자입니다. 쿼리에는 'pageNumber'와 'pageToken' 중 하나만 포함될 수 있습니다.

pageToken

검색할 페이지 번호, 0부터 시작합니다. 쿼리에는 'pageNumber'와 'pageToken' 중 하나만 포함될 수 있습니다.

pageNumber

반환할 자산 수입니다. 100보다 클 수 없습니다.

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

쿼리 시 사용할 추가 키워드입니다.

Creator Store

Assets

권장되지 않음