REST Resource: monetization.subscriptions.basePlans.offers

{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "state": enum (State),
  "phases": [
    {
      object (SubscriptionOfferPhase)
    }
  ],
  "targeting": {
    object (SubscriptionOfferTargeting)
  },
  "regionalConfigs": [
    {
      object (RegionalSubscriptionOfferConfig)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsSubscriptionOfferConfig)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ]
}

string

Wymagane. Stały. Nazwa pakietu aplikacji, do której należy subskrypcja nadrzędna.

string

Wymagane. Stały. Identyfikator subskrypcji nadrzędnej, do której należy ta oferta.

string

Wymagane. Stały. Identyfikator abonamentu podstawowego, do którego ta oferta jest rozszerzeniem.

string

Wymagane. Stały. Unikalny identyfikator tej oferty subskrypcji. Musi być niepowtarzalna w ramach abonamentu podstawowego.

enum (State)

Tylko dane wyjściowe. Obecny stan tej oferty. Można je zmienić za pomocą działań aktywacji i dezaktywacji. Uwaga: stan abonamentu podstawowego zastępuje ten stan, więc aktywna oferta może być niedostępna, jeśli abonament podstawowy nie jest aktywny.

object (SubscriptionOfferPhase)

Wymagane. Etapy tej oferty subskrypcji. Musi zawierać co najmniej jeden wpis, ale nie więcej niż pięć. Użytkownicy zawsze będą otrzymywać wszystkie te etapy w określonej kolejności. Po utworzeniu etapów nie można ich dodawać, usuwać ani zmieniać ich kolejności.

object (SubscriptionOfferTargeting)

Wymagania, które użytkownicy muszą spełnić, aby kwalifikować się do skorzystania z tej oferty. Określa wymagania, które Google Play oceni, aby zdecydować, czy oferta powinna zostać zwrócona. Deweloperzy mogą samodzielnie filtrować te oferty.

object (RegionalSubscriptionOfferConfig)

Wymagane. Konfiguracja tej oferty w zależności od regionu. Musi zawierać co najmniej 1 wpis.

object (OtherRegionsSubscriptionOfferConfig)

Konfiguracja wszystkich nowych lokalizacji, które Google Play może wprowadzić w przyszłości.

object (OfferTag)

Lista maksymalnie 20 tagów niestandardowych określonych dla tej oferty, które są zwracane do aplikacji przez bibliotekę płatności.

{
  "recurrenceCount": integer,
  "duration": string,
  "regionalConfigs": [
    {
      object (RegionalSubscriptionOfferPhaseConfig)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsSubscriptionOfferPhaseConfig)
  }
}

integer

Wymagane. Liczba powtórzeń tej fazy. Jeśli ta faza oferty nie jest bezpłatna, każde powtórzenie obciąża użytkownika ceną tego etapu oferty.

string

Wymagane. Czas trwania pojedynczego powtórzenia tej fazy. Podana w formacie ISO 8601.

object (RegionalSubscriptionOfferPhaseConfig)

Wymagane. Konfiguracja tego etapu oferty w zależności od regionu. Ta lista musi zawierać dokładnie 1 wpis dla każdego regionu, dla którego oferta subskrypcji ma konfigurację regionalną.

object (OtherRegionsSubscriptionOfferPhaseConfig)

Informacje o cenach we wszystkich nowych lokalizacjach, w których można wprowadzić Google Play.

{
  "regionCode": string,

  // Union field price_override can be only one of the following:
  "price": {
    object (Money)
  },
  "relativeDiscount": number,
  "absoluteDiscount": {
    object (Money)
  },
  "free": {
    object (RegionalSubscriptionOfferPhaseFreePriceOverride)
  }
  // End of list of possible types for union field price_override.
}

string

Wymagane. Stały. Region, do którego ma zastosowanie ta konfiguracja.

object (Money)

Bezwzględna cena, jaką użytkownik płaci w ramach tego etapu oferty. Cena nie może być niższa od minimalnej ceny dozwolonej w tym regionie.

number

Część ceny abonamentu podstawowego proporcjonalna do czasu trwania etapu, który użytkownik płaci za ten etap oferty. Jeśli na przykład cena abonamentu podstawowego w tym regionie wynosi 12 USD przez 1 rok, to 50% zniżki za fazę trwającego 3 miesiące odpowiada cenie 1, 50 USD. Rabat musi być określony jako ułamek większy od 0 i mniejszy niż 1. Wynikowa cena zostanie zaokrąglona do najbliższej jednostki podlegającej rozliczeniu (np. centy w przypadku dolarów amerykańskich). Względny rabat jest uznawany za nieprawidłowy, jeśli obniżona cena będzie niższa niż cena minimalna dozwolona w tym regionie.

object (Money)

Bezwzględna kwota pieniędzy odjęta od ceny abonamentu podstawowego proporcjonalnie do czasu trwania, który użytkownik płaci w ramach tego etapu oferty. Jeśli na przykład cena abonamentu podstawowego w tym regionie wynosi 12 USD przez 1 rok, to rabat bezwzględny w wysokości 1 USD za 3 miesiące odpowiada cenie 2 USD. Cena nie może być niższa od minimalnej ceny dozwolonej w tym regionie.

object (RegionalSubscriptionOfferPhaseFreePriceOverride)

Ustaw, aby wskazać, że tę ofertę można uzyskać bezpłatnie.

