REST Resource: monetization.subscriptions

Zasób: Subscription

Pojedyncza subskrypcja aplikacji.

Zapis JSON 
{
  "packageName": string,
  "productId": string,
  "basePlans": [
    {
      object (BasePlan)
    }
  ],
  "listings": [
    {
      object (SubscriptionListing)
    }
  ],
  "archived": boolean,
  "taxAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  },
  "restrictedPaymentCountries": {
    object (RestrictedPaymentCountries)
  }
}
Pola
packageName

string

Niezmienna. Nazwa pakietu aplikacji nadrzędnej.
productId

string

Niezmienna. Unikalny identyfikator produktu. Unikalny w aplikacji nadrzędnej. Identyfikatory produktów muszą składać się z małych liter (a–z), cyfr (0–9), podkreśleń (_) i kropek (.). Muszą zaczynać się od małej litery lub cyfry i mieć od 1 do 40 znaków (włącznie).
basePlans[]

object (BasePlan)

Zestaw abonamentów podstawowych dla tego abonamentu. Zawiera ceny i czas trwania subskrypcji, jeśli nie obowiązują inne oferty.
listings[]

object (SubscriptionListing)

Wymagane. Lista zlokalizowanych informacji o tej subskrypcji. Musi zawierać co najmniej wpis dla języka domyślnego aplikacji nadrzędnej.
archived
(deprecated)

boolean

Tylko dane wyjściowe. Wycofano: archiwizowanie subskrypcji nie jest obsługiwane.
taxAndComplianceSettings

object (SubscriptionTaxAndComplianceSettings)

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

object (RestrictedPaymentCountries)

Opcjonalnie. Kraje, w których zakup tej subskrypcji 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.

BasePlan

Pojedynczy abonament podstawowy subskrypcji.

Zapis JSON 
{
  "basePlanId": string,
  "state": enum (State),
  "regionalConfigs": [
    {
      object (RegionalBasePlanConfig)
    }
  ],
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsBasePlanConfig)
  },

  // Union field base_plan_type can be only one of the following:
  "autoRenewingBasePlanType": {
    object (AutoRenewingBasePlanType)
  },
  "prepaidBasePlanType": {
    object (PrepaidBasePlanType)
  },
  "installmentsBasePlanType": {
    object (InstallmentsBasePlanType)
  }
  // End of list of possible types for union field base_plan_type.
}
Pola
basePlanId

string

Wymagane. Niezmienna. Unikalny identyfikator tego abonamentu podstawowego. Musi być unikalna w obrębie subskrypcji i zgodna z RFC-1034. Oznacza to, że identyfikator może zawierać tylko małe litery (a–z), cyfry (0–9) i łączniki (-), a jego maksymalna długość to 63 znaki.
state

enum (State)

Tylko dane wyjściowe. Stan abonamentu podstawowego, czyli czy jest aktywny. Wersje robocze i nieaktywne abonamenty podstawowe można aktywować lub usuwać. Aktywne subskrypcje podstawowe można dezaktywować. Nieaktywne abonamenty podstawowe można anulować. Tego pola nie można zmienić przez zaktualizowanie zasobu. Zamiast tego używaj dedykowanych punktów końcowych.
regionalConfigs[]

object (RegionalBasePlanConfig)

Informacje dotyczące tego abonamentu podstawowego w poszczególnych regionach.
offerTags[]

object (OfferTag)

Lista maksymalnie 20 tagów niestandardowych określonych dla tego abonamentu podstawowego, które są zwracane do aplikacji za pomocą biblioteki płatności. Oferty subskrypcji dla tego abonamentu podstawowego również otrzymają te tagi ofert w bibliotece rozliczeniowej.
otherRegionsConfig

object (OtherRegionsBasePlanConfig)

informacje o cenach w nowych lokalizacjach, w których Google Play może być dostępny w przyszłości; Jeśli ten parametr zostanie pominięty, abonament Base Plan nie będzie automatycznie dostępny w nowych lokalizacjach, w których Google Play może w przyszłości uruchomić usługę.
Pole zbiorcze base_plan_type. Typ tego abonamentu podstawowego. Musi być ustawiona dokładnie jedna z tych wartości. Po utworzeniu planu podstawowego nie można zmienić jego typu. base_plan_type może mieć tylko jedną z tych wartości:
autoRenewingBasePlanType

object (AutoRenewingBasePlanType)

Ustaw, kiedy abonament podstawowy ma być automatycznie odnawiany w regularnych odstępach czasu.
prepaidBasePlanType

