*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

CreatorStoreProduct

Representa un prodotto nel Creator Store. Questa risorsa viene utilizzata per gestire la distribuzione e il prezzo delle risorse sul Creator Store.

Attributi

pathstring

Il percorso delle risorse del prodotto del negozio creatore.

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

basePriceobject

Il prezzo di base del prodotto.Per ulteriori informazioni, vedi Denaro.Ogni tipo di prodotto (come pluginAssetId ) supporta un set di prezzi specifici.Attualmente, solo l'impostazione di un prezzo di base in USD è supportata.

A seconda del tipo, ogni prodotto del Creator Store ha un set fisso di prezzi supportati; vedi l'attributo productType per l'elenco completo.Ad esempio, per impostare il prezzo di un plugin a $4.99, usa il seguente prezzo di base:


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

Nota: l'esponente deve essere -9, e il significante deve essere in questo formato. Il formato corrispondente Decimale è significand * 10^exponent .

Se vuoi impostare il prezzo di un plugin a $0 (cioè gratuito), usa il seguente base_price


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

Nota: devi ancora impostare il currencyCode a USD, anche per i prodotti gratuiti.

Il prezzo di acquisto effettivo è basato su questo prezzo di base, ma spesso differisce leggermente a causa di considerazioni locali specifiche.

Imposta questo a zero per rendere il prodotto gratuito.

purchasePriceobject

Il prezzo d'acquisto effettivo per l'utente, dopo aver tenuto conto delle considerazioni specifiche del locale.

publishedboolean

Se il venditore intende distribuire il prodotto Creator Store sul Creator Store.Un venditore potrebbe voler distribuire un prodotto, ma a causa di alcune restrizioni sul venditore o sul prodotto Creator Store sottostante, il prodotto potrebbe non essere disponibile per l'acquisto.Vedi restrictions e purchasable per maggiori dettagli.

restrictionsarray<enum>
Solo output

Restrizioni applicate al prodotto. Un prodotto può avere più restrizioni attive contemporaneamente.

Valori possibili:

| Valore | Descrizione | | --- | --- | | RESTRICTION_UNSPECIFIED | Restrizione non specificata.| | SOLD_ITEM_RESTRICTED | L'articolo in vendita è stato limitato da Roblox I dettagli possono essere disponibili cercando quell'articolo direttamente.| | SELLER_TEMPORARILY_RESTRICTED | Il prodotto è limitato perché l'account del venditore è temporaneamente limitato da Roblox.| | SELLER_PERMANENTLY_RESTRICTED | Il prodotto è limitato perché l'account del venditore è permanentemente limitato da Roblox.| | SELLER_NO_LONGER_ACTIVE | Il prodotto è limitato perché l'account del venditore è stato eliminato o in altro modo non è più attivo. |. Valori possibili:

purchasableboolean
Solo output

Se il prodotto è acquistabile.

Perché questo valore sia vero, published deve essere vero e restrictions deve essere vuoto.Se questo valore è falso, il prodotto non può essere acquisito da nessun utente.

Uno dei seguenti per seller:

userSellerstring
Solo output

L'utente Roblox che vende il prodotto.

groupSellerstring
Solo output

Il gruppo Roblox che vende il prodotto.

Uno dei seguenti per productType:

modelAssetIdstring
Immutabile

Il prodotto Creator Store è un modello con questo ID risorsa.

pluginAssetIdstring
Immutabile

Il prodotto Creator Store è un plugin con questo ID risorsa.

Prezzi base supportati 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
Immutabile

Il prodotto Creator Store è un file audio con questo ID risorsa.

decalAssetIdstring
Immutabile

Il prodotto Creator Store è un'immagine con questo ID risorsa.

meshPartAssetIdstring
Immutabile

Il prodotto Creator Store è una parte mesh con questo ID risorsa.

videoAssetIdstring
Immutabile

Il prodotto Creator Store è un video con questo ID risorsa.

fontFamilyAssetIdstring
Immutabile

Il prodotto Creator Store è una famiglia di caratteri con questo ID risorsa.

URL di base

https://apis.roblox.com
Risorsa 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

Crea prodotto Creator Store
Beta

POST /cloud/v2/creator-store-products

Aggiungi un prodotto del Creator Store.Usa solo questo metodo se il tuo prodotto non è mai stato distribuito sul Creator Store; altrimenti, usa il metodo PATCH per aggiornare il prodotto.

Campi
creator-store-product:write
RichiestaCorpo della richiestaCreatorStoreProduct
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
}'
Risposta

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

Ottieni il prodotto Creator Store
Beta

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

Ottieni un prodotto Creator Store.

Campi
creator-store-product:read
RichiestaParametri percorso
creator_store_product_idstring
Necessario

L'ID del prodotto creator-store.

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}'
Risposta

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

Aggiorna prodotto Creator Store
Beta

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

Aggiorna un prodotto del Creator Store.

Campi
creator-store-product:write
RichiestaParametri percorso
creator_store_product_idstring
Necessario

L'ID del prodotto creator-store.

Parametri query
updateMaskstring

L'elenco dei campi da aggiornare. Questa stringa è formattata come Timestamp.

allowMissingboolean

Se impostato su vero e il prodotto del negozio creatore non viene trovato, viene creato un prodotto del negozio creatore. In questa situazione, update_mask viene ignorato.

Corpo della richiestaCreatorStoreProduct
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
}'
Risposta

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