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óły dotyczące podatków i zgodności z przepisami. Dotyczy tylko produktów subskrypcyjnych.
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 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,
  "regionalProductAgeRatingInfos": [
    {
      object (RegionalProductAgeRatingInfo)
    }
  ],
  "productTaxCategoryCode": string
}
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

Informacja, czy ten produkt w aplikacji został zadeklarowany jako produkt reprezentujący tokenizowany zasób cyfrowy.
regionalProductAgeRatingInfos[]

object (RegionalProductAgeRatingInfo)

Informacje o kategoriach wiekowych w poszczególnych regionach. Obecnie to pole jest obsługiwane tylko w przypadku kodu regionu US.
productTaxCategoryCode

string

Kod kategorii podatkowej produktu do przypisania do produktu w aplikacji. Kategoria podatkowa produktu określa stawki podatku od transakcji stosowane w przypadku produktu. Więcej informacji znajdziesz w tym artykule w Centrum pomocy.

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 Opis Rozdzielczość
400 invalidValue W żądaniu podano nieprawidłową wartość. Często jest zwracany w przypadku nieprawidłowego lub nieprawidłowo sformatowanego tokena zakupu. Popraw nieprawidłową wartość pola w treści żądania lub parametrach na podstawie dokumentacji API.
400 required W żądaniu brakuje wymaganego pola lub parametru. Zapoznaj się z dokumentacją interfejsu API, aby upewnić się, że uwzględniono wszystkie obowiązkowe pola i parametry.
403 userInsufficientPermission Użytkownik nie ma wystarczających uprawnień do wykonania żądanej operacji. Sprawdź, czy uwierzytelniony użytkownik ma niezbędne uprawnienia w Konsoli Google Play. Więcej informacji znajdziesz w artykule Korzystanie z konta usługi.
404 notFound Nie znaleziono żądanego zasobu. Sprawdź, czy identyfikatory (np. token zakupu, nazwa pakietu, identyfikator produktu, identyfikator subskrypcji) są prawidłowe.
409 concurrentUpdate Podjęto próbę zaktualizowania obiektu, który jest aktualizowany równolegle. Ponów próbę wysłania żądania ze wzrastającym czasem do ponowienia. Unikaj jednoczesnego modyfikowania tego samego zasobu.
5xx Generic error 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.