REST Resource: monetization.onetimeproducts

Zasób: OneTimeProduct

Pojedynczy produkt kupowany raz w aplikacji.

Zapis JSON 
{
  "packageName": string,
  "productId": string,
  "listings": [
    {
      object (OneTimeProductListing)
    }
  ],
  "taxAndComplianceSettings": {
    object (OneTimeProductTaxAndComplianceSettings)
  },
  "purchaseOptions": [
    {
      object (OneTimeProductPurchaseOption)
    }
  ],
  "restrictedPaymentCountries": {
    object (RestrictedPaymentCountries)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  }
}
Pola
packageName

string

Wymagane. Wartość niezmienna. Nazwa pakietu aplikacji nadrzędnej.
productId

string

Wymagane. Wartość niezmienna. Unikalny identyfikator produktu. Unikalny w aplikacji nadrzędnej. Identyfikatory produktów muszą zaczynać się od cyfry lub małej litery i mogą zawierać cyfry (0–9), małe litery (a–z), podkreślenia (_) i kropki (.).
listings[]

object (OneTimeProductListing)

Wymagane. Zestaw zlokalizowanych danych tytułu i opisu. Nie może zawierać zduplikowanych wpisów z tym samym kodem języka.
taxAndComplianceSettings

object (OneTimeProductTaxAndComplianceSettings)

Szczegółowe informacje o podatkach i zgodności z przepisami.
purchaseOptions[]

object (OneTimeProductPurchaseOption)

Wymagane. Zestaw opcji zakupu tego produktu kupowanego raz.
restrictedPaymentCountries

object (RestrictedPaymentCountries)

Opcjonalnie: Kraje, w których zakup tego produktu kupowanego raz jest ograniczony do form płatności zarejestrowanych w tym samym kraju. Jeśli to pole jest puste, nie są stosowane żadne ograniczenia dotyczące lokalizacji płatności.
offerTags[]

object (OfferTag)

Opcjonalnie: Lista maksymalnie 20 tagów niestandardowych określonych dla tego produktu kupowanego raz, które są zwracane do aplikacji za pomocą biblioteki płatności. Opcje zakupu i oferty dotyczące tego produktu również otrzymają te tagi w bibliotece płatności.
regionsVersion

object (RegionsVersion)

Tylko dane wyjściowe. Wersja konfiguracji regionów, która została użyta do wygenerowania produktu kupowanego raz.

OneTimeProductListing

Informacje o sklepie w regionie w przypadku produktu kupowanego raz.

Zapis JSON 
{
  "languageCode": string,
  "title": string,
  "description": string
}
Pola
languageCode

string

Wymagane. Język tej wizytówki określony zgodnie ze standardem BCP-47, np. „en-US”.
title

string

Wymagane. Nazwa tego produktu w języku tej informacji. Maksymalna długość to 55 znaków.
description

string

Wymagane. Opis tego produktu w języku, w którym wyświetlana jest ta informacja. Maksymalna długość to 200 znaków.

OneTimeProductTaxAndComplianceSettings

Szczegółowe informacje o opodatkowaniu, zasadach Google Play i zgodności z przepisami w przypadku produktów kupowanych raz.

Zapis JSON 
{
  "regionalTaxConfigs": [
    {
      object (RegionalTaxConfig)
    }
  ],
  "isTokenizedDigitalAsset": boolean
}
Pola
regionalTaxConfigs[]

object (RegionalTaxConfig)

Konfiguracja podatku regionalnego.
isTokenizedDigitalAsset

boolean

Czy ten produkt kupowany raz jest zadeklarowany jako produkt reprezentujący tokenizowany zasób cyfrowy.

RegionalTaxConfig

Szczegóły dotyczące opodatkowania w danym regionie geograficznym.

Zapis JSON 
{
  "regionCode": string,
  "taxTier": enum (TaxTier),
  "eligibleForStreamingServiceTaxRate": boolean,
  "streamingTaxType": enum (StreamingTaxType)
}
Pola
regionCode

string

Wymagane. Kod regionu, którego dotyczy ta konfiguracja, zgodnie z normą ISO 3166-2, np. „US”.
taxTier

enum (TaxTier)

Poziom podatku określający obniżoną stawkę podatku. Deweloperzy, którzy sprzedają wiadomości, czasopisma, gazety, książki i audiobooki w formie cyfrowej w różnych regionach, mogą kwalifikować się do skorzystania z obniżonych stawek podatku.

Więcej informacji
eligibleForStreamingServiceTaxRate

boolean

Musisz poinformować nas, jeśli Twoja aplikacja zawiera usługi strumieniowania, aby można było prawidłowo naliczać podatek stanowy i lokalny podatek od sprzedaży w Stanach Zjednoczonych. To pole jest obsługiwane tylko w Stanach Zjednoczonych.
streamingTaxType

