*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

CreatorStoreProduct

Mewakili produk di Toko Pencipta. Sumber daya ini digunakan untuk mengelola distribusi dan harga aset di Toko Pencipta.

Atribut

pathstring

Jalur sumber daya produk toko pencipta.

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

basePriceobject

Harga dasar produk.Untuk informasi lebih lanjut, lihat Uang.Setiap jenis produk (seperti pluginAssetId ) mendukung serangkaian harga spesifik.Saat ini, hanya menetapkan harga dasar dalam USD yang didukung.

Tergantung pada jenis, setiap produk Toko Pencipta memiliki set harga yang ditetapkan; lihat atribut productType untuk daftar lengkap.Sebagai contoh, untuk menetapkan harga plugin menjadi $4,99, gunakan harga dasar berikut:


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

Catatan: Eksponen harus menjadi -9, dan signifikansi harus dalam format ini. Format Desimal yang sesuai adalah significand * 10^exponent.

Jika Anda ingin menetapkan harga plugin menjadi $0 (yaitu gratis), gunakan berikut base_price


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

Catatan: Anda masih harus mengatur currencyCode ke USD, bahkan untuk produk gratis.

Harga pembelian yang sebenarnya didasarkan pada harga dasar ini, tetapi sering berbeda sedikit karena pertimbangan lokal.

Atur ini menjadi nol untuk membuat produk gratis.

purchasePriceobject

Harga pembelian yang efektif untuk pengguna, setelah mempertimbangkan pertimbangan lokal.

publishedboolean

Apakah penjual berniat untuk mendistribusikan produk Toko Pencipta di Toko Pencipta.Seorang penjual mungkin berniat untuk mendistribusikan produk, tetapi karena beberapa batasan pada penjual atau produk Toko Pencipta dasar, produk mungkin tidak tersedia untuk dibeli.Lihat restrictions dan purchasable untuk lebih banyak rincian.

restrictionsarray<enum>

Hanya Output

Keterbatasan yang diterapkan pada produk. Sebuah produk dapat memiliki banyak keterbatasan aktif pada satu waktu.

Nilai yang mungkin:

| Nilai | Deskripsi | | --- | --- | | RESTRICTION_UNSPECIFIED | Batasan tidak ditentukan.| | SOLD_ITEM_RESTRICTED | Item yang dijual telah dibatasi oleh Roblox Detail mungkin tersedia dengan mencari item itu secara langsung.| | SELLER_TEMPORARILY_RESTRICTED | Produk dibatasi karena akun penjual dibatasi sementara oleh Roblox.| | SELLER_PERMANENTLY_RESTRICTED | Produk dibatasi karena akun penjual dibatasi secara permanen oleh Roblox.| | SELLER_NO_LONGER_ACTIVE | Produk dibatasi karena akun penjual dihapus atau tidak lagi aktif. |. Nilai yang mungkin:

purchasableboolean

Hanya Output

Apakah produk dapat dibeli.

Untuk nilai ini menjadi benar, published harus benar dan restrictions harus kosong.Jika nilai ini salah, produk mungkin tidak diperoleh oleh pengguna mana pun.

Salah satu dari yang berikut untuk seller:

userSellerstring

Hanya Output

Pengguna Roblox yang menjual produk.

groupSellerstring

Hanya Output

Kelompok Roblox yang menjual produk.

Salah satu dari yang berikut untuk productType:

modelAssetIdstring

Immutable

Produk Toko Pencipta adalah model dengan ID aset ini.

pluginAssetIdstring

Immutable

Produk Toko Pencipta adalah plugin dengan ID aset ini.

Dukungan harga dasar dalam 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

Immutable

Produk Toko Pencipta adalah file audio dengan ID aset ini.

decalAssetIdstring

Immutable

Produk Toko Pencipta adalah stiker dengan ID aset ini.

meshPartAssetIdstring

Immutable

Produk Toko Pencipta adalah bagian mesh dengan ID aset ini.

videoAssetIdstring

Immutable

Produk Toko Pencipta adalah video dengan ID aset ini.

fontFamilyAssetIdstring

Immutable

Produk Toko Pencipta adalah keluarga font dengan ID aset ini.

Base URL

https://apis.roblox.com

Resource 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

Buat Produk Toko Pencipta
Beta

POST /cloud/v2/creator-store-products

Tambahkan produk Toko Pencipta.Hanya gunakan metode ini jika produk Anda tidak pernah didistribusikan di Toko Pencipta; jika tidak, gunakan metode PATCH untuk memperbarui produk.

Cakupan

creator-store-product:write

PermintaanRequest BodyCreatorStoreProduct

ResponsCreatorStoreProduct

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

Respons

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

Dapatkan Produk Toko Pencipta
Beta

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

Dapatkan produk Toko Pencipta.

Cakupan

creator-store-product:read

PermintaanParameter Jalur

creator_store_product_idstring

Diperlukan

ID produk toko pencipta.

ResponsCreatorStoreProduct

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

Respons

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

Perbarui Produk Toko Pencipta
Beta

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

Perbarui produk Toko Pencipta.

Cakupan

creator-store-product:write

PermintaanParameter Jalur

creator_store_product_idstring

Diperlukan

ID produk toko pencipta.

Parameter Kueri

updateMaskstring

Daftar bidang untuk diperbarui. String ini diformat sebagai FieldMask.

allowMissingboolean

Jika diatur ke benar, dan produk toko pencipta tidak ditemukan, produk toko pencipta dibuat. Dalam situasi ini, update_mask diabaikan.

Request BodyCreatorStoreProduct

ResponsCreatorStoreProduct

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

Respons

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

Atribut

CreatorStoreProduct

Buat Produk Toko PenciptaBeta

CreatorStoreProduct

Dapatkan Produk Toko PenciptaBeta

CreatorStoreProduct

Perbarui Produk Toko PenciptaBeta

Buat Produk Toko Pencipta
Beta

Dapatkan Produk Toko Pencipta
Beta

Perbarui Produk Toko Pencipta
Beta