- Zasób: SubscriptionPurchaseV2
- SubscriptionState
- PausedStateContext
- CanceledStateContext
- UserInitiatedCancellation
- CancelSurveyResult
- CancelSurveyReason
- SystemInitiatedCancellation
- DeveloperInitiatedCancellation
- ReplacementCancellation
- TestPurchase
- AcknowledgementState
- ExternalAccountIdentifiers
- SubscribeWithGoogleInfo
- SubscriptionPurchaseLineItem
- AutoRenewingPlan
- SubscriptionItemPriceChangeDetails
- PriceChangeMode
- PriceChangeState
- InstallmentPlan
- PendingCancellation
- PrepaidPlan
- OfferDetails
- DeferredItemReplacement
- SignupPromotion
- OneTimeCode
- VanityCode
- Metody
Zasób: SubscriptionPurchaseV2
Wskazuje stan zakupu subskrypcji przez użytkownika.
Zapis JSON |
---|
{ "kind": string, "regionCode": string, "lineItems": [ { object ( |
Pola | |
---|---|
kind |
Ten typ reprezentuje obiekt SubscriptionPurchaseV2 w usłudze androidpublisher. |
region |
Kod kraju lub regionu w formacie ISO 3166-1 alfa-2, który użytkownik podał w momencie przyznania subskrypcji. |
line |
Informacje na poziomie produktu dotyczące zakupu subskrypcji. Produkty w ramach tego samego zakupu powinny mieć albo AutoRenewingPlan, albo PrepaidPlan. |
start |
Czas przyznania subskrypcji. Nie ustawione w przypadku oczekujących subskrypcji (subskrypcja została utworzona, ale podczas rejestracji oczekuje na płatność). Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: |
subscription |
bieżący stan subskrypcji. |
latest |
Identyfikator ostatniego zamówienia powiązanego z zakupem subskrypcji. W przypadku subskrypcji z automatycznym odnawianiem jest to identyfikator zamówienia rejestracyjnego, jeśli nie zostało jeszcze odnowione, lub identyfikator ostatniego zamówienia cyklicznego (udane, oczekujące lub odrzucone). W przypadku subskrypcji przedpłaconej jest to identyfikator zamówienia powiązany z zapytanym tokenem zakupu. |
linked |
Token zakupu starej subskrypcji, jeśli jest to jedna z tych subskrypcji: * ponowna rejestracja anulowanej, ale nie wygasłej subskrypcji; * przejście na wyższą lub niższą wersję poprzedniej subskrypcji. * Przejście z abonamentu przedpłaconego na abonament automatycznie odnawiany. * Przekształcanie subskrypcji z automatycznym odnawianiem w subskrypcję przedpłaconą. * Przedłużenie abonamentu przedpłaconego. |
paused |
Dodatkowe informacje o wstrzymanych subskrypcjach. Widoczny tylko wtedy, gdy subskrypcja ma obecnie stan subscriptionState SUBSCRIPTION_STATE_PAUSED. |
canceled |
Dodatkowy kontekst dotyczący anulowanych subskrypcji. Widoczny tylko wtedy, gdy subskrypcja ma obecnie stan subscriptionState SUBSCRIPTION_STATE_CANCELED lub SUBSCRIPTION_STATE_EXPIRED. |
test |
Wyświetla się tylko wtedy, gdy zakup subskrypcji jest zakupem testowym. |
acknowledgement |
Stan potwierdzenia subskrypcji. |
external |
Identyfikator konta użytkownika w usłudze zewnętrznej. |
subscribe |
Profil użytkownika powiązany z zakupami dokonanymi za pomocą funkcji „Subskrybuj z Google”. |
SubscriptionState
Stany, w których może się znajdować subskrypcja, np. czy jest aktywna czy anulowana. Produkty w ramach zakupu subskrypcji mogą być abonamentami odnawianymi automatycznie lub przedpłaconymi.
Wartości w polu enum | |
---|---|
SUBSCRIPTION_STATE_UNSPECIFIED |
Nieokreślony stan subskrypcji. |
SUBSCRIPTION_STATE_PENDING |
Subskrypcja została utworzona, ale podczas rejestracji nie dokonano płatności. W tym stanie wszystkie pozycje oczekują na płatność. |
SUBSCRIPTION_STATE_ACTIVE |
Subskrypcja jest aktywna. – (1) Jeśli subskrypcja jest abonamentem automatycznie odnawianym, co najmniej 1 element ma włączone automatyczne odnawianie i nie wygasł. – (2) Jeśli subskrypcja jest abonamentem przedpłaconym, co najmniej 1 element nie wygasł. |
SUBSCRIPTION_STATE_PAUSED |
Subskrypcja jest wstrzymana. Stan jest dostępny tylko wtedy, gdy subskrypcja jest abonamentem z automatycznym odnawianiem. W tym stanie wszystkie elementy są wstrzymane. |
SUBSCRIPTION_STATE_IN_GRACE_PERIOD |
Subskrypcja jest w okresie prolongaty. Stan jest dostępny tylko wtedy, gdy subskrypcja jest abonamentem z automatycznym odnawianiem. W tym stanie wszystkie elementy są w okresie przejściowym. |
SUBSCRIPTION_STATE_ON_HOLD |
Subskrypcja jest wstrzymana (zawieszona). Stan jest dostępny tylko wtedy, gdy subskrypcja jest abonamentem z automatycznym odnawianiem. W tym stanie wszystkie elementy są wstrzymane. |
SUBSCRIPTION_STATE_CANCELED |
Subskrypcja została anulowana, ale jeszcze nie wygasła. Stan jest dostępny tylko wtedy, gdy subskrypcja jest abonamentem z automatycznym odnawianiem. W przypadku wszystkich elementów wartość autoRenewEnabled jest ustawiona na „fałsz”. |
SUBSCRIPTION_STATE_EXPIRED |
Subskrypcja wygasła. Wszystkie elementy mają wartość expiryTime w przeszłości. |
SUBSCRIPTION_STATE_PENDING_PURCHASE_CANCELED |
Oczekująca transakcja dotycząca subskrypcji została anulowana. Jeśli oczekujący zakup dotyczył istniejącej subskrypcji, użyj parametru linkedPurchaseToken, aby poznać bieżący stan tej subskrypcji. |
PausedStateContext
Informacje dotyczące subskrypcji w stanie wstrzymania.
Zapis JSON |
---|
{ "autoResumeTime": string } |
Pola | |
---|---|
auto |
Czas, w którym subskrypcja zostanie automatycznie wznowiona. Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: |
CanceledStateContext
Informacje dotyczące subskrypcji w stanie SUBSCRIPTION_STATE_CANCELLED lub SUBSCRIPTION_STATE_EXPIRED.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole unii cancellation_reason . Powód anulowania subskrypcji. cancellation_reason może być tylko jednym z tych elementów: |
|
user |
Użytkownik anulował subskrypcję. |
system |
Subskrypcja została anulowana przez system, na przykład z powodu problemu z płatnościami. |
developer |
Subskrypcja została anulowana przez dewelopera. |
replacement |
Subskrypcja została zastąpiona nową subskrypcją. |
UserInitiatedCancellation
Informacje dotyczące anulowania przez użytkowników.
Zapis JSON |
---|
{
"cancelSurveyResult": {
object ( |
Pola | |
---|---|
cancel |
informacje podane przez użytkownika podczas anulowania subskrypcji (ankieta dotycząca powodu anulowania); |
cancel |
Czas anulowania subskrypcji przez użytkownika. Użytkownik może nadal mieć dostęp do subskrypcji po upływie tego czasu. Użyj elementu lineItems.expiry_time, aby określić, czy użytkownik nadal ma dostęp. Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: |
CancelSurveyResult
Wynik ankiety anulowania, gdy subskrypcja została anulowana przez użytkownika.
Zapis JSON |
---|
{
"reason": enum ( |
Pola | |
---|---|
reason |
powód wybrany przez użytkownika w ankiecie dotyczącej anulowania. |
reason |
Ustawiane tylko w przypadku CANCEL_SURVEY_REASON_OTHERS. To odpowiedź użytkownika na ankietę. |
CancelSurveyReason
powód wybrany przez użytkownika w ankiecie dotyczącej anulowania.
Wartości w polu enum | |
---|---|
CANCEL_SURVEY_REASON_UNSPECIFIED |
Nieokreślony powód anulowania ankiety. |
CANCEL_SURVEY_REASON_NOT_ENOUGH_USAGE |
Niewystarczające korzystanie z subskrypcji. |
CANCEL_SURVEY_REASON_TECHNICAL_ISSUES |
problemy techniczne podczas korzystania z aplikacji, |
CANCEL_SURVEY_REASON_COST_RELATED |
Problemy związane z kosztami. |
CANCEL_SURVEY_REASON_FOUND_BETTER_APP |
Użytkownik znalazł lepszą aplikację. |
CANCEL_SURVEY_REASON_OTHERS |
inne powody. |
SystemInitiatedCancellation
Ten typ nie ma pól.
Informacje dotyczące anulowań zainicjowanych przez system Google.
DeveloperInitiatedCancellation
Ten typ nie ma pól.
Informacje dotyczące anulowań zainicjowanych przez deweloperów.
ReplacementCancellation
Ten typ nie ma pól.
Informacje dotyczące anulowań spowodowanych wymianą subskrypcji.
TestPurchase
Ten typ nie ma pól.
Określa, czy zakup subskrypcji jest zakupem testowym.
AcknowledgementState
Możliwe stany potwierdzenia subskrypcji.
Wartości w polu enum | |
---|---|
ACKNOWLEDGEMENT_STATE_UNSPECIFIED |
Nieokreślony stan potwierdzenia. |
ACKNOWLEDGEMENT_STATE_PENDING |
Subskrypcja nie została jeszcze potwierdzona. |
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED |
Subskrypcja została potwierdzona. |
ExternalAccountIdentifiers
Identyfikator konta użytkownika w usłudze zewnętrznej.
Zapis JSON |
---|
{ "externalAccountId": string, "obfuscatedExternalAccountId": string, "obfuscatedExternalProfileId": string } |
Pola | |
---|---|
external |
Identyfikator konta użytkownika w usłudze zewnętrznej. Wyświetla się tylko wtedy, gdy połączenie kont nastąpiło w ramach procesu zakupu subskrypcji. |
obfuscated |
Zaszyfrowana wersja identyfikatora, który jest jednoznacznie powiązany z kontem użytkownika w aplikacji. Jest obecny w przypadku tych zakupów: * jeśli połączenie konta nastąpiło w ramach procesu zakupu subskrypcji. * W momencie dokonania zakupu został on określony za pomocą interfejsu https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid. |
obfuscated |
Zaszyfrowana wersja identyfikatora, który jest jednoznacznie powiązany z profilem użytkownika w aplikacji. Jest obecny tylko wtedy, gdy w momencie dokonania zakupu został podany za pomocą metody https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid. |
SubscribeWithGoogleInfo
informacje związane z zakupami dokonanymi za pomocą funkcji „Subskrybuj przez Google”;
Zapis JSON |
---|
{ "profileId": string, "profileName": string, "emailAddress": string, "givenName": string, "familyName": string } |
Pola | |
---|---|
profile |
Identyfikator profilu Google użytkownika w momencie zakupu subskrypcji. |
profile |
Nazwa profilu użytkownika w momencie zakupu subskrypcji. |
email |
Adres e-mail użytkownika w momencie zakupu subskrypcji. |
given |
Imię użytkownika w momencie zakupu subskrypcji. |
family |
Nazwisko użytkownika w dacie zakupu subskrypcji. |
SubscriptionPurchaseLineItem
Informacje na poziomie produktu dotyczące zakupu subskrypcji.
Zapis JSON |
---|
{ "productId": string, "expiryTime": string, // Union field |
Pola | |
---|---|
product |
Identyfikator zakupionego produktu (np. „monthly001”). |
expiry |
Czas, w którym subskrypcja wygasła lub wygaśnie, jeśli nie zostanie przedłużona (np. odnowiona). Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: |
Pole unii plan_type . Typ abonamentu. plan_type może być tylko jednym z tych elementów: |
|
auto |
Produkt jest automatycznie odnawiany. |
prepaid |
Produkt jest opłacony z góry. |
offer |
Szczegóły oferty dotyczące tego produktu. |
Pole unii deferred_item_change . Pole jest obecne, gdy element ma opóźnioną zmianę. Można go usunąć lub wymienić. deferred_item_change może być tylko jednym z tych elementów: |
|
deferred |
Informacje o opóźnionym zwrocie produktu. |
signup |
Szczegóły promocji dotyczące tego produktu. Jest ustawiany tylko wtedy, gdy podczas rejestracji została zastosowana promocja. |
AutoRenewingPlan
Informacje związane z automatycznym odnawianiem abonamentu.
Zapis JSON |
---|
{ "autoRenewEnabled": boolean, "priceChangeDetails": { object ( |
Pola | |
---|---|
auto |
Jeśli subskrypcja jest obecnie ustawiona na automatyczne odnawianie, np.użytkownik nie anulował subskrypcji. |
price |
Informacje o ostatniej zmianie ceny produktu od czasu rejestracji subskrypcji. |
installment |
Informacje o zobowiązaniach i stanie planu ratalnego w przypadku planu z automatycznym odnawianiem. |
SubscriptionItemPriceChangeDetails
Informacje o zmianie ceny produktu w ramach subskrypcji.
Zapis JSON |
---|
{ "newPrice": { object ( |
Pola | |
---|---|
new |
nowa cena cykliczna produktu w ramach subskrypcji, |
price |
Tryb zmiany ceny określa, jak zmienia się cena produktu w ramach subskrypcji. |
price |
Podaj, że zmiana ceny jest obecnie w drodze. |
expected |
Czas odnowienia, w którym zmiana ceny zacznie obowiązywać użytkownika. Może się to zmienić(w przyszłości) z powodu przesunięcia czasu odnowienia, np. w przypadku wstrzymania. To pole jest wypełniane tylko wtedy, gdy zmiana ceny nie została jeszcze wprowadzona. Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: |
PriceChangeMode
Tryb zmiany ceny.
Wartości w polu enum | |
---|---|
PRICE_CHANGE_MODE_UNSPECIFIED |
Tryb zmiany ceny nie został określony. Ta wartość nigdy nie powinna być ustawiana. |
PRICE_DECREASE |
Jeśli cena subskrypcji spada. |
PRICE_INCREASE |
jeśli cena subskrypcji wzrasta i użytkownik musi ją zaakceptować; |
OPT_OUT_PRICE_INCREASE |
Jeśli cena subskrypcji wzrasta w ramach trybu rezygnacji. |
PriceChangeState
Stan zmiany ceny.
Wartości w polu enum | |
---|---|
PRICE_CHANGE_STATE_UNSPECIFIED |
Stan zmiany ceny jest nieokreślony. Nie należy używać tej wartości. |
OUTSTANDING |
Czekam na zaakceptowanie przez użytkownika zmiany ceny. |
CONFIRMED |
Użytkownik potwierdził, że zmiana ceny została wprowadzona. |
APPLIED |
Zmiana ceny została zastosowana, czyli użytkownik zaczął płacić nową cenę. |
InstallmentPlan
Informacje o planie ratalnym.
Zapis JSON |
---|
{
"initialCommittedPaymentsCount": integer,
"subsequentCommittedPaymentsCount": integer,
"remainingCommittedPaymentsCount": integer,
"pendingCancellation": {
object ( |
Pola | |
---|---|
initial |
Łączna liczba płatności, na które użytkownik się początkowo zadeklarował. |
subsequent |
Łączna liczba płatności, które użytkownik zadeklaruje po każdym okresie zobowiązania. Pusty oznacza, że po upływie okresu wiązania subskrypcja ratalna zostanie automatycznie odnowiona jako zwykła subskrypcja z automatycznym odnawianiem. |
remaining |
Łączna liczba zobowiązań do płatności, które należy jeszcze zrealizować w ramach tego cyklu odnawiania. |
pending |
Jeśli jest obecny, oznacza, że ten abonament jest oczekujący na anulowanie. Anulowanie nastąpi dopiero po zakończeniu wszystkich zobowiązań płatniczych użytkownika. |
PendingCancellation
Ten typ nie ma pól.
Wskaźnik, czy oczekuje anulowanie wirtualnego planu ratalnego. Anulowanie nastąpi dopiero po zakończeniu wszystkich zobowiązań płatniczych użytkownika.
PrepaidPlan
informacje dotyczące abonamentu przedpłaconego;
Zapis JSON |
---|
{ "allowExtendAfterTime": string } |
Pola | |
---|---|
allow |
Jeśli jest obecny, to czas, po którym można doładować abonament przedpłacony. Nie są dostępne w przypadku wygasłych abonamentów przedpłaconych. Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: |
OfferDetails
Szczegółowe informacje o ofercie dotyczące elementu zamówienia z zakupem.
Zapis JSON |
---|
{ "offerTags": [ string ], "basePlanId": string, "offerId": string } |
Pola | |
---|---|
offer |
najnowsze tagi oferty powiązane z ofertą. Zawiera tagi odziedziczone z abonamentu podstawowego. |
base |
Identyfikator abonamentu podstawowego. Dostępne dla wszystkich abonamentów podstawowych i ofert. |
offer |
Identyfikator oferty. Widoczne tylko w przypadku ofert z rabatem. |
DeferredItemReplacement
Informacje dotyczące opóźnionego wymiany produktu.
Zapis JSON |
---|
{ "productId": string } |
Pola | |
---|---|
product |
productId zastąpi dotychczasowy productId. |
SignupPromotion
Promocja zastosowana do tego produktu w momencie zakupu.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole unii promotion_type . Typ promocji zastosowanej do produktu. promotion_type może być tylko jednym z tych elementów: |
|
one |
Zastosowano kod jednorazowy. |
vanity |
Zastosowano kod firmowy. |
OneTimeCode
Ten typ nie ma pól.
jednorazowy kod promocyjny,
VanityCode
Zdefiniowany wstępnie kod promocyjny do wielokrotnego użytku.
Zapis JSON |
---|
{ "promotionCode": string } |
Pola | |
---|---|
promotion |
Kod promocyjny. |
Metody |
|
---|---|
|
Pobieranie metadanych dotyczących subskrypcji |
|
anulować zakupioną przez użytkownika subskrypcję. |