{

  // Union field price_override can be only one of the following:
  "otherRegionsPrices": {
    object (OtherRegionsSubscriptionOfferPhasePrices)
  },
  "relativeDiscount": number,
  "absoluteDiscounts": {
    object (OtherRegionsSubscriptionOfferPhasePrices)
  },
  "free": {
    object (OtherRegionsSubscriptionOfferPhaseFreePriceOverride)
  }
  // End of list of possible types for union field price_override.
}

object (OtherRegionsSubscriptionOfferPhasePrices)

Bezwzględna cena, jaką użytkownik płaci w ramach tego etapu oferty. Cena nie może być niższa od ceny minimalnej dozwolonej we wszystkich nowych lokalizacjach, w których może być wprowadzana Google Play.

number

Część ceny abonamentu podstawowego proporcjonalna do czasu trwania etapu, który użytkownik płaci za ten etap oferty. Jeśli na przykład cena abonamentu podstawowego w tym regionie wynosi 12 USD przez 1 rok, to 50% zniżki za fazę trwającego 3 miesiące odpowiada cenie 1, 50 USD. Rabat musi być określony jako ułamek większy od 0 i mniejszy niż 1. Wynikowa cena zostanie zaokrąglona do najbliższej jednostki podlegającej rozliczeniu (np. centy w przypadku dolarów amerykańskich). Względny rabat jest uznawany za nieprawidłowy, jeśli obniżona cena będzie niższa od ceny minimalnej dozwolonej w jakiejkolwiek nowej lokalizacji, w której może pojawić się Google Play.

object (OtherRegionsSubscriptionOfferPhasePrices)

Bezwzględna kwota pieniędzy odjęta od ceny abonamentu podstawowego proporcjonalnie do czasu trwania, który użytkownik płaci w ramach tego etapu oferty. Jeśli na przykład cena abonamentu podstawowego w tym regionie wynosi 12 USD przez 1 rok, to rabat bezwzględny w wysokości 1 USD za 3 miesiące odpowiada cenie 2 USD. Otrzymana cena nie może być niższa od ceny minimalnej dozwolonej we wszystkich nowych lokalizacjach, w których Google Play może wprowadzić aplikację.

object (OtherRegionsSubscriptionOfferPhaseFreePriceOverride)

Ustaw, aby wskazać, że tę ofertę można uzyskać bezpłatnie.

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

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.

{

  // Union field rule can be only one of the following:
  "acquisitionRule": {
    object (AcquisitionTargetingRule)
  },
  "upgradeRule": {
    object (UpgradeTargetingRule)
  }
  // End of list of possible types for union field rule.
}

object (AcquisitionTargetingRule)

Reguła kierowania oferty na pozyskiwanie nowych użytkowników.

object (UpgradeTargetingRule)

Reguła kierowania oferty dotycząca przejścia na wyższą wersję dotychczasowych abonamentów.

{
  "scope": {
    object (TargetingRuleScope)
  }
}

object (TargetingRuleScope)

Wymagane. Zakres subskrypcji uwzględnianych przez tę regułę. Zezwala tylko na „tę subskrypcję” i „dowolna subskrypcja w aplikacji”.

{

  // Union field scope can be only one of the following:
  "thisSubscription": {
    object (TargetingRuleScopeThisSubscription)
  },
  "anySubscriptionInApp": {
    object (TargetingRuleScopeAnySubscriptionInApp)
  },
  "specificSubscriptionInApp": string
  // End of list of possible types for union field scope.
}

object (TargetingRuleScopeThisSubscription)

Zakres bieżącej reguły kierowania to subskrypcja, w której zdefiniowano tę ofertę.

object (TargetingRuleScopeAnySubscriptionInApp)

Zakres bieżącej reguły kierowania to dowolna subskrypcja w aplikacji nadrzędnej.

string

Zakres bieżącej reguły kierowania to subskrypcja o określonym identyfikatorze. Musi to być subskrypcja w tej samej aplikacji nadrzędnej.

{
  "oncePerUser": boolean,
  "scope": {
    object (TargetingRuleScope)
  },
  "billingPeriodDuration": string
}

boolean

Ogranicz tę ofertę do jednego na użytkownika. Jeśli ma wartość Prawda, użytkownik nigdy nie będzie mógł skorzystać z tej oferty, jeśli kiedykolwiek ją zasubskrybował.

object (TargetingRuleScope)

Wymagane. Zakres subskrypcji uwzględnianych przez tę regułę. Zezwala tylko na „tę subskrypcję” i „konkretna subskrypcja w aplikacji”.

string

Konkretny okres rozliczeniowy podany w formacie ISO 8601, który użytkownik musi obecnie subskrybować, aby kwalifikować się do zastosowania tej reguły. Jeśli nie określono okresu rozliczeniowego, użytkownicy, którzy zasubskrybowali dowolny okres rozliczeniowy, będą dopasowywani.

{
  "regionCode": string,
  "newSubscriberAvailability": boolean
}

string

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

boolean

Określa, czy oferta subskrypcji w danym regionie jest dostępna dla nowych subskrybentów. Jeśli ta wartość ma wartość Fałsz, obecni subskrybenci nie zostaną anulowane. Jeśli nie podasz żadnej wartości, domyślnie zostanie użyta wartość false (fałsz).

{
  "otherRegionsNewSubscriberAvailability": boolean
}

boolean

Informacja o tym, czy oferta subskrypcji w nowych lokalizacjach może zostać udostępniona w przyszłości w Google Play. Jeśli nie podasz żadnej wartości, domyślnie zostanie użyta wartość false (fałsz).