enum (StreamingTaxType)

Aby pobierać podatki komunikacyjne lub podatki od rozrywki w Stanach Zjednoczonych, wybierz odpowiednią kategorię podatkową.

Więcej informacji

OneTimeProductPurchaseOption

jedną opcję zakupu produktu kupowanego raz;

Zapis JSON 
{
  "purchaseOptionId": string,
  "state": enum (State),
  "regionalPricingAndAvailabilityConfigs": [
    {
      object (RegionalPricingAndAvailabilityConfig)
    }
  ],
  "newRegionsConfig": {
    object (OneTimeProductPurchaseOptionNewRegionsConfig)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "taxAndComplianceSettings": {
    object (PurchaseOptionTaxAndComplianceSettings)
  },

  // Union field purchase_option_type can be only one of the following:
  "buyOption": {
    object (OneTimeProductBuyPurchaseOption)
  },
  "rentOption": {
    object (OneTimeProductRentPurchaseOption)
  }
  // End of list of possible types for union field purchase_option_type.
}
Pola
purchaseOptionId

string

Wymagane. Wartość niezmienna. Unikalny identyfikator tej opcji zakupu. Musi być unikalny w produkcie kupowanym raz. Musi zaczynać się od cyfry lub małej litery i może zawierać tylko małe litery (a–z), cyfry (0–9) i łączniki (-). Maksymalna długość to 63 znaki.
state

enum (State)

Tylko dane wyjściowe. Stan opcji zakupu, czyli czy jest aktywna. Tego pola nie można zmienić, aktualizując zasób. Zamiast tego używaj dedykowanych punktów końcowych.
regionalPricingAndAvailabilityConfigs[]

object (RegionalPricingAndAvailabilityConfig)

Informacje o regionalnej cenie i dostępności tej opcji zakupu.
newRegionsConfig

object (OneTimeProductPurchaseOptionNewRegionsConfig)

informacje o cenach w nowych lokalizacjach, w których Google Play może w przyszłości wprowadzić usługę. Jeśli go pominiesz, opcja zakupu nie będzie automatycznie dostępna w żadnych nowych lokalizacjach, w których Google Play może pojawić się w przyszłości.
offerTags[]

object (OfferTag)

Opcjonalnie: Lista maksymalnie 20 tagów niestandardowych określonych dla tej opcji zakupu, które są zwracane do aplikacji za pomocą biblioteki płatności. Oferty związane z tą opcją zakupu również otrzymają te tagi w bibliotece płatności.
taxAndComplianceSettings

object (PurchaseOptionTaxAndComplianceSettings)

Opcjonalnie: Szczegółowe informacje o podatkach i zgodności z przepisami.
Pole zbiorcze purchase_option_type. Typ tej opcji zakupu. Musi być ustawiona dokładnie jedna wartość. purchase_option_type może mieć tylko jedną z tych wartości:
buyOption

object (OneTimeProductBuyPurchaseOption)

Opcja zakupu, którą można kupić.
rentOption

object (OneTimeProductRentPurchaseOption)

Opcja zakupu, którą można wypożyczyć.

Stan

Obecny stan opcji zakupu.

Wartości w polu enum
STATE_UNSPECIFIED Wartość domyślna, której nigdy nie należy używać.
DRAFT Opcja zakupu nie jest i nigdy nie była dostępna dla użytkowników.
ACTIVE Opcja zakupu jest dostępna dla użytkowników.
INACTIVE Opcja zakupu nie jest już dostępna dla użytkowników.
INACTIVE_PUBLISHED Opcja zakupu nie jest już dostępna, ale nadal udostępniamy jej ofertę w Bibliotece płatności w Play ze względu na zgodność z wcześniejszymi rozwiązaniami. W tym stanie mogą znajdować się tylko opcje zakupu przeniesione automatycznie.

OneTimeProductBuyPurchaseOption

Opcja zakupu, którą można kupić.

Zapis JSON 
{
  "legacyCompatible": boolean,
  "multiQuantityEnabled": boolean
}
Pola
legacyCompatible

boolean

Opcjonalnie: Określa, czy ta opcja zakupu będzie dostępna w przypadku starszych procesów Biblioteki płatności w Play, które nie obsługują modelu produktów kupowanych raz.

Jako zgodną wstecznie można oznaczyć maksymalnie 1 opcję zakupu „Kup”.
multiQuantityEnabled

boolean

Opcjonalnie: Określa, czy ta opcja zakupu umożliwia zakup większej liczby produktów. Wielokrotność umożliwia kupującemu zakup więcej niż 1 produktu w ramach jednej transakcji.

OneTimeProductRentPurchaseOption

Opcja zakupu, którą można wypożyczyć.

Zapis JSON 
{
  "rentalPeriod": string,
  "expirationPeriod": string
}
Pola
rentalPeriod

string

Wymagane. Czas, przez jaki użytkownik ma uprawnienia. Dostępne po zakończeniu procesu zakupu. Podany w formacie ISO 8601.
expirationPeriod

string

Opcjonalnie: Czas, jaki użytkownik ma na korzystanie z uprawnienia po rozpoczęciu korzystania z niego, zanim zostanie ono cofnięte. Podany w formacie ISO 8601.

RegionalPricingAndAvailabilityConfig

Konfiguracja regionalnej ceny i dostępności opcji zakupu.

Zapis JSON 
{
  "regionCode": string,
  "price": {
    object (Money)
  },
  "availability": enum (Availability)
}
Pola
regionCode

string

Wymagane. Kod regionu, którego dotyczy ta konfiguracja, zgodnie z normą ISO 3166-2, np. „US”.
price

object (Money)

Cena opcji zakupu w określonym regionie. Musi być ustawiona w walucie powiązanej z określonym regionem.
availability

enum (Availability)

Dostępność opcji zakupu.

Dostępność

Dostępność opcji zakupu.

Wartości w polu enum
AVAILABILITY_UNSPECIFIED Nieokreślona dostępność. Nie można używać.
AVAILABLE Opcja zakupu jest dostępna dla użytkowników.
NO_LONGER_AVAILABLE Opcja zakupu nie jest już dostępna dla użytkowników. Tej wartości można użyć tylko wtedy, gdy dostępność została wcześniej ustawiona jako AVAILABLE.
AVAILABLE_IF_RELEASED Opcja zakupu jest początkowo niedostępna, ale staje się dostępna w ramach opublikowanej oferty przedsprzedaży.
AVAILABLE_FOR_OFFERS_ONLY Opcja zakupu jest niedostępna, ale powiązane z nią oferty (np. oferta Play Points) są dostępne.

OneTimeProductPurchaseOptionNewRegionsConfig

informacje o cenach w nowych regionach, w których Play może w przyszłości wprowadzić usługę;

Zapis JSON 
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  },
  "availability": enum (Availability)
}
Pola
usdPrice

