*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.

CreatorStoreProduct

Reprezentuje produkt w sklepie dla twórców. Zasób ten jest używany do zarządzania dystrybucją i cenami zasobów w sklepie dla twórców.

Atrybuty

pathstring

Ścieżka zasobów produktu sklepu twórcy.

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

basePriceobject

Podstawowa cena produktu.Aby uzyskać więcej informacji, zobacz Pieniądze.Każdy typ produktu (taki jak pluginAssetId ) wspiera zestaw określonych cen.Obecnie wspierane jest tylko ustawienie ceny bazowej w USD.

W zależności od typu każdy produkt sklepu dla twórców ma stały zestaw wspieranych cen; zobacz atrybut productType dla pełnej listy.Na przykład, aby ustawić cenę pluginu do 4,99 USD, użyj następującej ceny bazowej:


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

Uwaga: wykładnik musi być -9, a znacząca musi być w tym formacie. Odpowiadający format dziesiętny jest significand * 10^exponent .

Jeśli chcesz ustawić cenę pluginu na 0 USD (tj. bezpłatnie), użyj następującego base_price


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

Uwaga: Musisz nadal ustawić currencyCode na USD, nawet dla bezpłatnych produktów.

Rzeczywista cena zakupu opiera się na tej podstawowej cenie, ale często różni się nieznacznie ze względu na kwestie lokalne.

Ustaw to na zero, aby produkt był bezpłatny.

purchasePriceobject

Skuteczna cena zakupu dla użytkownika po uwzględnieniu uwzględnienia kwestii lokalnych.

publishedboolean

Czy sprzedawca zamierza rozprowadzać produkt Sklepu Twórców na Sklepie Twórców.Sprzedawca może zamierzać rozprowadzić produkt, ale ze względu na pewne ograniczenia dla sprzedawcy lub produktu sklepu podstawowego, produkt może nie być dostępny do zakupu.Zobacz restrictions i purchasable dla więcej szczegółów.

restrictionsarray<enum>

Tylko dane wyjściowe

Ograniczenia związane z produktem. Produkt może mieć wiele ograniczeń aktywnych jednocześnie.

Możliwe wartości:

| Wartość | Opis | | --- | --- | | RESTRICTION_UNSPECIFIED | Nieokreślona ograniczenie.| | SOLD_ITEM_RESTRICTED | Przedmiot sprzedawany został ograniczony przez Roblox Szczegóły mogą być dostępne, wyszukując ten przedmiot bezpośrednio.| | SELLER_TEMPORARILY_RESTRICTED | Produkt jest ograniczony, ponieważ konto sprzedawcy jest tymczasowo ograniczone przez Roblox.| | SELLER_PERMANENTLY_RESTRICTED | Produkt jest ograniczony, ponieważ konto sprzedawcy jest permanentnie ograniczone przez Roblox.| | SELLER_NO_LONGER_ACTIVE | Produkt jest ograniczony, ponieważ konto sprzedawcy zostało usunięte lub inaczej nie jest już aktywne. |. Możliwe wartości:

purchasableboolean

Tylko dane wyjściowe

Czy produkt jest dostępny do zakupu.

Aby ta wartość była prawdą, published musi być prawdą, a restrictions musi być puste.Jeśli ta wartość jest fałszywa, produkt może nie zostać zdobyty przez żadnego użytkownika.

Jedna z następujących dla seller:

userSellerstring

Tylko dane wyjściowe

Użytkownik Roblox sprzedający produkt.

groupSellerstring

Tylko dane wyjściowe

Grupa Roblox sprzedająca produkt.

Jedna z następujących dla productType:

modelAssetIdstring

Nieodwołalny

Produkt Sklepu twórców jest modelem z tym ID zasobu.

pluginAssetIdstring

Nieodwołalny

Produkt Sklepu twórców jest pluginem z tym ID zasobu.

Wspierane ceny bazowe w 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

Nieodwołalny

Produkt Sklepu twórców jest plikiem audio z tym ID zasobu.

decalAssetIdstring

Nieodwołalny

Produkt Sklepu twórców jest naklejką z tym ID zasobu.

meshPartAssetIdstring

Nieodwołalny

Produkt Sklepu twórców jest częścią siatki z tym ID zasobu.

videoAssetIdstring

Nieodwołalny

Produkt Sklepu twórców to wideo z tym ID zasobu.

fontFamilyAssetIdstring

Nieodwołalny

Produkt Sklepu twórców jest rodziną czcionek z tym ID zasobu.

Podstawowy adres URL

https://apis.roblox.com

Zasób 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

Stwórz produkt sklepu twórców
Beta

POST /cloud/v2/creator-store-products

Dodaj produkt sklepu twórców.Użyj tylko tej metody, jeśli twój produkt nigdy nie został rozprowadzony w sklepie dla twórców; w przeciwnym razie użyj metody PATCH, aby zaktualizować produkt.

Zakresy

creator-store-product:write

ŻądanieTreść żądaniaCreatorStoreProduct

Odpowiedź:CreatorStoreProduct

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

Odpowiedź:

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

Zdobądź produkt sklepu twórców
Beta

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

Zdobądź produkt sklepu Creator.

Zakresy

creator-store-product:read

ŻądanieParametry ścieżki

creator_store_product_idstring

Wymagane

ID produktu sklepu twórców.

Odpowiedź:CreatorStoreProduct

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

Odpowiedź:

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

Aktualizacja produktu sklepu twórców
Beta

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

Aktualizacja produktu sklepu twórców.

Zakresy

creator-store-product:write

ŻądanieParametry ścieżki

creator_store_product_idstring

Wymagane

ID produktu sklepu twórców.

Parametry zapytania

updateMaskstring

Lista pól do aktualizacji. Ten ciąg jest sformatowany jako FieldMask.

allowMissingboolean

Jeśli ustawiono prawdę, a produkt sklepu twórców nie został znaleziony, twórczy sklep produkt powstaje. W tej sytuacji ignorowany jest update_mask.

Treść żądaniaCreatorStoreProduct

Odpowiedź:CreatorStoreProduct

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

Odpowiedź:

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

Atrybuty

CreatorStoreProduct

Stwórz produkt sklepu twórcówBeta

CreatorStoreProduct

Zdobądź produkt sklepu twórcówBeta

CreatorStoreProduct

Aktualizacja produktu sklepu twórcówBeta

Stwórz produkt sklepu twórców
Beta

Zdobądź produkt sklepu twórców
Beta

Aktualizacja produktu sklepu twórców
Beta