REST Resource: monetization.subscriptions

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

string

Niezmienne. Nazwa pakietu aplikacji nadrzędnej.

string

Niezmienne. Unikalny identyfikator produktu. Unikalny w aplikacji nadrzędnej. Identyfikatory produktów mogą 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 mają od 1 do 40 znaków (włącznie).

object (BasePlan)

Zestaw abonamentów podstawowych dla tej subskrypcji. Określa ceny i czas trwania subskrypcji, jeśli nie mają zastosowania inne oferty.

object (SubscriptionListing)

Wymagany. Lista zlokalizowanych wizytówek tej subskrypcji. Musi zawierać co najmniej wpis dla domyślnego języka aplikacji nadrzędnej.

boolean

Tylko dane wyjściowe. Określa, czy ta subskrypcja jest zarchiwizowana. Zarchiwizowane subskrypcje nie są już dostępne dla żadnego subskrybenta, nie można ich zaktualizować ani zwrócić w odpowiedzi na żądania listy, chyba że zostanie przekazana flaga zarchiwizowanego programu.

object (SubscriptionTaxAndComplianceSettings)

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

{
  "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)
  }
  // End of list of possible types for union field base_plan_type.
}

string

Wymagany. Niezmienne. Unikalny identyfikator abonamentu podstawowego. Musi być unikalny w obrębie subskrypcji i zgodny z RFC-1034. Oznacza to, że identyfikator może zawierać tylko małe litery (a–z), cyfry (0–9) i myślniki (-). Maksymalna długość to 63 znaki.

enum (State)

Tylko dane wyjściowe. Stan abonamentu podstawowego, czyli 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żyj specjalnych punktów końcowych.

object (RegionalBasePlanConfig)

Informacje dotyczące tego abonamentu podstawowego obowiązujące w poszczególnych regionach.

object (OfferTag)

Lista maksymalnie 20 tagów niestandardowych określonych w przypadku tego abonamentu podstawowego i zwrócona do aplikacji przez bibliotekę płatności. Oferty subskrypcji tego abonamentu podstawowego również otrzymają te tagi ofert w bibliotece płatności.

object (OtherRegionsBasePlanConfig)

W przyszłości wprowadzimy informacje o cenach wszystkich nowych lokalizacji w Google Play. W przypadku ich pominięcia abonament podstawowy nie będzie automatycznie dostępny w żadnych nowych lokalizacjach, które Play może uruchomić w przyszłości.

object (AutoRenewingBasePlanType)

Określ, kiedy abonament podstawowy ma być automatycznie odnawiany w regularnych odstępach czasu.

object (PrepaidBasePlanType)

Określ, kiedy abonament podstawowy nie odnawia się automatycznie po zakończeniu okresu rozliczeniowego.

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

string

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

string

Okres prolongaty subskrypcji podany w formacie ISO 8601. Dopuszczalne wartości to P0D (zero dni), P3D (3 dni), P7D (7 dni), P14D (14 dni) i P30D (30 dni). Jeśli jej nie określisz, użyjemy domyślnej wartości na podstawie czasu trwania okresu cyklicznego.

enum (ResubscribeState)

Określa, czy użytkownicy powinni mieć możliwość ponownego odnowienia tego abonamentu podstawowego w usługach Google Play. Jeśli nie zostanie podany, wartość domyślna to RESUB_STATE_ACTIVE

enum (SubscriptionProrationMode)

Tryb podziału na abonament podstawowy określa, co się dzieje, gdy użytkownik przechodzi z abonamentu na inny. 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 do wycofanej metody querySkuDetailsAsync() Biblioteki płatności w Google Play.

W ramach danej subskrypcji można oznaczyć tylko 1 odnowiony abonament podstawowy.

string

Identyfikator oferty subskrypcji, która jest zgodna ze starszą wersją.

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

Tylko 1 ofertę subskrypcji można oznaczyć jako zgodną ze starszą wersją abonamentu podstawowego.

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

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

string

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

enum (TimeExtension)

Określa, czy użytkownicy mogą przedłużyć ten przedpłacony abonament podstawowy na platformach Google Play. Jeśli nie zostanie podany, domyślna wartość to TIME_EXTENSION_ACTIVE.

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

string

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

boolean

Określa, czy abonament podstawowy w określonym regionie jest dostępny dla nowych subskrybentów. Dotychczasowi subskrybenci nie będą musieli anulować subskrypcji, jeśli ta wartość będzie ustawiona na „fałsz”. Jeśli nie określisz tego ustawienia, zostanie domyślnie ustawiona wartość fałsz.

object (Money)

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

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

object (Money)

Wymagany. Cena w USD używana w przypadku wszystkich nowych lokalizacji, w których Google Play może zostać wprowadzona.

object (Money)

Wymagany. Cena w euro będzie używana w przypadku wszystkich nowych lokalizacji, w których może być dostępna usługa Google Play.

boolean

Czy abonament podstawowy jest dostępny dla nowych subskrybentów w nowych lokalizacjach, w których może zostać uruchomiony Google Play. Jeśli nie określisz tego ustawienia, zostanie domyślnie ustawiona wartość fałsz.

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

string

Wymagany. Język tej pozycji określony za pomocą BCP-47, np. „pl-PL”.

string

Wymagany. Tytuł tej subskrypcji w języku tej strony. Zwykły tekst.

string

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

string

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