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 obrębie aplikacji nadrzędnej. Identyfikator produktu musi zaczynać się od cyfry lub małej litery i może zawierać tylko cyfry (0–9), małe litery (a–z), podkreślenia (_) i kropki (.).
listings[]

object (OneTimeProductListing)

Wymagane. Zestaw danych dotyczących zlokalizowanego 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 pole jest puste, nie są nakładane ż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 i zwracanych do aplikacji przez bibliotekę 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 aplikacji w danym regionie dotyczące produktu kupowanego raz.

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

string

Wymagane. Język tych informacji, zgodnie ze standardem BCP-47, np. „en-US”.
title

string

Wymagane. Tytuł tego produktu w języku strony z informacjami. Maksymalna długość to 55 znaków.
description

string

Wymagane. Opis produktu w języku strony aplikacji. Maksymalna długość to 200 znaków.

OneTimeProductTaxAndComplianceSettings

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

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

object (RegionalTaxConfig)

Konfiguracja podatku regionalnego.
isTokenizedDigitalAsset

boolean

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

object (RegionalProductAgeRatingInfo)

Informacje o regionalnych kategoriach wiekowych. Obecnie to pole jest obsługiwane tylko w przypadku kodu regionu US.
productTaxCategoryCode

string

Kod kategorii podatkowej produktu, który ma zostać przypisany do produktu kupowanego raz. Kategoria podatkowa produktu określa stawki podatku od transakcji stosowane w przypadku produktu. Więcej informacji znajdziesz w artykule w Centrum pomocy.

RegionalTaxConfig

Szczegółowe informacje o podatkach 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 ze standardem ISO 3166-1 alfa-2, np. „PL”.
taxTier

enum (TaxTier)

Poziom podatku, aby określić 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. 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

Pojedyncza opcja zakupu produktu kupowanego raz.

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "buyOption": {
    object (OneTimeProductBuyPurchaseOption)
  },
  "rentOption": {
    object (OneTimeProductRentPurchaseOption)
  }
  // End of mutually exclusive fields.
}
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ć przez aktualizację zasobu. Zamiast tego użyj 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, które Google Play może wprowadzić w przyszłości. Jeśli pominiesz tę opcję, opcja zakupu nie będzie automatycznie dostępna w żadnych nowych lokalizacjach, w których Google Play może zostać uruchomiony w przyszłości.
offerTags[]

object (OfferTag)

Opcjonalnie: Lista maksymalnie 20 tagów niestandardowych określonych dla tej opcji zakupu i zwracanych do aplikacji przez Bibliotekę płatności. Oferty dotyczące tej opcji 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.
Typ tej opcji zakupu. Musisz ustawić dokładnie jedną z nich. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
buyOption

object (OneTimeProductBuyPurchaseOption)

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

object (OneTimeProductRentPurchaseOption)

Opcja zakupu, którą można wypożyczyć.
Koniec pól wykluczających się wzajemnie.

Stan

Bieżący stan opcji zakupu.

Wartości w polu enum
STATE_UNSPECIFIED Wartość domyślna, która nie powinna być nigdy używana.
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, aby zapewnić zgodność wsteczną. W tym stanie mogą być tylko automatycznie przeniesione opcje zakupu.

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 starszych procesach Biblioteki płatności w Play, które nie obsługują modelu produktów kupowanych raz.

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

boolean

Opcjonalnie: Czy ta opcja zakupu umożliwia zakup wielu sztuk. Wiele sztuk 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. Wartość podana w formacie ISO 8601.
expirationPeriod

string

Opcjonalnie: Czas, jaki użytkownik ma od momentu rozpoczęcia korzystania z uprawnienia do momentu jego unieważnienia. Wartość podana w formacie ISO 8601.

RegionalPricingAndAvailabilityConfig

Konfiguracja regionalnych cen 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 ze standardem ISO 3166-1 alfa-2, np. „PL”.
price

object (Money)

Cena opcji zakupu w określonym regionie. Musi być podana 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 DOSTĘPNA.
AVAILABLE_IF_RELEASED Opcja zakupu jest początkowo niedostępna, ale staje się dostępna dzięki opublikowanej ofercie przedsprzedaży.
AVAILABLE_FOR_OFFERS_ONLY Opcja zakupu jest niedostępna, ale oferty z nią powiązane (np. oferta Play Points) są dostępne.

OneTimeProductPurchaseOptionNewRegionsConfig

Informacje o cenach w nowych regionach, w których Google Play może zostać uruchomione w przyszłości.

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 nowych regionach, w których Google Play może zostać uruchomiony.
eurPrice

object (Money)

Wymagane. Cena w EUR, która będzie obowiązywać w nowych regionach, w których Google Play może zostać uruchomione.
availability

enum (Availability)

Wymagane. Dostępność regionalna w konfiguracji nowych regionów. Jeśli ustawisz opcję DOSTĘPNE, informacje o cenach będą używane w przypadku wszystkich nowych regionów, w których Google Play może zostać uruchomione w przyszłości.

Dostępność

Dostępność konfiguracji nowych 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 zostać uruchomiony w przyszłości.
NO_LONGER_AVAILABLE Konfiguracja nie jest już dostępna i nie będzie używana w żadnych nowych regionach, w których Google Play może zostać uruchomione w przyszłości. Tej wartości można użyć tylko wtedy, gdy dostępność została wcześniej ustawiona jako DOSTĘPNA.

PurchaseOptionTaxAndComplianceSettings

Szczegółowe informacje o podatkach, zasadach Google Play i zgodności z przepisami w przypadku opcji zakupu produktu kupowanego 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 kwalifikujących się regionach.

Jeśli nie ustawisz tej zasady, domyślnie będzie używana wartość WITHDRAWAL_RIGHT_DIGITAL_CONTENT.

Więcej informacji znajdziesz w 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 Opis Rozdzielczość