*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

CreatorStoreProduct

Yaratıcı Mağazada bir ürünü temsil eder. Bu kaynak, Yaratıcı Mağazasındaki varlıkların dağıtımını ve fiyatlandırılmasını yönetmek için kullanılır.

Nitelikler

pathstring

Yaratıcı mağaza ürününün kaynak yolu.

Biçim: creator-store-products/{creator_store_product_id}.

basePriceobject

Ürünün temel fiyatı.Daha fazla bilgi için, Para bakın.Her ürün türü (örneğin pluginAssetId ) belirli bir fiyat setini destekler.Şu anda, yalnızca USD'de bir temel fiyat belirlemek destekleniyor.

Türüne bağlı olarak, her Yaratıcı Dükkan ürününün sabit bir fiyat seti vardır; tam liste için productType özniteliğine bakın.Örneğin, bir eklentinin fiyatını 4,99 dolara ayarlamak için aşağıdaki temel fiyatı kullanın:


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

Not: Üs olmalıdır -9 ve önemli sayı bu biçimde olmalıdır. Eşdeğer Ondalık formatı şudur: significand * 10^exponent .

Bir eklentinin fiyatını $0'a (yani ücretsiz) ayarlamak istiyorsanız, aşağıdaki base_price kullanın


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

Not: Hala ücretsiz ürünler için bile currencyCode 'yi USD'ye ayarlamalısınız.

Gerçek satın alma fiyatı bu temel fiyata dayanmaktadır, ancak genellikle yerel düşünceler nedeniyle biraz farklılık gösterir.

Ürünü ücretsiz yapmak için bunu sıfıra ayarlayın.

purchasePriceobject

Kullanıcı için etkili satın alma fiyatı, yerel özel düşünceler dikkate alındıktan sonra.

publishedboolean

Satıcının Yaratıcı Dükkan ürününü Yaratıcı Dükkan'da dağıtmayı planladığı.Bir satıcı bir ürün dağıtmayı planlayabilir, ancak satıcıya veya temel Yaratıcı Dükkan ürününe bazı kısıtlamalar getirildiğinden, ürün satın alınamayabilir.Daha fazla ayrıntı için restrictions ve purchasable bakın.

restrictionsarray<enum>

Yalnızca Çıkış

Ürüne uygulanan kısıtlamalar. Bir ürün aynı anda birden fazla kısıtlamaya sahip olabilir.

Olası değerler:

| Değer | Açıklama | | --- | --- | | RESTRICTION_UNSPECIFIED | Belirlenmemiş sınır.| | SOLD_ITEM_RESTRICTED | Satılan eşya Roblox tarafından sınırlandırıldı Ayrıntılar doğrudan bu eşyayı arayarak elde edilebilir.| | SELLER_TEMPORARILY_RESTRICTED | Ürün, satıcının hesabının Roblox tarafından geçici olarak kısıtlanması nedeniyle kısıtlanmıştır.| | SELLER_PERMANENTLY_RESTRICTED | Ürün, satıcının hesabının Roblox tarafından kalıcı olarak kısıtlanması nedeniyle kısıtlanmıştır.| | SELLER_NO_LONGER_ACTIVE | Ürün sınırlandırıldı çünkü satıcının hesabı silindi veya başka bir şekilde artık aktif değil. |. Olası değerler:

purchasableboolean

Yalnızca Çıkış

Ürün satın alınabilir.

Bu değerin doğru olması için, published doğru olmalı ve restrictions boş olmalıdır.Bu değer yanlışsa, ürün herhangi bir kullanıcı tarafından elde edilemeyebilir.

seller için şunlardan biri:

userSellerstring

Yalnızca Çıkış

Ürünü satan Roblox kullanıcısı.

groupSellerstring

Yalnızca Çıkış

Ürünü satan Roblox grubu.

productType için şunlardan biri:

modelAssetIdstring

Sabit

Yaratıcı Dükkan ürünü bu varlık kimliğine sahip bir modeldir.

pluginAssetIdstring

Sabit

Yaratıcı Dükkan ürünü bu varlık kimliğine sahip bir eklentidir.

Desteklenen temel fiyatları 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

Sabit

Yaratıcı Dükkan ürünü, bu varlık kimliğine sahip bir ses dosyasıdır.

decalAssetIdstring

Sabit

Yaratıcı Dükkan ürünü bu varlık kimliğine sahip bir rozettir.

meshPartAssetIdstring

Sabit

Yaratıcı Dükkan ürünü, bu varlık kimliğine sahip bir mesh parçasıdır.

videoAssetIdstring

Sabit

Yaratıcı Dükkan ürünü, bu varlık kimliğine sahip bir video.

fontFamilyAssetIdstring

Sabit

Yaratıcı Dükkan ürünü, bu varlık kimliğine sahip bir font ailesidir.

Taban URL

https://apis.roblox.com

CreatorStoreProduct Kaynağı

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

Yaratıcı Dükkan Ürünü Oluştur
Beta

POST /cloud/v2/creator-store-products

Bir Yaratıcı Dükkan ürünü ekleyin.Sadece ürününüzün Yaratıcı Mağazada hiç dağıtılmamış olması durumunda bu yöntemi kullanın; aksi takdirde, ürünü güncelletmek için PATCH yöntemini kullanın.

Kapsamlar

creator-store-product:write

TalepTalep GövdesiCreatorStoreProduct

YanıtCreatorStoreProduct

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

Yanıt

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

Yaratıcı Dükkan Ürünü Alın
Beta

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

Bir Yaratıcı Dükkan ürünü alın.

Kapsamlar

creator-store-product:read

TalepYol Parametreleri

creator_store_product_idstring

Gerekli

Yaratıcı-mağaza-ürün ID'si.

YanıtCreatorStoreProduct

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

Yanıt

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

Yaratıcı Dükkan Ürününü Güncelle
Beta

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

Bir Yaratıcı Dükkan ürününü güncelle.

Kapsamlar

creator-store-product:write

TalepYol Parametreleri

creator_store_product_idstring

Gerekli

Yaratıcı-mağaza-ürün ID'si.

Sorgu Parametreleri

updateMaskstring

Güncellenmesi gereken alanların listesi. Bu dizi FieldMask olarak biçimlendirilmiş.

allowMissingboolean

Doğru ayarlanırsa ve yaratıcı mağazası ürünü bulunmazsa, bir yaratıcı mağazası ürünü oluşturulur. Bu durumda, update_mask ihmal edilir.

Talep GövdesiCreatorStoreProduct

YanıtCreatorStoreProduct

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

Yanıt

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

Nitelikler

CreatorStoreProduct

Yaratıcı Dükkan Ürünü OluşturBeta

CreatorStoreProduct

Yaratıcı Dükkan Ürünü AlınBeta

CreatorStoreProduct

Yaratıcı Dükkan Ürününü GüncelleBeta

Yaratıcı Dükkan Ürünü Oluştur
Beta

Yaratıcı Dükkan Ürünü Alın
Beta

Yaratıcı Dükkan Ürününü Güncelle
Beta