REST Resource: inappproducts

Zasób: InAppProduct

Produkt w aplikacji. Zasób usługi 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

unikalna jednostka magazynowa (SKU) produktu w obrębie aplikacji.

status

enum (Status)

Stan produktu, np. aktywne.

purchaseType

enum (PurchaseType)

Typ produktu, np. cykliczną subskrypcją.

defaultPrice

object (Price)

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

prices

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

Ceny według regionu kupującego. Produkty w aplikacji nigdy nie są bezpłatne. Klucz mapy to kod regionu określony 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 ze zlokalizowanymi danymi o tytule i opisie. Klucz mapy to język zlokalizowanych danych, zgodnie z definicją w 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, zgodnie z definicją podaną w dokumencie BCP-47. np. „pl-PL”.

subscriptionPeriod

string

Okres subskrypcji określony w formacie ISO 8601. Akceptowane wartości to P1W (jeden 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 to wartości z zakresu od P7D (7 dni) do P999 D (999 dni).

gracePeriod

string

Okres prolongaty subskrypcji określony w formacie ISO 8601. Deweloperzy mogą przyznać subskrybentom okres prolongaty, gdy płatność za nowy okres cykliczny zostanie odrzucona. Akceptowane wartości to P0D (0 dni), P3D (3 dni), P7D (7 dni), P14D (14 dni) i P30D (30 dni).

Pole sumy TaxAndComplianceType.

TaxAndComplianceType może mieć tylko jedną z tych wartości:

subscriptionTaxesAndComplianceSettings

object (SubscriptionTaxAndComplianceSettings)

Informacje o podatkach i zgodności z przepisami. Dotyczy tylko produktów objętych subskrypcją.

managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

Informacje o podatkach 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 został opublikowany i jest aktywny w sklepie.
inactive Produkt nie został opublikowany i dlatego jest nieaktywny w sklepie.

PurchaseType

Typ produktu.

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

InAppProductListing

Informacje o pojedynczym produkcie w aplikacji.

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

string

Tytuł strony aplikacji.

description

string

Opis na stronie aplikacji.

benefits[]

string

Przetłumaczone korzyści związane z subskrypcją.

ManagedProductTaxAndComplianceSettings

Szczegółowe informacje o podatkach 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 treści lub usług cyfrowych w przypadku produktów oferowanych użytkownikom w Europejskim Obszarze Gospodarczym. Od tej klasyfikacji zależy prawo do odstąpienia od umowy wynikające z przepisów dotyczących ochrony konsumentów w EOG. Więcej informacji znajdziesz w artykule w Centrum pomocy.

taxRateInfoByRegionCode

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

Mapowanie od kodu regionu na szczegóły stawki podatku. Klucze to kody regionów zgodnie z definicją „CLDR” standardu Unicode.

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

isTokenizedDigitalAsset

boolean

Określa, 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

Odczytuje wiele produktów w aplikacji, którymi mogą być produkty zarządzane lub subskrypcje.

batchUpdate

Aktualizuje lub wstawia co najmniej 1 produkt w aplikacji (produkt zarządzanym lub subskrypcję).

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

Zawiera listę wszystkich produktów w aplikacji – zarówno produktów zarządzanych, jak i subskrypcji.

patch

Poprawianie produktu w aplikacji (produktu zarządzanego lub subskrypcji).

update

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