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. Niezmienne. Nazwa pakietu aplikacji nadrzędnej.
productId

string

Wymagane. Niezmienne. 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

Regionalna informacja o sklepie dotycząca 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. Niezmienne. 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ć przez zaktualizowanie zasobu. 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 być dostępny w przyszłości; 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 rozliczeniowej. 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 z tych wartości. 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 przepływó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. Podana 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. Podana 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.

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 wprowadzić usługę.
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 Ta 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 przypadku żadnych nowych regionów, w których Google Play może w przyszłości rozpocząć działalność. 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 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 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.