*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

CreatorStoreProduct

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.

Atributos

pathstring

O caminho de recursos do produto da loja do criador.

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

basePriceobject

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.

purchasePriceobject

O preço de compra efetivo para o usuário, após deduzir considerações específicas do local.

publishedboolean

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.

restrictionsarray<enum>
Apenas saída

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:

purchasableboolean
Apenas saída

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.

Um dos seguintes para seller:

userSellerstring
Apenas saída

O usuário do Roblox vendendo o produto.

groupSellerstring
Apenas saída

O grupo Roblox que vende o produto.

Um dos seguintes para productType:

modelAssetIdstring
Imutável

O produto da Loja do Criador é um modelo com esse ID de recurso.

pluginAssetIdstring
Imutável

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.

audioAssetIdstring
Imutável

O produto da Loja do Criador é um arquivo de áudio com esse ID de recurso.

decalAssetIdstring
Imutável

O produto da Loja do Criador é um adesivo com esse ID de recurso.

meshPartAssetIdstring
Imutável

O produto da Loja do Criador é uma peça de malha com esse ID de recurso.

videoAssetIdstring
Imutável

O produto da Loja do Criador é um vídeo com esse ID de recurso.

fontFamilyAssetIdstring
Imutável

O produto da Loja do Criador é uma família de fontes com esse ID de recurso.

URL base

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

Criar Produto da Loja de Criadores
Beta

POST /cloud/v2/creator-store-products

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.

Escopos
creator-store-product:write
SolicitaçãoRequisitar corpoCreatorStoreProduct
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
}'
Resposta

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

Obtenha o Produto da Loja de Criadores
Beta

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

Obtenha um produto da Loja de Criadores.

Escopos
creator-store-product:read
SolicitaçãoParâmetros de endereço
creator_store_product_idstring
Obrigatório

O ID do produto da loja de criadores.

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

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

Atualizar Produto da Loja de Criadores
Beta

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

Atualize um produto da Loja de Criadores.

Escopos
creator-store-product:write
SolicitaçãoParâmetros de endereço
creator_store_product_idstring
Obrigatório

O ID do produto da loja de criadores.

Parâmetros da consulta
updateMaskstring

A lista de campos para atualizar. Esta cadeia de caracteres está formatada como um FieldMask.

allowMissingboolean

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.

Requisitar corpoCreatorStoreProduct
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
}'
Resposta

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