REST Resource: monetization.subscriptions

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

string

Stały. Nazwa pakietu aplikacji nadrzędnej.

string

Stały. Unikalny identyfikator danego produktu. Unikalny w ramach aplikacji nadrzędnej. Identyfikatory produktów mogą zawierać tylko małe litery (a–z), cyfry (0–9), podkreślenia (_) i kropki (.). Musi zaczynać się od małej litery lub cyfry i mieć od 1 do 40 znaków (włącznie).

object (BasePlan)

Zestaw abonamentów podstawowych tej subskrypcji. Określa ceny i czas trwania subskrypcji, jeśli nie ma żadnych innych ofert.

object (SubscriptionListing)

Wymagane. Lista zlokalizowanych informacji o tej subskrypcji. Musi zawierać co najmniej wpis w domyślnym języku aplikacji nadrzędnej.

boolean

Tylko dane wyjściowe. Wycofano: archiwizacja subskrypcji nie jest obsługiwana.

object (SubscriptionTaxAndComplianceSettings)

Informacje o podatkach i zgodności z przepisami.

object (RestrictedPaymentCountries)

Opcjonalnie: Kraje, w których zakup tej subskrypcji jest ograniczony do form płatności zarejestrowanych w tym samym kraju. Jeśli pole jest puste, nie są stosowane żadne ograniczenia lokalizacji płatności.

{
  "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.
}

string

Wymagane. Stały. Unikalny identyfikator tego abonamentu podstawowego. Musi być unikalna w ramach subskrypcji i być zgodna ze standardem RFC-1034. Oznacza to, że ten identyfikator może zawierać tylko małe litery (a–z), cyfry (0–9) i łączniki (-), a jego długość nie może przekraczać 63 znaków.

enum (State)

Tylko dane wyjściowe. Stan abonamentu podstawowego, tj. czy jest aktywny. Wersje robocze i nieaktywne abonamenty podstawowe można aktywować lub usunąć. Aktywne abonamenty podstawowe można dezaktywować. Nieaktywne abonamenty podstawowe można anulować. Tego pola nie można zmienić przez aktualizację zasobu. Zamiast tego używaj dedykowanych punktów końcowych.

object (RegionalBasePlanConfig)

Informacje dotyczące tego abonamentu podstawowego w różnych regionach.

object (OfferTag)

Lista maksymalnie 20 tagów niestandardowych określonych dla tego abonamentu podstawowego i zwróconych do aplikacji za pomocą biblioteki płatności. Oferty subskrypcji tego abonamentu podstawowego będą też zawierać te tagi ofert w bibliotece płatności.

object (OtherRegionsBasePlanConfig)

Informacje o cenach we wszystkich nowych lokalizacjach, które Google Play może udostępnić w przyszłości. Jeśli go pominiesz, abonament Base Plan nie będzie automatycznie dostępny w żadnych nowych lokalizacjach, które Google Play może wprowadzić w przyszłości.

object (AutoRenewingBasePlanType)

Określ, kiedy abonament podstawowy automatycznie odnawia się w regularnych odstępach czasu.

object (PrepaidBasePlanType)

Ustaw, kiedy abonament podstawowy nie będzie automatycznie odnawiany po zakończeniu okresu rozliczeniowego.

object (InstallmentsBasePlanType)

Jest ustawiony dla abonamentów podstawowych rat, w ramach których użytkownik zobowiązuje się do zrealizowania określonej liczby płatności.

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

string

Wymagane. Okres subskrypcji określony w formacie ISO 8601. Listę akceptowanych okresów rozliczeniowych znajdziesz w Centrum pomocy.

string

Okres prolongaty subskrypcji określony w formacie ISO 8601. Akceptowane wartości to P0D (0 dni), P3D (3 dni), P7D (7 dni), P14D (14 dni) i P30D (30 dni). Jeśli nie podasz żadnej wartości, zostanie użyta wartość domyślna na podstawie czasu trwania okresu cyklicznego.

string

Opcjonalnie: Okres zawieszenia konta subskrypcji określony w formacie ISO 8601. Akceptowane wartości muszą należeć do zakresu od DAYS do P30D (30 dni). Jeśli nie podasz żadnej wartości, domyślną wartością będzie P30D (30 dni).

enum (ResubscribeState)

Określa, czy użytkownicy powinni mieć możliwość ponownego wykupienia abonamentu podstawowego na platformach w Google Play. Jeśli nie zostanie podany, przyjmuje domyślnie wartość RESUBSCRIBE_STATE_ACTIVE.

enum (SubscriptionProrationMode)

Tryb proporcjonalnego 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ślna wartość to CHARGE_ON_NEXT_BILLING_DATE.

