REST Resource: inappproducts

Zasób: InAppProduct

Produkt w aplikacji. Zasób dla 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, unikalna w aplikacji.
status

enum (Status)

Stan produktu, np. czy jest aktywny.
purchaseType

enum (PurchaseType)

Typ produktu, np. subskrypcja cykliczna.
defaultPrice

object (Price)

Cena domyślna. Nie może wynosić zera, ponieważ produkty w aplikacji nigdy nie są bezpłatne. Zawsze w walucie sprzedawcy w płatnościach dewelopera.
prices

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

Ceny według regionu kupującego. Żadna z tych wartości nie może wynosić zera, 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 danymi o zlokalizowanych tytułach i opisach. Klucz mapy to język zlokalizowanych danych zdefiniowany zgodnie ze standardem 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 określony zgodnie z BCP-47, np. „en-US”.
subscriptionPeriod

string

Okres subskrypcji podany 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 podany w formacie ISO 8601. Akceptowane wartości to P7D (7 dni) i P999D (999 dni).
gracePeriod

string

Okres prolongaty subskrypcji podany w formacie ISO 8601. Umożliwia deweloperom przyznanie subskrybentom okresu 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 zbiorcze TaxAndComplianceType.

Pole 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 subskrypcyjnych.
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 Stan nieokreślony.
active Produkt jest opublikowany i aktywny w sklepie.
inactive Produkt nie jest 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 – zakup jednorazowy.
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ł informacji o 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 zarządzanych produktów.

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 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 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” Unicode.

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

boolean

Czy ten produkt w aplikacji został 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óre mogą być produktami zarządzanymi lub subskrypcjami.

batchUpdate

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

delete

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

get

 uzyskuje 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

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

update

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

Kody błędów

Operacje na tym zasobie zwracają te kody błędów HTTP:

Kod błędu Przyczyna Rozdzielczość
5xx Ogólny błąd serwera Google Play. Ponów żądanie.

Jeśli problem nie ustąpi, skontaktuj się z menedżerem konta Google Play lub prześlij prośbę o pomoc. Sprawdź panel stanu Google Play, aby dowiedzieć się, czy występują znane awarie.
409 Błąd aktualizacji współbieżnej.

Podjęto próbę zaktualizowania obiektu, który jest aktualizowany. Na przykład zakup jest potwierdzany przez jednoczesne wywołanie metody acknowledgePurchase() Biblioteki płatności w Play i metody purchases.products.acknowledge interfejsu Play Developer API.

 Ponów żądanie.