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

Jednostka magazynowa (SKU) produktu, która jest unikalna w obrębie aplikacji.

status

enum (Status)

Stan produktu, np. czy jest aktywny.

purchaseType

enum (PurchaseType)

Typ produktu, na przykład subskrypcja cykliczna.

defaultPrice

object (Price)

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

prices

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

Ceny według regionu kupującego. Żadna z tych wartości nie może wynosić 0, ponieważ produkty w aplikacji nigdy nie są bezpłatne. Klucz mapy to kod regionu zgodny z normą 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 danymi dotyczącymi zlokalizowanego tytułu i opisu. Klucz mapy to język zlokalizowanych danych, zgodnie z definicją w dokumencie BCP-47, np. „en-US”.

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ą w dokumencie BCP-47, np. „en-US”.

subscriptionPeriod

string

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

trialPeriod

string

Okres próbny podany w formacie ISO 8601. Akceptowane wartości to wszystkie wartości od P7D (siedem dni) do P999D (999 dni).

gracePeriod

string

Okres prolongaty subskrypcji, określony w formacie ISO 8601. Umożliwia deweloperom zapewnienie subskrybentom okresu prolongaty, gdy płatność za nowy okres powtarzania zostanie odrzucona. Akceptowane wartości to: P0D (0 dni), P3D (trzy 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)

Szczegółowe informacje o podatkach i zgodności z przepisami. Dotyczy tylko produktów objętych subskrypcją.

managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

Szczegółowe 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 Nieokreślony stan.
active Produkt został opublikowany i jest aktywny w sklepie.
inactive Produkt nie został opublikowany, więc 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 cyklicznym okresem.

InAppProductListing

Informacje o pojedynczym produkcie w aplikacji.

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

string

Tytuł informacji o aplikacji.

description

string

Opis na stronie aplikacji.

benefits[]

string

Zlokalizowane korzyści związane z subskrypcją.

ManagedProductTaxAndComplianceSettings

Szczegółowe informacje o podatkach i zgodności z przepisami prawa 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 dotyczących produktów rozpowszechnianych wśród użytkowników z Europejskiego Obszaru Gospodarczego (EOG). Od tej klasyfikacji zależy prawo konsumenta do odstąpienia od umowy w Europejskim Obszarze Gospodarczym. Więcej informacji znajdziesz w tym artykule w Centrum pomocy.

taxRateInfoByRegionCode

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

Mapowanie z kodu regionu na szczegóły stawki podatku. Klucze to kody regionów zdefiniowane w zestawie „CLDR” 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

Odczytywanie wielu produktów w aplikacji, takich jak produkty zarządzane lub subskrypcje.

batchUpdate

aktualizuje lub wstawia 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 wszystkie produkty w aplikacji (zarówno produkty zarządzane, jak i subskrypcje).

patch

Stosuje poprawki do produktu w aplikacji (produktu zarządzanego lub subskrypcji).

update

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