REST Resource: monetization.subscriptions.basePlans.offers

Zasób: SubscriptionOffer

pojedyncza tymczasowa oferta;

Zapis JSON 
{
  "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)
    }
  ]
}
Pola
packageName

string

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

string

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

string

Wymagane. Niezmienna. Identyfikator abonamentu podstawowego, do którego ta oferta jest rozszerzeniem.
offerId

string

Wymagane. Niezmienna. Unikalny identyfikator tej oferty subskrypcji. Musi być niepowtarzalna w ramach abonamentu podstawowego.
state

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.
phases[]

object (SubscriptionOfferPhase)

Wymagane. Etapy tej oferty subskrypcji. Musi zawierać od jednej do dwóch pozycji. Użytkownicy zawsze będą otrzymywać wszystkie te etapy w określonej kolejności.
targeting

object (SubscriptionOfferTargeting)

Wymagania, które użytkownicy muszą spełnić, aby kwalifikować się do skorzystania z tej oferty. Reprezentuje wymagania, które Google Play będzie oceniać, aby zdecydować, czy oferta powinna zostać zwrócona. Deweloperzy mogą samodzielnie filtrować te oferty.
regionalConfigs[]

object (RegionalSubscriptionOfferConfig)

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

object (OtherRegionsSubscriptionOfferConfig)

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

object (OfferTag)

Lista do 20 tagów niestandardowych określonych dla tej oferty i zwróconych do aplikacji za pomocą biblioteki rozliczeniowej.

Stan

Obecny stan oferty subskrypcji.

Wartości w polu enum
STATE_UNSPECIFIED Wartość domyślna, której nigdy nie należy używać.
DRAFT Oferta subskrypcji nie jest i nigdy nie była dostępna dla użytkowników.
ACTIVE Oferta subskrypcji jest dostępna dla nowych i obecnych użytkowników.
INACTIVE Oferta subskrypcji nie jest dostępna dla nowych użytkowników. Dostęp do usługi nie zostanie utracony przez dotychczasowych użytkowników.

SubscriptionOfferPhase

Pojedyncza faza oferty subskrypcji.

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

integer

Wymagane. Liczba powtórzeń tej fazy. Jeśli ta faza oferty nie jest bezpłatna, za każde odnowienie użytkownikowi zostanie naliczona cena tej fazy oferty.
duration

string

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

object (RegionalSubscriptionOfferPhaseConfig)

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

object (OtherRegionsSubscriptionOfferPhaseConfig)

Informacje o cenach we wszystkich nowych lokalizacjach, w których może zostać uruchomiona usługa Google Play.

RegionalSubscriptionOfferPhaseConfig

Konfiguracja dla pojedynczego etapu oferty subskrypcji w 1 regionie.

Zapis JSON 
{
  "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.
}
Pola
regionCode

string

Wymagane. Stała. Region, do którego ma zastosowanie ta konfiguracja.
Pole sumy price_override. Cena zastępcza dla tej fazy. Wymagane. price_override może być tylko jednym z tych elementów:
price

object (Money)

Cena bezwzględna, jaką użytkownik płaci w ramach tego etapu oferty. Cena nie może być niższa niż minimalna cena dozwolona w danym regionie.
relativeDiscount

number

Ułamek ceny abonamentu podstawowego proporcjonalnie do czasu trwania etapu, za który użytkownik płaci. Jeśli na przykład cena abonamentu podstawowego w tym regionie wynosi 12 PLN za 1 rok, zniżka w wysokości 50% na okres 3 miesięcy odpowiadałaby cenie 1,50 PLN. Rabat musi być określony jako ułamek większy od 0 i mniejszy niż 1. Otrzymana cena zostanie zaokrąglona do najbliższej jednostki podlegającej rozliczeniu (np. centy w przypadku dolarów amerykańskich). Rabat względny jest uznawany za nieprawidłowy, jeśli cena po rabacie jest mniejsza niż minimalna cena dozwolona w danym regionie.
absoluteDiscount

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 niż minimalna cena dozwolona w danym regionie.
free

object (RegionalSubscriptionOfferPhaseFreePriceOverride)

Ustaw, aby określić, że ta oferta jest bezpłatna.

RegionalSubscriptionOfferPhaseFreePriceOverride

Ten typ nie ma pól.

Przedstawia konfigurację bezpłatnego zastąpienia ceny dla pojedynczego etapu oferty subskrypcji

OtherRegionsSubscriptionOfferPhaseConfig

Konfiguracja dla wszystkich nowych lokalizacji, w których Google Play może wprowadzić w ramach pojedynczej oferty.

Zapis JSON 
{

  // 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.
}
Pola
Pole sumy price_override. Cena zastępcza dla tej fazy. Wymagane. price_override może być tylko jednym z tych elementów:
otherRegionsPrices

object (OtherRegionsSubscriptionOfferPhasePrices)

Cena bezwzględna, 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.
relativeDiscount

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 PLN za 1 rok, zniżka w wysokości 50% na okres 3 miesięcy odpowiadałaby cenie 1,50 PLN. Rabat musi być podany jako ułamek większy od 0 i mniejszy od 1. Otrzymana cena zostanie zaokrąglona do najbliższej jednostki podlegającej rozliczeniu (np. centy w przypadku dolarów amerykańskich). Rabat względny jest uważany za nieprawidłowy, jeśli cena po rabacie jest mniejsza niż minimalna dozwolona cena w dowolnych nowych lokalizacjach, w których usługa Google Play może zostać uruchomiona.
absoluteDiscounts

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. Wynikająca z tego cena nie może być niższa niż minimalna cena dozwolona w przypadku nowych lokalizacji, w których usługa Google Play może być dostępna.
free

