*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

CreatorStoreProduct

Vertreibt ein Produkt im Creator-Store. Diese Ressource wird verwendet, um die Verteilung und Preisgestaltung von Assets im Creator-Store zu verwalten.

Attribute

pathstring

Der Ressourcenpfad des Creator-Store-Produkts.

Format: creator-store-products/{creator_store_product_id}.

basePriceobject

Der Basispreis des Produkts.Für weitere Informationen, siehe Geld.Jeder Produkttyp (z. B. pluginAssetId ) unterstützt eine Reihe von spezifischen Preisen.Derzeit wird nur die Festlegung eines Grundpreises in USD unterstützt.

Abhängig vom Typ hat jedes Creator-Store-Produkt eine feste Reihe von unterstützten Preisen; siehe das Attribut productType für die volle Liste.Zum Beispiel, um den Preis eines Plugins auf $4.99 festzulegen, verwende den folgenden Basispreis:


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

Hinweis: Der Exponent muss -9 sein, und der Zähler muss in diesem Format sein. Das entsprechende Dekimal -Format ist significand * 10^exponent.

Wenn du den Preis eines Plugins auf $0 (d.h. kostenlos) festlegen möchtest, verwende das folgende base_price


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

Hinweis: Du musst die currencyCode auf USD festlegen, auch für kostenlose Produkte.

Der tatsächliche Kaufpreis basiert auf diesem Basispreis, unterscheidet sich aber oft leicht aufgrund lokalspezifischer Überlegungen.

Setze dies auf Null, um das Produkt kostenlos zu machen.

purchasePriceobject

Der effektive Kaufpreis für den Benutzer, nach Berücksichtigung lokalspezifischer Überlegungen.

publishedboolean

Ob der Verkäufer beabsichtigt, das Creator-Store-Produkt im Creator-Store zu verteilen.Ein Verkäufer könnte beabsichtigen, ein Produkt zu verteilen, aber aufgrund einiger Einschränkungen für den Verkäufer oder das zugrunde liegende Creator-Store-Produkt ist das Produkt möglicherweise nicht zum Kauf verfügbar.Siehe restrictions und purchasable für weitere Details.

restrictionsarray<enum>
Nur Ausgabe

Beschränkungen, die auf das Produkt angewendet werden. Ein Produkt kann mehrere Beschränkungen gleichzeitig aktiv haben.

Mögliche Werte:

| Wert | Beschreibung | | --- | --- | | RESTRICTION_UNSPECIFIED | Unspezifizierte Einschränkung.| | SOLD_ITEM_RESTRICTED | Das verkaufte Item wurde von Roblox eingeschränkt Details können durch die Suche nach diesem Artikel direkt verfügbar sein.| | SELLER_TEMPORARILY_RESTRICTED | Das Produkt ist eingeschränkt, weil das Konto des Verkäufers zeitweise durch Roblox eingeschränkt wird.| | SELLER_PERMANENTLY_RESTRICTED | Das Produkt ist eingeschränkt, weil das Konto des Verkäufers von Roblox dauerhaft eingeschränkt wird.| | SELLER_NO_LONGER_ACTIVE | Das Produkt ist eingeschränkt, weil das Konto des Verkäufers gelöscht wurde oder es sonst nicht mehr aktiv ist. |. Mögliche Werte:

purchasableboolean
Nur Ausgabe

Ob das Produkt käuflich ist.

Damit dieser Wert wahr ist, müssen published wahr sein und restrictions muss leer sein.Wenn dieser Wert falsch ist, kann das Produkt von keinem Benutzer erworben werden.

Eins der folgenden für seller:

userSellerstring
Nur Ausgabe

Der Roblox-Benutzer, der das Produkt verkauft.

groupSellerstring
Nur Ausgabe

Die Roblox-Gruppe, die das Produkt verkauft.

Eins der folgenden für productType:

modelAssetIdstring
Unveränderlich

Das Creator-Store-Produkt ist ein Modell mit dieser Asset-ID.

pluginAssetIdstring
Unveränderlich

Das Creator-Store-Produkt ist ein Plugin mit dieser Asset-ID.

Unterstützte Basispreise in 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.

audioAssetIdstring
Unveränderlich

Das Produkt des Creator-Shops ist eine Audiodatei mit dieser Asset-ID.

decalAssetIdstring
Unveränderlich

Das Creator-Store-Produkt ist ein Abzeichen mit dieser Asset-ID.

meshPartAssetIdstring
Unveränderlich

Das Creator-Store-Produkt ist ein Mesh-Teil mit dieser Asset-ID.

videoAssetIdstring
Unveränderlich

Das Creator-Store-Produkt ist ein Video mit dieser Asset-ID.

fontFamilyAssetIdstring
Unveränderlich

Das Creator-Store-Produkt ist eine Schriftfamilie mit dieser Asset-ID.

Basis-URL

https://apis.roblox.com
Die CreatorStoreProduct-Ressource

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

Ersteller-Store-Produkt erstellen
Beta

POST /cloud/v2/creator-store-products

Füge ein Creator-Store-Produkt hinzu.Verwende diese Methode nur, wenn dein Produkt noch nie im Creator-Store verteilt wurde; ansonsten verwende die Methode PATCH, um das Produkt zu aktualisieren.

Bereiche
creator-store-product:write
AnfrageText anfordernCreatorStoreProduct
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
}'
Rückmeldung

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

Creator-Store-Produkt erhalten
Beta

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

Hole dir ein Creator-Store-Produkt.

Bereiche
creator-store-product:read
AnfragePfadparameter
creator_store_product_idstring
Erforderlich

Die ID des Creator-Store-Produkts.

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}'
Rückmeldung

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

Creator-Store-Produkt aktualisieren
Beta

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

Aktualisiere ein Creator-Store-Produkt.

Bereiche
creator-store-product:write
AnfragePfadparameter
creator_store_product_idstring
Erforderlich

Die ID des Creator-Store-Produkts.

Anfrageparameter
updateMaskstring

Die Liste der zu aktualisierenden Felder. Dieser String ist als FieldMask formatiert.

allowMissingboolean

Wenn auf wahr gesetzt und das Ersteller-Store-Produkt nicht gefunden wird, wird ein Ersteller-Store-Produkt erstellt. In dieser Situation wird update_mask ignoriert.

Text anfordernCreatorStoreProduct
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
}'
Rückmeldung

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