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. Musi być unikalny w aplikacji nadrzędnej. Identyfikatory produktów muszą zaczynać się od cyfry lub małej litery i mogą zawierać tylko cyfry (0–9), małe litery (a–z), podkreślenia (_) i kropki (.).
listings[]

object (OneTimeProductListing)

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

object (OneTimeProductTaxAndComplianceSettings)

Szczegóły dotyczące podatków i zgodności z przepisami.
purchaseOptions[]

object (OneTimeProductPurchaseOption)

Wymagane. Zestaw opcji zakupu tego produktu jednorazowego.
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 i oferty zakupu 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 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 tej informacji. 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 został 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

Opcja pojedynczego 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ć, aktualizując zasób. Zamiast tego używaj dedykowanych punktów końcowych.
regionalPricingAndAvailabilityConfigs[]

object (RegionalPricingAndAvailabilityConfig)

Informacje o regionalnych cenach 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 w przyszłości rozpocząć działalność.
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 rozliczeniowej.
taxAndComplianceSettings

object (PurchaseOptionTaxAndComplianceSettings)

Opcjonalnie. Szczegóły dotyczące podatków i zgodności z przepisami.
Pole unii purchase_option_type. Typ tej opcji zakupu. Musisz ustawić dokładnie jedną 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 Google Play ze względu na zgodność wsteczną. W tym stanie mogą znajdować się tylko opcje zakupu, które zostały 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 PBL, które nie obsługują modelu produktów jednorazowych.

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 płatności.

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. Rozpoczyna się po zakończeniu procesu zakupu. Podana w formacie ISO 8601.
expirationPeriod

string

Opcjonalnie. Czas, jaki użytkownik ma na korzystanie z uprawnienia po jego uzyskaniu, zanim zostanie ono cofnięte. Podana w formacie ISO 8601.

RegionalPricingAndAvailabilityConfig

Konfiguracja regionalnej ceny i dostępności dla 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 może pojawić się usługa Google Play.
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. Dostępność regionalna w przypadku konfiguracji nowych regionów. Jeśli ustawisz wartość AVAILABLE, 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 żadnych nowych regionach, 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 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 ma 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.