boolean

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

Zgodny wstecznie abonament podstawowy jest zwracany przez wycofaną metodę querySkuDetailsAsync() Biblioteki płatności w Google Play.

Tylko 1 odnawiany abonament podstawowy może w przypadku danej subskrypcji oznaczyć jako zgodny ze starszą wersją.

string

Identyfikator oferty subskrypcji, który jest zgodny ze starszą wersją.

Oferta subskrypcji zgodnej wstecznie jest zwracana przez wycofaną metodę querySkuDetailsAsync() Biblioteki płatności w Google Play.

Tylko 1 oferta subskrypcji może zostać oznaczona jako zgodna ze starszą wersją w przypadku danego odnawianego abonamentu podstawowego.

Aby żadna oferta subskrypcji nie była zgodna ze starszą wersją, ustaw to pole jako pusty ciąg znaków.

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

string

Wymagane. Okres subskrypcji określony w formacie ISO 8601. Listę akceptowanych okresów rozliczeniowych znajdziesz w Centrum pomocy.

enum (TimeExtension)

Określa, czy użytkownicy powinni mieć możliwość przedłużenia tego przedpłaconego abonamentu podstawowego na platformach w Google Play. Jeśli nie zostanie określona, domyślna wartość to TIME_EXTENSION_ACTIVE.

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

string

Wymagane. Okres subskrypcji określony w formacie ISO 8601. Listę akceptowanych okresów rozliczeniowych znajdziesz w Centrum pomocy.

integer

Wymagane. Liczba płatności, do których zobowiązał się użytkownik.

enum (RenewalType)

Wymagane. Typ odnowienia abonamentu podstawowego. Określa zachowanie na koniec początkowego zobowiązania.

string

Okres prolongaty subskrypcji określony w formacie ISO 8601. Akceptowane wartości to P0D (0 dni), P3D (3 dni), P7D (7 dni), P14D (14 dni) i P30D (30 dni). Jeśli nie podasz żadnej wartości, zostanie użyta wartość domyślna na podstawie czasu trwania okresu cyklicznego.

string

Opcjonalnie: Okres zawieszenia konta subskrypcji, określony wyłącznie w dniach i w formacie ISO 8601. Akceptowane wartości to od P0D (zero dni) do P30D (30 dni). Jeśli nie podasz żadnej wartości, domyślną wartością będzie P30D (30 dni).

enum (ResubscribeState)

Określa, czy użytkownicy powinni mieć możliwość ponownego wykupienia abonamentu podstawowego na platformach w Google Play. Jeśli nie zostanie podany, przyjmuje domyślnie wartość RESUBSCRIBE_STATE_ACTIVE.

enum (SubscriptionProrationMode)

Tryb proporcjonalnego 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ślna wartość to CHARGE_ON_NEXT_BILLING_DATE.

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

string

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

boolean

Określa, czy abonament podstawowy w określonym regionie jest dostępny dla nowych subskrybentów. Jeśli ta wartość ma wartość Fałsz, obecni subskrybenci nie anulują subskrypcji. Jeśli nie podasz żadnej wartości, domyślnie zostanie użyta wartość false (fałsz).

object (Money)

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

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

object (Money)

Wymagane. Cena w USD do wykorzystania we wszystkich nowych lokalizacjach, w których Google Play może wprowadzić aplikację.

object (Money)

Wymagane. Cena w EUR do wykorzystania we wszystkich nowych lokalizacjach, w których będzie można wprowadzić Google Play.

boolean

Informacja o tym, czy abonament podstawowy jest dostępny dla nowych subskrybentów w nowych lokalizacjach, w których może pojawić się Google Play. Jeśli nie podasz żadnej wartości, domyślnie zostanie użyta wartość false (fałsz).

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

string

Wymagane. Język informacji, zgodnie z definicją podaną w dokumencie BCP-47, np. „pl-PL”.

string

Wymagane. Tytuł tej subskrypcji w języku podanym na stronie z informacjami o aplikacji. Zwykły tekst.

string

Lista korzyści wyświetlana użytkownikowi na platformach takich jak Sklep Play i w ramach procesu przywracania w języku tej strony z informacjami o aplikacji. Zwykły tekst. Uporządkowana lista zawierająca maksymalnie 4 korzyści.

string

Opis tej subskrypcji w języku podanym na stronie z informacjami o aplikacji. Maksymalna długość – 80 znaków. Zwykły tekst.

{
  "regionCodes": [
    string
  ]
}

string

Wymagane. Kody regionów, na które nakładane są ograniczenia płatności, zgodnie z normą ISO 3166-2, np. „PL”.