REST Resource: inappproducts

Zasób: InAppProduct

Produkt w aplikacji. Zasób InappproductsService.

Zapis JSON
{
  "packageName": string,
  "sku": string,
  "status": enum (Status),
  "purchaseType": enum (PurchaseType),
  "defaultPrice": {
    object (Price)
  },
  "prices": {
    string: {
      object (Price)
    },
    ...
  },
  "listings": {
    string: {
      object (InAppProductListing)
    },
    ...
  },
  "defaultLanguage": string,
  "subscriptionPeriod": string,
  "trialPeriod": string,
  "gracePeriod": string,

  // Union field TaxAndComplianceType can be only one of the following:
  "subscriptionTaxesAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  },
  "managedProductTaxesAndComplianceSettings": {
    object (ManagedProductTaxAndComplianceSettings)
  }
  // End of list of possible types for union field TaxAndComplianceType.
}
Pola
packageName

string

Nazwa pakietu aplikacji nadrzędnej.

sku

string

Unikalny w aplikacji kod SKU produktu.

status

enum (Status)

Stan produktu, np. czy jest aktywny.

purchaseType

enum (PurchaseType)

Typ produktu, np. cykliczna subskrypcja.

defaultPrice

object (Price)

Cena domyślna. Nie może wynosić 0, ponieważ produkty w aplikacji nigdy nie są bezpłatne. Zawsze w walucie sprzedawcy w Checkout.

prices

map (key: string, value: object (Price))

Ceny według regionu kupującego. Żaden z tych parametrów nie może wynosić 0, ponieważ produkty w aplikacji nigdy nie są bezpłatne. Klucz mapy to kod regionu zdefiniowany w standardzie ISO 3166-2.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

listings

map (key: string, value: object (InAppProductListing))

inappproducts.list z tytułem i opisem w wielu językach. Klucz mapy to język zlokalizowanych danych zdefiniowany w standardzie BCP-47, np. „pl-PL”.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

defaultLanguage

string

Domyślny język zlokalizowanych danych określony w formacie BCP-47, np. „pl-PL”.

subscriptionPeriod

string

Okres subskrypcji określony w formacie ISO 8601. Akceptowane wartości to P1W (1 tydzień), P1M (1 miesiąc), P3M (3 miesiące), P6M (6 miesięcy) i P1Y (1 rok).

trialPeriod

string

Okres próbny określony w formacie ISO 8601. Akceptowane wartości mieszczą się w zakresie od P7D (7 dni) do P999D (999 dni).

gracePeriod

string

Okres próbny subskrypcji podany w formacie ISO 8601. Umożliwia deweloperom przyznanie subskrybentom okresu prolongaty w przypadku odrzucenia płatności za nowy okres cykliczny. Akceptowane wartości to P0D (0 dni), P3D (3 dni), P7D (7 dni), P14D (14 dni) i P30D (30 dni).

Pole unii TaxAndComplianceType.

TaxAndComplianceType może być tylko jednym z tych elementów:

subscriptionTaxesAndComplianceSettings

object (SubscriptionTaxAndComplianceSettings)

Szczegóły dotyczące podatków i zgodności z przepisami. Dotyczy tylko usług subskrypcji.

managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

Szczegóły dotyczące podatków i zgodności z przepisami. Dotyczy tylko produktów zarządzanych.

Stan

Stan produktu w aplikacji.

Wartości w polu enum
statusUnspecified Stan nieokreślony.
active Produkt jest opublikowany i aktywny w sklepie.
inactive Produkt nie został opublikowany, dlatego jest nieaktywny w sklepie.

PurchaseType

Typ produktu.

Wartości w polu enum
purchaseTypeUnspecified Nieokreślony typ zakupu.
managedUser Domyślny typ produktu – zakup jednorazowy.
subscription Produkt w aplikacji z okresem odnawiania.

InAppProductListing

Informacje o pojedynczym produkcie w aplikacji.

Zapis JSON
{
  "title": string,
  "description": string,
  "benefits": [
    string
  ]
}
Pola
title

string

Tytuł strony aplikacji.

description

string

Opis informacji o aplikacji.

benefits[]

string

Zlokalizowane korzyści wynikające z subskrypcji.

ManagedProductTaxAndComplianceSettings

Szczegóły dotyczące opodatkowania i zgodności z przepisami w przypadku produktów zarządzanych.

Zapis JSON
{
  "eeaWithdrawalRightType": enum (WithdrawalRightType),
  "taxRateInfoByRegionCode": {
    string: {
      object (RegionalTaxRateInfo)
    },
    ...
  },
  "isTokenizedDigitalAsset": boolean
}
Pola
eeaWithdrawalRightType

enum (WithdrawalRightType)

Klasyfikacja jako treści cyfrowe lub usługa w przypadku produktów rozpowszechnianych wśród użytkowników z Europejskiego Obszaru Gospodarczego. Od tej klasyfikacji zależy prawo konsumenta do odstąpienia od umowy w tym regionie. Więcej informacji znajdziesz w tym artykule w Centrum pomocy.

taxRateInfoByRegionCode

map (key: string, value: object (RegionalTaxRateInfo))

Mapowanie kodu regionu na szczegóły stawki podatku. Klucze to kody regionów zdefiniowane w standardzie CLDR.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

isTokenizedDigitalAsset

boolean

Określ, czy ten produkt w aplikacji jest zadeklarowany jako produkt reprezentujący tokenizowany zasób cyfrowy.

Metody

batchDelete

usuwa produkty w aplikacji (produkty zarządzane lub subskrypcje);

batchGet

Czyta wiele produktów w aplikacji, które mogą być produktami zarządzanymi lub subskrypcjami.

batchUpdate

aktualizujesz lub wstawiasz co najmniej 1 produkt w aplikacji (produkty zarządzane lub subskrypcje).

delete

Usuwa produkt w aplikacji (produkt zarządzany lub subskrypcję).

get

Pobiera produkt w aplikacji, który może być produktem zarządzanym lub subskrypcją.

insert

Tworzy produkt w aplikacji (produkt zarządzany lub subskrypcję).

list

Wyświetla listę wszystkich produktów w aplikacji, zarówno zarządzanych, jak i subskrypcji.

patch

Aktualizuje produkt w aplikacji (produkt zarządzany lub subskrypcję).

update

Aktualizuje produkt w aplikacji (produkt zarządzany lub subskrypcję).