object (Money)

Wymagane. Cena w USD, która będzie używana w przypadku nowych regionów, w których Google Play może wprowadzić usługę.
eurPrice

object (Money)

Wymagane. Cena w EUR, która będzie obowiązywać w nowych regionach, w których Google Play może rozpocząć działalność.
availability

enum (Availability)

Wymagane. Konfiguracja regionalnej dostępności w nowych regionach. Jeśli ustawisz wartość DOSTĘPNE, informacje o cenach będą używane w przypadku wszystkich nowych regionów, w których Google Play może w przyszłości rozpocząć działalność.

Dostępność

Dostępność nowej konfiguracji regionów.

Wartości w polu enum
AVAILABILITY_UNSPECIFIED Nieokreślona dostępność. Nie można używać.
AVAILABLE Konfiguracja będzie używana w przypadku wszystkich nowych regionów, w których Google Play może w przyszłości rozpocząć działalność.
NO_LONGER_AVAILABLE Ta konfiguracja nie jest już dostępna i nie będzie używana w żadnych nowych regionach, w których Google Play może w przyszłości wprowadzić swoje usługi. Tej wartości można użyć tylko wtedy, gdy dostępność została wcześniej ustawiona jako AVAILABLE.

PurchaseOptionTaxAndComplianceSettings

Szczegółowe informacje o podatkach, zasadach Google Play i zgodności z przepisami prawnymi w przypadku opcji zakupu produktów kupowanych raz.

Zapis JSON 
{
  "withdrawalRightType": enum (WithdrawalRightType)
}
Pola
withdrawalRightType

enum (WithdrawalRightType)

Opcjonalnie: Klasyfikacja jako treści cyfrowe lub usługa w przypadku produktów rozpowszechnianych wśród użytkowników w odpowiednich regionach.

Jeśli nie jest ustawiona, domyślnie przyjmuje wartość WITHDRAWAL_RIGHT_DIGITAL_CONTENT.

Więcej informacji znajdziesz w tym artykule w Centrum pomocy.

Metody

batchDelete

 Usuwa co najmniej 1 produkt kupowany raz.

batchGet

 Odczytuje co najmniej 1 produkt kupowany raz.

batchUpdate

 Tworzy lub aktualizuje co najmniej 1 produkt kupowany raz.

delete

 Usuwa produkt kupowany raz.

get

 Odczytuje pojedynczy produkt kupowany raz.

list

 Wyświetla listę wszystkich produktów kupowanych raz w danej aplikacji.

patch

 Tworzy lub aktualizuje produkt kupowany raz.

Kody błędów

Operacje tego zasobu 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.