*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.

CreatorStoreProduct

Representa un producto en la Tienda del creador. Este recurso se utiliza para gestionar la distribución y el precio de los activos en la Tienda del creador.

Atributos

pathstring

El camino de recursos del producto de la tienda de creadores.

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

basePriceobject

El precio base del producto.Para obtener más información, vea Dinero.Cada tipo de producto (como pluginAssetId ) soporta un conjunto de precios específicos.Actualmente, solo se admite establecer un precio base en USD.

Dependiendo del tipo, cada producto de Tienda de creadores tiene un conjunto fijo de precios admitidos; consulte el atributo productType para obtener la lista completa.Por ejemplo, para establecer el precio de un plugin a $4.99, use el siguiente precio base:


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

Nota: El exponente debe ser -9, y el significante debe estar en este formato. El formato decimal correspondiente es .

Si quieres establecer el precio de un plugin a $0 (es decir, gratis), usa el siguiente base_price


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

Nota: aún debe establecer el currencyCode a USD, incluso para productos gratuitos.

El precio de compra real se basa en este precio base, pero a menudo difiere ligeramente debido a consideraciones específicas del lugar.

Establece esto en cero para hacer que el producto sea gratuito.

purchasePriceobject

El precio de compra efectivo para el usuario, después de tener en cuenta consideraciones específicas del lugar.

publishedboolean

Si el vendedor tiene la intención de distribuir el producto de la Tienda del Creador en la Tienda del Creador.Un vendedor podría tener la intención de distribuir un producto, pero debido a algunas restricciones al vendedor o al producto de la Tienda de creadores subyacente, el producto puede no estar disponible para su compra.Vea restrictions y purchasable para más detalles.

restrictionsarray<enum>
Solo salida

Restricciones aplicadas al producto. Un producto puede tener múltiples restricciones activas al mismo tiempo.

Posibles valores:

| Valor | Descripción | | --- | --- | | RESTRICCIÓN_NO_ESPECIFICADA | Restricción no especificada.| | SOLD_ITEM_RESTRICTED | El artículo que se está vendiendo se ha restringido por Roblox Los detalles pueden estar disponibles buscando ese artículo directamente.| | SELLER_TEMPORARILY_RESTRICTED | El producto está restringido porque la cuenta del vendedor está temporalmente restringida por Roblox.| | SELLER_PERMANENTLY_RESTRICTED | El producto está restringido porque la cuenta del vendedor está restringida permanentemente por Roblox.| | SELLER_NO_LONGER_ACTIVE | El producto está restringido porque la cuenta del vendedor se eliminó o de otra manera ya no es activa. |. Valores posibles:

purchasableboolean
Solo salida

Si el producto es adquirible.

Para que este valor sea cierto, published debe ser cierto y restrictions debe estar vacío.Si este valor es falso, el producto no podrá ser adquirido por ningún usuario.

Uno de los siguientes para seller:

userSellerstring
Solo salida

El usuario de Roblox que vende el producto.

groupSellerstring
Solo salida

El grupo de Roblox que vende el producto.

Uno de los siguientes para productType:

modelAssetIdstring
Inmutable

El producto de la Tienda de creadores es un modelo con este ID de activo.

pluginAssetIdstring
Inmutable

El producto de la Tienda de creadores es un plugin con este ID de activo.

Precios base admitidos en 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
Inmutable

El producto de la Tienda de creadores es un archivo de audio con este ID de activo.

decalAssetIdstring
Inmutable

El producto de la Tienda del Creador es una etiqueta con este ID de activo.

meshPartAssetIdstring
Inmutable

El producto de la Tienda del Creador es una parte de malla con este ID de activo.

videoAssetIdstring
Inmutable

El producto de la Tienda de creadores es un video con este ID de activo.

fontFamilyAssetIdstring
Inmutable

El producto de la Tienda de creadores es una familia de fuentes con este ID de activo.

URL base

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

Crear producto de la tienda de creadores
Beta

POST /cloud/v2/creator-store-products

Añade un producto de la tienda de creadores.Solo use este método si su producto nunca se ha distribuido en la Tienda del Creador; de lo contrario, use el método PATCH para actualizar el producto.

Ámbitos
creator-store-product:write
SolicitudSolicitar cuerpoCreatorStoreProduct
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
}'
Respuesta

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

Obtener producto de la tienda de creadores
Beta

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

Obtén un producto de la tienda de creadores.

Ámbitos
creator-store-product:read
SolicitudParámetros de ruta
creator_store_product_idstring
Obligatorio

El ID del producto de la tienda creador.

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

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

Actualizar el producto de la tienda de creadores
Beta

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

Actualizar un producto de la tienda de creadores.

Ámbitos
creator-store-product:write
SolicitudParámetros de ruta
creator_store_product_idstring
Obligatorio

El ID del producto de la tienda creador.

Parámetros de consulta
updateMaskstring

La lista de campos para actualizar. Esta cadena está formateada como Timestamp.

allowMissingboolean

Si se establece en verdadero y el producto de la tienda del creador no se encuentra, se crea un producto de la tienda del creador. En esta situación, update_mask se ignora.

Solicitar cuerpoCreatorStoreProduct
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
}'
Respuesta

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