*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

CreatorStoreProduct

크리에이터 스토어에서 제품을 나타냅니다. 이 리소스는 크리에이터 스토어에서 자산의 배포 및 가격 책정을 관리하는 데 사용됩니다.

특성

pathstring

크리에이터 스토어 제품의 리소스 경로.

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

basePriceobject

제품의 기본 가격.자세한 내용은 돈을 참조하십시오.각 제품 유형(예: pluginAssetId )은 특정 가격 세트를 지원합니다.현재 USD에서 기본 가격만 설정하는 것만 지원됩니다.

유형에 따라 각 크리에이터 스토어 제품에는 지원되는 가격 집합이 고정되어 있습니다; 전체 목록은 productType 특성을 참조하십시오.예를 들어, 플러그인 가격을 $4.99로 설정하려면 다음 기본 가격을 사용하십시오:


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

참고: 지수 는 -9여야 하고 유효 숫자는 이 형식으로 되어야 합니다. 해당 10진수 형식은 significand * 10^exponent입니다.

플러그인 가격을 $0(즉, 무료)로 설정하려면 다음 base_price를 사용하십시오


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

참고: 무료 제품에 대해서도 currencyCode를 USD로 설정해야 합니다.

실제 구매 가격은 이 기본 가격을 기반으로 하지만, 지역 특정 고려 사항으로 인해 종종 약간 다릅니다.

제품을 무료로 만들려면 이를 0으로 설정합니다.

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

출력 전용

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

이 값이 true이려면 published 가 true이고 restrictions 가 비어 있어야 합니다.이 값이 거짓이면 제품을 어떤 사용자도 획득할 수 없습니다.

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, $149.99, $199.99, $249.99.

audioAssetIdstring

불변

크리에이터 스토어 제품은 이 자산 ID가 있는 오디오 파일입니다.

decalAssetIdstring

불변

크리에이터 스토어 제품은 이 자산 ID를 가진 데칼입니다.

meshPartAssetIdstring

불변

크리에이터 스토어 제품은 이 자산 ID를 가진 메시 부품입니다.

videoAssetIdstring

불변

크리에이터 스토어 제품은 이 자산 ID가 있는 비디오입니다.

fontFamilyAssetIdstring

불변

크리에이터 스토어 제품은 이 자산 ID를 가진 글꼴 가족입니다.

기본 URL

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

크리에이터 스토어 제품 생성
베타

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

크리에이터 스토어 제품 가져오기
베타

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

크리에이터 스토어 제품 업데이트
베타

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

크리에이터 상점 제품 업데이트.

범위

creator-store-product:write

요청경로 매개 변수

creator_store_product_idstring

필수

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

쿼리 매개 변수

updateMaskstring

업데이트할 필드 목록. 이 문자열은 FieldMask 형식으로 지정됩니다.

allowMissingboolean

설정이 true로 설정되고 크리에이터 스토어 제품이 찾을 수 없으면 크리에이터 스토어 제품이 생성됩니다. 이 상황에서 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"
}

CreatorStoreProduct

특성

CreatorStoreProduct

크리에이터 스토어 제품 생성베타

CreatorStoreProduct

크리에이터 스토어 제품 가져오기베타

CreatorStoreProduct

크리에이터 스토어 제품 업데이트베타

크리에이터 스토어 제품 생성
베타

크리에이터 스토어 제품 가져오기
베타

크리에이터 스토어 제품 업데이트
베타