object (PrepaidBasePlanType)

Ustaw, kiedy abonament podstawowy nie odnawia się automatycznie na koniec okresu rozliczeniowego.
installmentsBasePlanType

object (InstallmentsBasePlanType)

Ustawienie dla ratalnych abonamentów podstawowych, w przypadku których użytkownik zobowiązuje się do dokonania określonej liczby płatności.

Stan

Obecny stan abonamentu podstawowego.

Wartości w polu enum
STATE_UNSPECIFIED Nieokreślony stan.
DRAFT Abonament podstawowy jest obecnie w stanie wersji roboczej i nie został jeszcze aktywowany. Możesz go teraz bezpiecznie usunąć.
ACTIVE Abonament podstawowy jest aktywny i dostępny dla nowych subskrybentów.
INACTIVE Abonament podstawowy jest nieaktywny i dostępny tylko dla obecnych subskrybentów.

AutoRenewingBasePlanType

Reprezentuje abonament podstawowy, który odnawia się automatycznie po zakończeniu okresu subskrypcji.

Zapis JSON 
{
  "billingPeriodDuration": string,
  "gracePeriodDuration": string,
  "accountHoldDuration": string,
  "resubscribeState": enum (ResubscribeState),
  "prorationMode": enum (SubscriptionProrationMode),
  "legacyCompatible": boolean,
  "legacyCompatibleSubscriptionOfferId": string
}
Pola
billingPeriodDuration

string

Wymagane. Niezmienna. Okres subskrypcji podany w formacie ISO 8601. Listę akceptowanych okresów rozliczeniowych znajdziesz w Centrum pomocy. Po utworzeniu planu podstawowego nie można zmienić czasu trwania.
gracePeriodDuration

string

Okres prolongaty subskrypcji podany w formacie ISO 8601. Akceptowane wartości muszą być podane w dniach i mieścić się w zakresie od P0D do mniejszej z wartości 30D i okresu rozliczeniowego abonamentu podstawowego.

Jeśli nie zostanie określona, zostanie użyta wartość domyślna na podstawie okresu rozliczeniowego.

Suma wartości gracePeriodDuration i accountHoldDuration musi wynosić od P30D do P60D dni.
accountHoldDuration

string

Opcjonalnie. Niestandardowy okres zawieszenia konta w przypadku subskrypcji podany w formacie ISO 8601. Akceptowane wartości muszą być podane w dniach i mieścić się w przedziale od P0D do P60D.

Puste pole oznacza zalecany okres zawieszenia konta, który jest obliczany jako 60 dni minus okres prolongaty.

Suma wartości gracePeriodDuration i accountHoldDuration musi wynosić od P30D do P60D dni.
resubscribeState

enum (ResubscribeState)

Określa, czy użytkownicy powinni mieć możliwość ponownej subskrypcji tego abonamentu podstawowego w Google Play. Jeśli nie zostanie podany, domyślnie przyjmuje wartość RESUBSCRIBE_STATE_ACTIVE.
prorationMode

enum (SubscriptionProrationMode)

Tryb proporcjonalnego rozliczania abonamentu podstawowego określa, co się stanie, gdy użytkownik przejdzie na ten abonament z innego abonamentu podstawowego. Jeśli nie określono inaczej, domyślnie jest to CHARGE_ON_NEXT_BILLING_DATE.
legacyCompatible

boolean

Określa, czy odnawiany abonament podstawowy jest zgodny wstecznie.

Zgodny wstecznie abonament podstawowy jest zwracany do wycofanej metody querySkuDetailsAsync() Biblioteki płatności w Google Play.

W przypadku danej subskrypcji tylko 1 odnawiany abonament podstawowy może być oznaczony jako zgodny ze starszą wersją.
legacyCompatibleSubscriptionOfferId

string

Identyfikator oferty subskrypcji zgodnej ze starszymi wersjami.

Zgodna wstecznie oferta subskrypcji jest zwracana do wycofanej metody querySkuDetailsAsync() Biblioteki płatności w Google Play.

W przypadku danego odnawianego abonamentu podstawowego tylko 1 oferta subskrypcji może być oznaczona jako zgodna ze starszą wersją.

Aby nie mieć oferty subskrypcji zgodnej ze starszymi wersjami, ustaw to pole jako pusty ciąg znaków.

ResubscribeState

Stan ponownej subskrypcji abonamentu podstawowego.

