*このコンテンツは、ベータ版のAI（人工知能）を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、こちらをクリックしてください。

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 を USD に設定し続ける必要があります。

実際の購入価格は、このベース価格に基づいていますが、ローカル固有の考慮事項により、頻繁にわずかに異なります。

これをゼロに設定して、製品を無料にします。.

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 が空でなければなりません。この値が false の場合、製品はユーザーによって入手できない可能性があります。.

以下のうちの一つの seller:

userSellerstring

出力のみ

製品を販売する Roblox ユーザー。.

groupSellerstring

出力のみ

製品を販売する Roblox グループ。.

以下のうちの一つの productType:

modelAssetIdstring

不変

クリエイターストアの製品は、このアセットIDを持つモデルです。.

pluginAssetIdstring

不変

クリエイターストアの製品は、このアセットIDを持つプラグインです。

サポートされたベース価格 USD: $0、$number1、$number2、$number3、$number4、$number5、$number6、$number7、$number8、$number9、$number10、$number11、$number12、$number13、$number14、$number15、$number16、$number17、$number18、$number19、$number24、$number29、$number34、$number39、$number44、$number49、$number59、$number69、$number79、$number89、$number99、$number149、$number199、$number249.

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

更新するフィールドのリスト。. この文字列は Timestamp としてフォーマットされています。

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

CreatorStoreProduct

属性

CreatorStoreProduct

クリエイターストア製品を作成ベータ版

CreatorStoreProduct

クリエイターストア製品を入手ベータ版

CreatorStoreProduct

クリエイターストア製品を更新ベータ版

クリエイターストア製品を作成
ベータ版

クリエイターストア製品を入手
ベータ版

クリエイターストア製品を更新
ベータ版