object (OtherRegionsSubscriptionOfferPhaseFreePriceOverride)

Ustaw, aby określić, że ta oferta jest bezpłatna.

OtherRegionsSubscriptionOfferPhasePrices

informacje o cenach w przypadku nowych lokalizacji, w których usługa Google Play może być dostępna;

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

object (Money)

Wymagane. Cena w USD do użycia w przypadku nowych lokalizacji, w których usługa Google Play może zostać uruchomiona.
eurPrice

object (Money)

Wymagane. Cena w EUR do użycia w przypadku nowych lokalizacji, w których usługa Google Play może zostać uruchomiona.

OtherRegionsSubscriptionOfferPhaseFreePriceOverride

Ten typ nie ma pól.

Reprezentuje konfigurację zastąpienia ceny bezpłatnej dla nowych lokalizacji, które Google Play może wprowadzić w ramach pojedynczej fazy oferty.

SubscriptionOfferTargeting

Określa regułę, którą musi spełnić użytkownik, by otrzymać tę ofertę.

Zapis JSON 
{

  // 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.
}
Pola
Pole sumy rule. Aby skorzystać z oferty określonej przez dewelopera, pozostaw to pole puste. rule może być tylko jednym z tych elementów:
acquisitionRule

object (AcquisitionTargetingRule)

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

object (UpgradeTargetingRule)

Reguła kierowania oferty na użytkowników, którzy przechodzą na wyższy abonament.

AcquisitionTargetingRule

Reprezentuje regułę kierowania taką jak: użytkownik nigdy nie miał zakresu {scope}.

Zapis JSON 
{
  "scope": {
    object (TargetingRuleScope)
  }
}
Pola
scope

object (TargetingRuleScope)

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

TargetingRuleScope

Określa zakres subskrypcji, które reguła kierowania może dopasować, aby kierować oferty do użytkowników na podstawie wcześniejszych lub obecnych uprawnień.

Zapis JSON 
{

  // 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.
}
Pola

Pole sumy scope.

scope może być tylko jednym z tych elementów:
thisSubscription

object (TargetingRuleScopeThisSubscription)

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

object (TargetingRuleScopeAnySubscriptionInApp)

Zakres bieżącej reguły kierowania obejmuje wszystkie subskrypcje w aplikacji nadrzędnej.
specificSubscriptionInApp

string

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

TargetingRuleScopeThisSubscription

Ten typ nie zawiera pól.

Określa zakres reguły kierowania odpowiadający subskrypcjom, w których zdefiniowano tę ofertę.

TargetingRuleScopeAnySubscriptionInApp

Ten typ nie ma pól.

Reprezentuje zakres reguły kierowania odpowiadający dowolnej subskrypcji w aplikacji nadrzędnej.

UpgradeTargetingRule

Reprezentuje regułę kierowania o tym kształcie: użytkownik ma obecnie {scope} [z okresem rozliczeniowym {billing_period}].

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

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ł.
scope

object (TargetingRuleScope)

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

string

Okres rozliczeniowy określony w formacie ISO 8601, na który użytkownik musi mieć obecnie subskrypcję, aby kwalifikować się do skorzystania z tej reguły. Jeśli nie określono okresu rozliczeniowego, użytkownicy, którzy subskrybują dowolny okres rozliczeniowy, będą dopasowywani.

RegionalSubscriptionOfferConfig

Konfiguracja oferty subskrypcji w 1 regionie.

Zapis JSON 
{
  "regionCode": string,
  "newSubscriberAvailability": boolean
}
Pola
regionCode

string

Wymagane. Stała. Kod regionu, którego dotyczy ta konfiguracja, zgodnie ze standardem ISO 3166-2, np. „US”.
newSubscriberAvailability

boolean

Określa, czy oferta subskrypcji w określonym regionie jest dostępna dla nowych subskrybentów. Jeśli ta wartość zostanie ustawiona na „false”, subskrypcje obecnych subskrybentów nie zostaną anulowane. Jeśli nie podasz żadnej wartości, domyślnie zostanie użyta wartość false (fałsz).

OtherRegionsSubscriptionOfferConfig

Konfiguracja nowych lokalizacji, w których Google Play może być dostępna, zgodnie z określoną ofertą subskrypcji.

Zapis JSON 
{
  "otherRegionsNewSubscriberAvailability": boolean
}
Pola
otherRegionsNewSubscriberAvailability

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).

Metody

activate

 Aktywuje ofertę subskrypcji.

batchGet

 Odczytuje co najmniej 1 ofertę subskrypcji.

batchUpdate

 Aktualizuje grupę ofert subskrypcji.

batchUpdateStates

 Aktualizuje grupę stanów ofert subskrypcji.

create

 Tworzy nową ofertę subskrypcji.

deactivate

 Dezaktywuje ofertę subskrypcji.

delete

 usuwa ofertę subskrypcji.

get

 Odczytuje jedną ofertę

list

 Wyświetla listę wszystkich ofert w ramach danej subskrypcji.

patch

 Aktualizuje istniejącą ofertę subskrypcji.