Wartości w polu enum
RESUBSCRIBE_STATE_UNSPECIFIED Nieokreślony stan.
RESUBSCRIBE_STATE_ACTIVE Ponowna subskrypcja jest aktywna.
RESUBSCRIBE_STATE_INACTIVE Ponowna subskrypcja jest nieaktywna.

SubscriptionProrationMode

Tryb proporcjonalnego rozliczania używany do odnawiania abonamentów podstawowych.

Wartości w polu enum
SUBSCRIPTION_PRORATION_MODE_UNSPECIFIED Tryb nieokreślony.
SUBSCRIPTION_PRORATION_MODE_CHARGE_ON_NEXT_BILLING_DATE Użytkownicy zostaną obciążeni płatnością za nowy abonament podstawowy na koniec bieżącego okresu rozliczeniowego.
SUBSCRIPTION_PRORATION_MODE_CHARGE_FULL_PRICE_IMMEDIATELY Użytkownicy zostaną od razu obciążeni pełną opłatą za nowy abonament podstawowy. Pozostały okres dotychczasowej subskrypcji zostanie wykorzystany do przedłużenia czasu trwania nowego abonamentu.

PrepaidBasePlanType

Oznacza abonament podstawowy, który nie jest automatycznie odnawiany po zakończeniu okresu obowiązywania i musi zostać odnowiony ręcznie przez użytkownika.

Zapis JSON 
{
  "billingPeriodDuration": string,
  "timeExtension": enum (TimeExtension)
}
Pola
billingPeriodDuration

string

Wymagane. Niezmienna. Okres subskrypcji podany w formacie ISO 8601. Listę akceptowanych okresów rozliczeniowych znajdziesz w Centrum pomocy. Po utworzeniu planu podstawowego nie można zmienić czasu trwania.
timeExtension

enum (TimeExtension)

Czy użytkownicy powinni mieć możliwość przedłużenia tego abonamentu podstawowego w Google Play. Jeśli nie zostanie podany, domyślnie przyjmuje wartość TIME_EXTENSION_ACTIVE.

TimeExtension

Przedłużenie czasu trwania abonamentu podstawowego.

Wartości w polu enum
TIME_EXTENSION_UNSPECIFIED Nieokreślony stan.
TIME_EXTENSION_ACTIVE Przedłużenie czasu jest aktywne. Użytkownicy mogą doładować lub przedłużyć abonament przedpłacony.
TIME_EXTENSION_INACTIVE Przedłużenie czasu jest nieaktywne. Użytkownicy nie mogą doładować ani przedłużyć abonamentu przedpłaconego.

InstallmentsBasePlanType

Oznacza ratalny abonament podstawowy, w ramach którego użytkownik zobowiązuje się do dokonania określonej liczby płatności.

Zapis JSON 
{
  "billingPeriodDuration": string,
  "committedPaymentsCount": integer,
  "renewalType": enum (RenewalType),
  "gracePeriodDuration": string,
  "accountHoldDuration": string,
  "resubscribeState": enum (ResubscribeState),
  "prorationMode": enum (SubscriptionProrationMode)
}
Pola
billingPeriodDuration

string

Wymagane. Niezmienna. Okres subskrypcji podany w formacie ISO 8601. Listę akceptowanych okresów rozliczeniowych znajdziesz w Centrum pomocy. Po utworzeniu planu podstawowego nie można zmienić czasu trwania.
committedPaymentsCount

integer

Wymagane. Niezmienna. Liczba płatności, do których użytkownik się zobowiązał. Po utworzeniu planu podstawowego nie można go zmienić.
renewalType

enum (RenewalType)

Wymagane. Niezmienna. Typ odnowienia abonamentu podstawowego w przypadku płatności ratalnych. Określa zachowanie po zakończeniu początkowego okresu zobowiązania. Po utworzeniu planu podstawowego nie można zmienić typu odnowienia.
gracePeriodDuration

string

Okres prolongaty subskrypcji podany w formacie ISO 8601. Akceptowane wartości muszą być podane w dniach i mieścić się w zakresie od P0D do mniejszej z wartości 30D i okresu rozliczeniowego abonamentu podstawowego.

Jeśli nie zostanie określona, zostanie użyta wartość domyślna na podstawie okresu rozliczeniowego.

Suma wartości gracePeriodDuration i accountHoldDuration musi wynosić od P30D do P60D dni.
accountHoldDuration

string

