[Creator Store](/production/creator-store)でのあなたの存在感を管理します。[製品を作成](#Cloud_CreateCreatorStoreProduct)し、資産のための製品リストを[更新](#Cloud_UpdateCreatorStoreProduct)し、さまざまなフィルターを使用して資産を[検索](#Toolbox_SearchCreatorStoreAssets)します。


音声のタイプ（音楽または効果音）。

音声特有の検索フィルタパラメータ。

フィルターするアルバムの名前。

フィルターするアーティストの名前。

含める音声タイプ（例：音楽、効果音）

音声の最大長さ（秒）。含める場合は、1以上でなければなりません。

音声の最小長さ（秒）。含める場合は、0以上でなければなりません。

どの音楽ランキングをフィルタリングするかを示します。

保存を一括削除するためのリクエストモデル。

一括削除保存操作のレスポンスモデル。

保存を作成するためのリクエストモデル。

カスタムコレクションは現在サポートされていません。
このフィールドは省略する必要があります。

非推奨: 代わりに'userId'と'groupId'プロパティを参照してください。
クリエイターのタイプとID。例: user/123 または group/456。

グループID。アセットがグループ所有の場合に必要です。

この値はグループベースのクリエイターにのみ存在し、アセットを最も最近更新したクリエイターのユーザーIDを示します。

この値はグループベースのクリエイターにのみ存在し、アセットを最も最近更新したクリエイターの名前を示します。

クリエイターのユーザーID。アセットが個人ユーザー所有である場合に必要です。

クリエイターが確認済みかどうか。

クリエイター店舗アセットの表現。

アセットクリエイターの詳細。

モデルが持つ機能（例：サンドボックス化）を表します。
モデルアセットタイプのみに存在し、利用可能な場合にAMRSがレスポンスに含めます。

スクリプトを持つモデルが挿入時にサンドボックス化されるかどうかを制御します。

Creator Store内の製品を表します。このリソースは、Creator Store上のアセットの配布と価格設定を管理するために使用されます。

Creator Store製品は、このアセットIDを持つ音声ファイルです。

Creator Store製品は、このアセットIDを持つデカールです。

Creator Store製品は、このアセットIDを持つフォントファミリーです。

製品を販売しているRobloxグループ。

Creator Store製品は、このアセットIDを持つメッシュパートです。

Creator Store製品は、このアセットIDを持つモデルです。

クリエイター店舗製品のリソースパス。

フォーマット: `creator-store-products/{creator_store_product_id}`

Creator Store製品は、このアセット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

販売者がCreator StoreでCreator Store製品を配布する意図があるかどうか。 販売者は製品を配布することを意図しているかもしれませんが、販売者または基盤のCreator Store製品にいくつかの制約があるため、製品が購入可能でない場合があります。 `restrictions`や`purchasable`を参照して詳細を確認してください。

製品が購入可能かどうか。

この値が真であるためには、`published`が真であり、`restrictions`が空である必要があります。この値が偽の場合、製品はどのユーザーによっても取得できない可能性があります。

製品に適用される制限。1つの製品に複数の制限を同時にアクティブにすることができます。

可能な値:

  | 値 | 説明 |
  | --- | --- |
  | RESTRICTION_UNSPECIFIED | 特定されていない制限。 |
  | SOLD_ITEM_RESTRICTED | 販売されているアイテムはRobloxによって制限されています。詳細はそのアイテムを直接調べることで確認できます。 |
  | SELLER_TEMPORARILY_RESTRICTED | 販売者のアカウントが一時的にRobloxによって制限されているため、製品が制限されています。 |
  | SELLER_PERMANENTLY_RESTRICTED | 販売者のアカウントが永続的にRobloxによって制限されているため、製品が制限されています。 |
  | SELLER_NO_LONGER_ACTIVE | 販売者のアカウントが削除されたか、その他の理由で非アクティブとなったため、製品が制限されています。 |

製品を販売しているRobloxユーザー。

Creator Store製品は、このアセットIDを持つビデオです。

科学的表記に似た形式の10進数を表します。

例:
 - 17            === `{significand: 17   exponent: 0}（または単に {significand:
   17）}`
 - -0.005        === `{significand: -5   exponent: -3}`
 - 33.5百万    === `{significand: 335  exponent: 5}`
 - 11/8（1.375）=== `{significand: 1375 exponent: -3}`

Decimalの範囲はJSONの`number`（ダブル）および`decimal64`の範囲を超えています。

有効桁内の小数点の位置を表します。

指数が0の場合、Decimalの値は単に`significand`の値です。

指数が0より大きい場合、有効桁の後に続くゼロの数を表します。

指数が0より小さい場合、有効桁（および必要に応じて暗黙の先頭ゼロ）のうち、いくつが小数点の後に来るかを表します。

保存を削除するためのリクエストモデル。

削除されているアセットのタイプ

保存を取得するためのレスポンスモデル。

保存を取得または設定します。

クエリに一致する保存の総数。

資産の詳細で充填された保存記録。

その資産がユーザーによって所有されているかどうか。

資産内のさまざまなインスタンスタイプのカウントを表します。
[Instance](https://create.roblox.com/docs/reference/engine/classes/Instance)を参照してください。

アニメーションインスタンスの数。

オーディオインスタンスの数。

スクリプトインスタンスの数。

メッシュパートのメッシュID。

メッシュパートのテクスチャID。

アセットのスクリプト機能（サンドボックス）。

モデルにスクリプトがあるかどうか。

モデル内のスタジオインスタンスタイプの数。
[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)タイプがモデルに含まれていることを確認します。

含まれている場合、これらのサブタイプを持つアセットのみ検索します。

サポートされているモデルのサブタイプ。

通貨タイプの金額を表します。

例:
 - 五米ドル === `{currency_code: "USD" quantity: {significand: 5}}`

通貨コード。

これはISO 4217で定義された3文字の通貨コードである可能性があります。

APIはISO4217標準に含まれない追加の通貨コードを定義する場合があります（たとえば、仮想通貨や暗号通貨）。これらは`X-`で始まる必要があります。これにより将来のISO4217コードと区別できます。たとえば、`"USD"`は米ドルのISO4217コードです。

エントリを取得する音楽チャートを表します。

オブジェクトのメッシュ特性の概要（例：三角形数と頂点数）。

オブジェクトのメッシュ内の三角形の合計数。

オブジェクトのメッシュ内の頂点の合計数。

プラグインにスクリプトがあるかどうか。

プラグイン内に含まれるスクリプトの数。

メディアタイプによって区切られたアイテムのグループ化されたプレビューアセットID。

画像プレビューアセットIDの順序付きリスト。

ビデオプレビューアセットIDの順序付きリスト。

検索クエリの修正情報を含みます。

元の検索クエリに対する推奨のスペル修正。

検索にすでに適用されているファセット。

未使用でまだ利用可能なファセット。

セーブを並べ替えるためのカテゴリー。

Swagger UIで適切に表示されるオーディオタイプの値を表します。

Toolbox.Service.CategoryTypeオプションの「サブセット」を表し、ツールボックス検索APIから検索可能な「カテゴリ」（またはアセットタイプ）の完全なセットを表します。

クリエイターストアアセットを検索するためのリクエストモデル。

オーディオ専用の検索フィルター。

フィルタリングするためのカテゴリパス。

追加のキーワードによるクエリ。

クリエイターのグループID。クエリには「userId」と「groupId」のうち1つしか存在できません。

検索するための画像ファイル。画像は、検索に使用するためにbase64でエンコードされている必要があります。「query」と「image」のうち1つしかクエリに存在できません。

結果に検証済みクリエイターが作成したアセットのみを含めるべきかどうか。

返されるアセットの数。最大100を超えることはできません。

アセットの最高価格（セント単位）。含まれる場合、0以上でなければなりません。

アセットの最低価格（セント単位）。含まれる場合、0以上でなければなりません。

モデル専用の検索フィルター。

0から始まる取得するページ番号。クエリには「pageNumber」と「pageToken」のうち1つしか存在できません。

目的の検索結果ページの識別子。クエリには「pageNumber」と「pageToken」のうち1つしか存在できません。

結果をフィルタリングするために使用される検索用語。クエリには「query」と「image」のうち1つしか存在できません。

検索対象のアセットタイプ。Toolbox.Service.SearchCreatorStoreAssetsRequest.CategoryPathがアセットタイプに解決される場合はオプションですが、そうでない場合は必須です。

レスポンスにポピュレートされるフィールドを示します。

検索結果を並べ替えるためのカテゴリ。

オプションのスイムレーン識別子（例: "trending", "essential", "priced"）。

クリエイターのユーザーID。クエリには「userId」と「groupId」のうち1つしか存在できません。

SearchCreatorStoreAssetsエンドポイントへのレスポンス。

検索クエリによって返されたクリエイターストアアセットのリスト。

アセット検索に使用されたフィルタされたキーワード（該当する場合）。

次の結果ページを見るためのページトークン。

検索クエリの修正情報。修正が利用可能な場合。

クエリの適用されたおよび利用可能なファセット。

指定された検索クエリに対する結果の総数。

このビューは検索レスポンスにポピュレートされるフィールドを制御します。軽量な
ビューは、応答時間を早くし、信頼性を高めます。

リンクtypeを取得または設定します。

検索結果を並べ替えるためのカテゴリー。

結果を並べ替える方向を表します

サウンドエフェクトアセットの表現。

サウンドエフェクトのサブカテゴリ。

アセットのカテゴリパス（存在する場合）。
例: "3d__characters"

アセットが特定のユニバース内で作成された場合のユニバースID。

アセットのプレビューアセットID、アセットタイプごとにグループ化。

アセットに関連するソーシャルリンク。

アセットが最後に更新された時間。

アセットのクリエイターストア製品情報。

アセットがクリエイターストアで購入可能かどうか。

通貨コードを含むアセットの価格。

投票できるかどうかを取得または設定します。

ダウン投票を取得または設定します。

投票を表示または設定します。

アップボートの割合を示す投票の合計票数。

成功を取得または設定します。

ユーザーの投票を取得または設定します。

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

page

フィルタリングするためのキーワード

keyword

所有しているアセットを隠すかどうか

hideOwnedAssets

コレクションからセーブを取得します。

creator-store-save:read

セーブを一括削除します。
リクエストごとに最大5000のセーブ。

単一のクリエイターストアアセットの詳細を取得します。

クリエイターストアアセットの詳細を取得

アセットのためにクリエイターストアを検索します。

検索対象のアセットタイプ。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

オーディオを検索する際のオーディオアセットのアルバム名。