- Zasób: SubscriptionOffer
- Stan
- SubscriptionOfferPhase
- RegionalSubscriptionOfferPhaseConfig
- OtherRegionsSubscriptionOfferPhaseConfig
- OtherRegionsSubscriptionOfferPhasePrices
- SubscriptionOfferTargeting
- AcquisitionTargetingRule.
- TargetingRuleScope
- TargetingRuleScopeThisSubscription
- TargetingRuleScopeAnySubscriptionInApp
- UpgradeTargetingRule
- RegionalSubscriptionOfferConfig
- OtherRegionsSubscriptionOfferConfig
- Metody
Zasób: SubscriptionOffer
Pojedyncza, tymczasowa oferta
Zapis JSON |
---|
{ "packageName": string, "productId": string, "basePlanId": string, "offerId": string, "state": enum ( |
Pola | |
---|---|
packageName |
To pole jest wymagane. Stałe. Nazwa pakietu aplikacji, do której należy subskrypcja nadrzędna. |
productId |
To pole jest wymagane. Stałe. Identyfikator subskrypcji nadrzędnej, do której należy ta oferta. |
basePlanId |
To pole jest wymagane. Stałe. Identyfikator abonamentu podstawowego, do którego przedłużenia jest ta oferta. |
offerId |
To pole jest wymagane. Stałe. Unikalny identyfikator tej oferty subskrypcji. Musi być niepowtarzalna w ramach abonamentu podstawowego. |
state |
Tylko dane wyjściowe. Obecny stan tej oferty. Można je zmienić za pomocą działań Aktywuj i Dezaktywuj. Uwaga: stan abonamentu podstawowego zastępuje ten stan, więc aktywna oferta może być niedostępna, jeśli abonament podstawowy jest nieaktywny. |
phases[] |
To pole jest wymagane. Etapy tej oferty subskrypcji. Musi zawierać co najmniej 1 wpis, ale nie może przekraczać 5. Użytkownicy zawsze będą otrzymywać wszystkie te etapy w określonej kolejności. Po utworzeniu etapów nie można ich dodać, usunąć ani zmienić ich kolejności. |
targeting |
Wymagania, które muszą spełnić użytkownicy, aby kwalifikować się do tej oferty. Reprezentuje wymagania, które Google Play oceni, aby zdecydować, czy oferta powinna zostać zwrócona. Deweloperzy mogą samodzielnie filtrować te oferty. |
regionalConfigs[] |
To pole jest wymagane. Konfiguracja tej oferty zależna od regionu. Musi zawierać co najmniej 1 wpis. |
otherRegionsConfig |
Konfigurowanie nowych lokalizacji w Google Play może zostać wprowadzone w przyszłości. |
offerTags[] |
Lista maksymalnie 20 tagów niestandardowych określonych dla tej oferty, które są zwracane do aplikacji za pomocą biblioteki płatności. |
Stan
Obecny stan oferty subskrypcji.
Wartości w polu enum | |
---|---|
STATE_UNSPECIFIED |
Wartość domyślna nie powinna być nigdy używana. |
DRAFT |
Oferta subskrypcji nie była 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. Istniejący użytkownicy zachowają do niej dostęp. |
SubscriptionOfferPhase
Jeden etap oferty subskrypcji.
Zapis JSON |
---|
{ "recurrenceCount": integer, "duration": string, "regionalConfigs": [ { object ( |
Pola | |
---|---|
recurrenceCount |
To pole jest wymagane. Liczba powtórzeń tej fazy. Jeśli ten etap oferty nie jest bezpłatny, za każdym razem, gdy cykliczne płatności będą pobierane, użytkownik będzie obciążany ceną tego etapu oferty. |
duration |
To pole jest wymagane. Czas trwania pojedynczego powtarzania tego etapu. Podany w formacie ISO 8601. |
regionalConfigs[] |
To pole jest wymagane. Zależna od regionu konfiguracja tego etapu oferty. Ta lista musi zawierać dokładnie 1 wpis w każdym regionie, dla którego oferta subskrypcji ma konfigurację regionalną. |
otherRegionsConfig |
Informacje o cenach dla nowych lokalizacji, w których Google Play może wprowadzić usługę. |
RegionalSubscriptionOfferPhaseConfig
Konfiguracja pojedynczego etapu oferty subskrypcji w jednym regionie.
Zapis JSON |
---|
{ "regionCode": string, // Union field |
Pola | |
---|---|
regionCode |
To pole jest wymagane. Stałe. Region, do którego ma zastosowanie ta konfiguracja. |
Pole sumy price_override . Zastąpienie ceny na tym etapie. To pole jest wymagane. price_override może być tylko jedną z tych wartości: |
|
price |
Cena bezwzględna, jaką płaci użytkownik na tym etapie oferty. Cena nie może być niższa niż minimalna cena dozwolona w tym regionie. |
relativeDiscount |
Odsetek ceny abonamentu podstawowego obliczony proporcjonalnie do czasu trwania tego etapu, który użytkownik opłaca w tym okresie oferty. Jeśli na przykład cena abonamentu podstawowego w tym regionie wynosi 12 USD przez okres 1 roku, rabat w wysokości 50% na etapie 3 miesięcy będzie odpowiadać cenie 1, 50 USD. Rabat musi być określony jako ułamek ściśle większy od 0 i ściśle mniejszy niż 1. Wynikowa cena zostanie zaokrąglona do najbliższej jednostki podlegającej rozliczeniu (np. grosza za PLN). Rabat względny jest uznawany za nieprawidłowy, jeśli obniżona cena okaże się mniejsza niż cena minimalna dozwolona w tym regionie. |
absoluteDiscount |
Bezwzględna kwota odejmowana od ceny abonamentu podstawowego, proporcjonalna do czasu, jaki użytkownik płaci w ramach tego etapu oferty. Jeśli na przykład cena abonamentu podstawowego w tym regionie wynosi 12 USD przez okres 1 roku, rabat bezwzględny w wysokości 1 USD w fazie 3 miesięcy będzie odpowiadać cenie 2 USD. Ostateczna cena nie może być niższa od ceny minimalnej dozwolonej w tym regionie. |
free |
Określ, czy ta oferta jest dostępna bezpłatnie. |
OtherRegionsSubscriptionOfferPhaseConfig
Konfigurowanie nowych lokalizacji, w których Google Play może wprowadzić w ramach pojedynczego etapu oferty.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy price_override . Zastąpienie ceny na tym etapie. To pole jest wymagane. price_override może być tylko jedną z tych wartości: |
|
otherRegionsPrices |
Cena bezwzględna, jaką płaci użytkownik na tym etapie oferty. Cena nie może być niższa niż minimalna dozwolona cena w każdej nowej lokalizacji, w której Google Play może wprowadzić aplikację na rynek. |
relativeDiscount |
Odsetek ceny abonamentu podstawowego obliczony proporcjonalnie do czasu trwania tego etapu, który użytkownik opłaca w tym okresie oferty. Jeśli na przykład cena abonamentu podstawowego w tym regionie wynosi 12 USD przez okres 1 roku, rabat w wysokości 50% na etapie 3 miesięcy będzie odpowiadać cenie 1, 50 USD. Rabat musi być określony jako ułamek ściśle większy od 0 i ściśle mniejszy niż 1. Wynikowa cena zostanie zaokrąglona do najbliższej jednostki podlegającej rozliczeniu (np. grosza za PLN). Rabat względny jest uznawany za nieważny, jeśli obniżona cena okaże się niższa od ceny minimalnej w dowolnej nowej lokalizacji, w której Google Play może udostępnić aplikację. |
absoluteDiscounts |
Bezwzględna kwota odejmowana od ceny abonamentu podstawowego, proporcjonalna do czasu, jaki użytkownik płaci w ramach tego etapu oferty. Jeśli na przykład cena abonamentu podstawowego w tym regionie wynosi 12 USD przez okres 1 roku, rabat bezwzględny w wysokości 1 USD w fazie 3 miesięcy będzie odpowiadać cenie 2 USD. Ostateczna cena nie może być niższa od ceny minimalnej dozwolonej w przypadku nowych lokalizacji, w których Google Play może wprowadzić aplikację. |
free |
Określ, czy ta oferta jest dostępna bezpłatnie. |
OtherRegionsSubscriptionOfferPhasePrices
Informacje o cenach dla nowych lokalizacji, w których Google Play może wprowadzić usługę.
Zapis JSON |
---|
{ "usdPrice": { object ( |
Pola | |
---|---|
usdPrice |
To pole jest wymagane. Cena w USD przeznaczona do użycia w nowych lokalizacjach, w których Google Play może wprowadzić swoją ofertę. |
eurPrice |
To pole jest wymagane. Cena w euro do wykorzystania w nowych lokalizacjach, w których Google Play może wprowadzić usługę. |
SubscriptionOfferTargeting
Określa regułę, którą musi spełnić użytkownik, aby otrzymać tę ofertę.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy rule . Aby skorzystać z oferty określonej przez dewelopera, pozostaw to pole puste. rule może być tylko jedną z tych wartości: |
|
acquisitionRule |
Reguła kierowania oferty na pozyskiwanie nowych użytkowników. |
upgradeRule |
Reguła kierowania oferty dotycząca przejścia na wyższą wersję istniejących abonamentów użytkowników. |
AcquisitionTargetingRule
Reprezentuje regułę kierowania w formacie: użytkownik nigdy wcześniej nie miał zakresu {scope}.
Zapis JSON |
---|
{
"scope": {
object ( |
Pola | |
---|---|
scope |
To pole jest wymagane. Zakres subskrypcji uwzględnianych przez tę regułę. Zezwala tylko na „tę subskrypcję” i „dowolną subskrypcję w aplikacji”. |
TargetingRuleScope
Określa zakres subskrypcji, który reguła kierowania może dopasować, aby kierować oferty na użytkowników na podstawie wcześniejszych lub obecnych uprawnień.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy
|
|
thisSubscription |
Zakres bieżącej reguły kierowania to subskrypcja, w której zdefiniowano tę ofertę. |
anySubscriptionInApp |
Zakres bieżącej reguły kierowania to dowolna subskrypcja w aplikacji nadrzędnej. |
specificSubscriptionInApp |
Zakres bieżącej reguły kierowania to subskrypcja o określonym identyfikatorze subskrypcji. Musi to być subskrypcja w tej samej aplikacji nadrzędnej. |
TargetingRuleScopeThisSubscription
Ten typ nie ma żadnych pól.
Reprezentuje zakres reguły kierowania odpowiadający subskrypcjom, w których zdefiniowano tę ofertę.
TargetingRuleScopeAnySubscriptionInApp
Ten typ nie ma żadnych pól.
Reprezentuje zakres reguły kierowania odpowiadający dowolnej subskrypcji w aplikacji nadrzędnej.
UpgradeTargetingRule
Reprezentuje regułę kierowania w formacie: użytkownik ma obecnie {scope} [z okresem rozliczeniowym {billing_period}].
Zapis JSON |
---|
{
"oncePerUser": boolean,
"scope": {
object ( |
Pola | |
---|---|
oncePerUser |
Ogranicz tę ofertę do jednego użytkownika. Jeśli zasada ma wartość Prawda, użytkownik, który kiedykolwiek skorzystał z tej oferty, nie będzie mógł ponownie skorzystać z tej oferty. |
scope |
To pole jest wymagane. Zakres subskrypcji uwzględnianych przez tę regułę. Zezwala tylko na „tę subskrypcję” i „konkretną subskrypcję w aplikacji”. |
billingPeriodDuration |
Określony czas trwania okresu rozliczeniowego podany w formacie ISO 8601, który użytkownik musi mieć w danym momencie subskrypcji, aby kwalifikować się do zastosowania tej reguły. Jeśli go nie podasz, uwzględnimy użytkowników, którzy subskrybują dowolny okres rozliczeniowy. |
RegionalSubscriptionOfferConfig
Konfiguracja oferty subskrypcji w jednym regionie.
Zapis JSON |
---|
{ "regionCode": string, "newSubscriberAvailability": boolean } |
Pola | |
---|---|
regionCode |
To pole jest wymagane. Stałe. Kod regionu, do którego odnosi się ta konfiguracja, zgodnie z normą ISO 3166-2, np. „US”. |
newSubscriberAvailability |
Określa, czy oferta subskrypcji w wybranym regionie jest dostępna dla nowych subskrybentów. Jeśli ta wartość jest ustawiona na false, subskrypcja obecnych subskrybentów nie zostanie anulowana. Jeśli nie podasz żadnej wartości, domyślnie zostanie użyta wartość false (fałsz). |
OtherRegionsSubscriptionOfferConfig
Konfigurację nowych lokalizacji, które Google Play może wprowadzić w określonych warunkach subskrypcji.
Zapis JSON |
---|
{ "otherRegionsNewSubscriberAvailability": boolean } |
Pola | |
---|---|
otherRegionsNewSubscriberAvailability |
Czy oferta subskrypcji w jakichkolwiek nowych lokalizacjach może zostać wprowadzona w przyszłości. Jeśli nie podasz żadnej wartości, domyślnie zostanie użyta wartość false (fałsz). |
Metody |
|
---|---|
|
Aktywuje ofertę subskrypcji. |
|
Odczytuje co najmniej 1 ofertę subskrypcji. |
|
Aktualizuje grupę ofert subskrypcji. |
|
Aktualizuje grupę stanów oferty subskrypcji. |
|
Tworzy nową ofertę subskrypcji. |
|
Dezaktywuje ofertę subskrypcji. |
|
Usuwa ofertę subskrypcji. |
|
Czyta 1 ofertę |
|
Wyświetla listę wszystkich ofert w ramach danej subskrypcji. |
|
Aktualizuje istniejącą ofertę subskrypcji. |