Opcjonalnie. Niestandardowy okres zawieszenia konta w przypadku subskrypcji podany w formacie ISO 8601. Akceptowane wartości muszą być podane w dniach i mieścić się w przedziale od P0D do P60D.

Puste pole oznacza zalecany okres zawieszenia konta, który jest obliczany jako 60 dni minus okres prolongaty.

Suma wartości gracePeriodDuration i accountHoldDuration musi wynosić od P30D do P60D dni.
resubscribeState

enum (ResubscribeState)

Określa, czy użytkownicy powinni mieć możliwość ponownej subskrypcji tego abonamentu podstawowego w Google Play. Jeśli nie zostanie podany, domyślnie przyjmuje wartość RESUBSCRIBE_STATE_ACTIVE.
prorationMode

enum (SubscriptionProrationMode)

Tryb proporcjonalnego rozliczania abonamentu podstawowego określa, co się stanie, gdy użytkownik przejdzie na ten abonament z innego abonamentu podstawowego. Jeśli nie określono inaczej, domyślnie jest to CHARGE_ON_NEXT_BILLING_DATE.

RenewalType

Typ odnowienia abonamentu podstawowego w przypadku płatności ratalnych. Określa zachowanie po zakończeniu początkowego okresu zobowiązania. Po utworzeniu planu podstawowego nie można zmienić typu odnowienia.

Wartości w polu enum
RENEWAL_TYPE_UNSPECIFIED Nieokreślony stan.
RENEWAL_TYPE_RENEWS_WITHOUT_COMMITMENT Odnowienie następuje okresowo na czas trwania okresu rozliczeniowego bez zobowiązania.
RENEWAL_TYPE_RENEWS_WITH_COMMITMENT Odnowienie z zobowiązaniem o tym samym czasie trwania co początkowe.

RegionalBasePlanConfig

Konfiguracja abonamentu podstawowego w określonym regionie.

Zapis JSON 
{
  "regionCode": string,
  "newSubscriberAvailability": boolean,
  "price": {
    object (Money)
  }
}
Pola
regionCode

string

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

boolean

Określa, czy abonament podstawowy w danym regionie jest dostępny dla nowych subskrybentów. Jeśli ta wartość jest ustawiona na „false”, subskrypcje obecnych subskrybentów nie zostaną anulowane. Jeśli nie podasz żadnej wartości, domyślnie zostanie użyta wartość „false”.
price

object (Money)

Cena abonamentu podstawowego w określonym regionie. Musi być ustawiona, jeśli abonament podstawowy jest dostępny dla nowych subskrybentów. Musi być ustawiona w walucie powiązanej z określonym regionem.

OtherRegionsBasePlanConfig

informacje o cenach w nowych lokalizacjach, w których może pojawić się usługa Google Play;

Zapis JSON 
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  },
  "newSubscriberAvailability": boolean
}
Pola
usdPrice

object (Money)

Wymagane. Cena w USD, która będzie używana w przypadku nowych lokalizacji, w których może pojawić się usługa Google Play.
eurPrice

object (Money)

Wymagane. Cena w EUR, która będzie używana w przypadku nowych lokalizacji, w których Play może wprowadzić usługę.
newSubscriberAvailability

boolean

Czy abonament podstawowy jest dostępny dla nowych subskrybentów w nowych lokalizacjach, w których może pojawić się usługa Google Play. Jeśli nie podasz żadnej wartości, domyślnie zostanie użyta wartość „false”.

SubscriptionListing

Metadane subskrypcji widoczne dla klienta.

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

string

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

string

Wymagane. Tytuł tej subskrypcji w języku tej karty. Zwykły tekst.
benefits[]

string

Lista korzyści wyświetlana użytkownikowi na platformach takich jak Sklep Play i w procesach przywracania w języku tej strony aplikacji. Zwykły tekst. Uporządkowana lista maksymalnie 4 korzyści.
description

string

Opis tej subskrypcji w języku tej strony. Maksymalna długość to 80 znaków. Zwykły tekst.

Metody

archive
(deprecated)

 Wycofano: archiwizowanie subskrypcji nie jest obsługiwane.

batchGet

 Odczytuje co najmniej 1 subskrypcję.

batchUpdate

 Aktualizuje grupę subskrypcji.

create

 Tworzy nową subskrypcję.

delete

 Usuwa subskrypcję.

get

 Odczytuje pojedynczą subskrypcję.

list

 Wyświetla wszystkie subskrypcje w danej aplikacji.

patch

 Aktualizuje istniejącą 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.