O caminho de recursos do produto da loja do criador.
Formato: creator-store-products/{creator_store_product_id}.
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
Representa um produto na Loja do Criador. Este recurso é usado para gerenciar a distribuição e o preço de recursos na Loja do Criador.
O caminho de recursos do produto da loja do criador.
Formato: creator-store-products/{creator_store_product_id}.
O preço base do produto.Para mais informações, veja Dinheiro.Cada tipo de produto (como pluginAssetId ) suporta um conjunto de preços específicos.Atualmente, apenas definir um preço de base em USD é suportado.
Dependendo do tipo, cada produto da Loja de Criadores tem um conjunto fixo de preços suportados; veja o atributo para a lista completa.Por exemplo, para definir o preço de um plugin para $4.99, use o seguinte preço base:
"basePrice": {"currencyCode": "USD","quantity": {"significand": 4990000000,"exponent": -9}}
Nota: O exponente deve ser -9, e o significante deve estar neste formato. O formato correspondente Decimal é significand * 10^exponent .
Se você quiser definir o preço de um plugin para $0 (ou seja, gratuito), use o seguinte base_price
"basePrice": {"currencyCode": "USD","quantity": {"significand": 0,"exponent": 0}}
Nota: Você ainda deve definir o currencyCode para USD, mesmo para produtos gratuitos.
O preço de compra real é baseado neste preço de base, mas muitas vezes difere ligeiramente devido a considerações locais específicas.
Defina isso para zero para tornar o produto gratuito.
O preço de compra efetivo para o usuário, após deduzir considerações específicas do local.
Se o vendedor pretende distribuir o produto da Loja do Criador na Loja do Criador.Um vendedor pode ter a intenção de distribuir um produto, mas, devido a algumas restrições ao vendedor ou ao produto da Loja de Criadores subjacente, o produto pode não estar disponível para compra.Veja restrictions e purchasable para mais detalhes.
Restrições aplicadas ao produto. Um produto pode ter várias restrições ativas ao mesmo tempo.
Valores possíveis:
| Valor | Descrição | | --- | --- | | RESTRIÇÃO_NÃO_ESPECIFICADA | Restrição não especificada.| | SOLD_ITEM_RESTRICTED | O item que está sendo vendido foi restrito por Roblox Detalhes podem estar disponíveis ao procurar diretamente esse item.| | SELLER_TEMPORARILY_RESTRICTED | O produto é restrito porque a conta do vendedor é restrita temporariamente pelo Roblox.| | SELLER_PERMANENTLY_RESTRICTED | O produto é restrito porque a conta do vendedor é permanentemente restrita por Roblox.| | SELLER_NO_LONGER_ACTIVE | O produto está restrito porque a conta do vendedor foi excluída ou de outra forma não está mais ativa. |. Valores possíveis:
Se o produto é adquirível.
Para que esse valor seja verdadeiro, published deve ser verdadeiro e restrictions deve ser vazio.Se esse valor for falso, o produto pode não ser adquirido por nenhum usuário.
O usuário do Roblox vendendo o produto.
O grupo Roblox que vende o produto.
O produto da Loja do Criador é um modelo com esse ID de recurso.
O produto da Loja do Criador é um plugin com esse ID de recurso.
Preços base suportados em 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.
O produto da Loja do Criador é um arquivo de áudio com esse ID de recurso.
O produto da Loja do Criador é um adesivo com esse ID de recurso.
O produto da Loja do Criador é uma peça de malha com esse ID de recurso.
O produto da Loja do Criador é um vídeo com esse ID de recurso.
O produto da Loja do Criador é uma família de fontes com esse ID de recurso.
https://apis.roblox.com
{
"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"
}
Adicione um produto da Loja do Criador.Use apenas este método se o seu produto nunca foi distribuído na Loja do Criador; caso contrário, use o método PATCH para atualizar o produto.
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"
}
Obtenha um produto da Loja de Criadores.
O ID do produto da loja de criadores.
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"
}
Atualize um produto da Loja de Criadores.
O ID do produto da loja de criadores.
A lista de campos para atualizar. Esta cadeia de caracteres está formatada como um FieldMask.
Se definido como verdadeiro e o produto da loja do criador não for encontrado, um produto da loja do criador é criado. Nesta situação, update_mask é ignorado.
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"
}