- Zasób: SubscriptionPurchase
- IntroductoryPriceInfo
- SubscriptionCancelSurveyResult
- SubscriptionPriceChange
- Metody
Zasób: SubscriptionPurchase
Zasób subscriptionPurchase wskazuje stan zakupu subskrypcji przez użytkownika.
Zapis JSON |
---|
{ "kind": string, "startTimeMillis": string, "expiryTimeMillis": string, "autoResumeTimeMillis": string, "autoRenewing": boolean, "priceCurrencyCode": string, "priceAmountMicros": string, "introductoryPriceInfo": { object ( |
Pola | |
---|---|
kind |
Ten rodzaj reprezentuje obiekt subscriptionPurchase w usłudze androidpublisher. |
startTimeMillis |
Czas przyznania subskrypcji (w milisekundach od początku epoki). |
expiryTimeMillis |
Czas wygaśnięcia subskrypcji (w milisekundach od początku epoki). |
autoResumeTimeMillis |
Czas automatycznego wznowienia subskrypcji (w milisekundach od początku epoki). Widoczny tylko wtedy, gdy użytkownik poprosił o wstrzymanie subskrypcji. |
autoRenewing |
Określa, czy subskrypcja będzie automatycznie odnawiana po osiągnięciu bieżącego czasu. |
priceCurrencyCode |
Kod waluty ISO 4217 ceny subskrypcji. Jeśli na przykład cena jest podana w funtach brytyjskich, priceCurrencyCode to „GBP”. |
priceAmountMicros |
Cena subskrypcji. W krajach, w których nie ma podatku, cena nie zawiera podatku. W krajach, w których nie ma podatku, cena zawiera podatek. Cena jest wyrażona w mikrojednostkach, gdzie milion mikrojednostek odpowiada jednej jednostce waluty. Jeśli np.cena subskrypcji wynosi 1, 99 EUR, cena priceMicros to 1990 000. |
introductoryPriceInfo |
Informacje o cenie początkowej subskrypcji. Ta informacja jest widoczna tylko wtedy, gdy subskrypcja została kupiona po cenie początkowej. To pole nie wskazuje, że subskrypcja jest obecnie w okresie początkowym. |
countryCode |
Kod kraju/regionu rozliczenia według normy ISO 3166-1 alfa-2 użytkownika w momencie przyznawania subskrypcji. |
developerPayload |
Określony przez dewelopera ciąg tekstowy zawierający dodatkowe informacje o zamówieniu. |
paymentState |
Stan płatności za subskrypcję. Możliwe wartości to: 0. Oczekująca płatność: 1. Płatność otrzymana 2. Bezpłatny okres próbny 3. Oczekuje na odroczoną zmianę/zmianę wersji Nie występuje w przypadku anulowanych, wygasłych subskrypcji. |
cancelReason |
Powód anulowania lub nieodnawiania się automatycznie. Możliwe wartości to: 0. użytkownik anulował subskrypcję, 1. Subskrypcja została anulowana przez system, na przykład z powodu problemu z płatnością. 2. Subskrypcja została zastąpiona nową subskrypcją. 3. Subskrypcja została anulowana przez dewelopera |
userCancellationTimeMillis |
Czas anulowania subskrypcji przez użytkownika (w milisekundach od początku epoki). Występuje tylko wtedy, gdy cancelReason ma wartość 0. |
cancelSurveyResult |
Informacje podane przez użytkownika podczas procesu anulowania subskrypcji (ankieta dotycząca powodów anulowania). |
orderId |
Identyfikator ostatniego zamówienia cyklicznego powiązanego z zakupem subskrypcji. Jeśli subskrypcja została anulowana z powodu odrzucenia płatności, będzie to identyfikator zamówienia z odrzuconej płatności. |
linkedPurchaseToken |
Token zakupu źródłowego zakupu, jeśli ta subskrypcja jest jedną z tych: 0. ponowna rejestracja anulowanej, ale nieaktywnej subskrypcji; 1. Przechodzenie na wyższą lub niższą wersję usługi Załóżmy na przykład, że użytkownik pierwotnie zarejestrował się i otrzymujesz token zakupu X. Wtedy użytkownik anuluje rejestrację i przechodzi przez proces ponownej rejestracji (przed wygaśnięciem subskrypcji). Otrzymasz token zakupu Y, a na koniec użytkownik przejdzie na wyższą wersję subskrypcji, a Ty otrzymasz token zakupu Z. Jeśli wywołujesz ten interfejs API, używając tokena zakupu Z, to pole zostanie ustawione na Y. Jeśli wywołujesz ten interfejs API przy użyciu tokena zakupu Y, to pole zostanie ustawione na X. Jeśli wywołujesz ten interfejs API, używając tokena zakupu X, to pole nie zostanie ustawione. |
purchaseType |
Typ zakupu subskrypcji. To pole ustawia się tylko wtedy, gdy zakupu nie dokonano za pomocą standardowego procesu rozliczeń w aplikacji. Możliwe wartości to: 0. Testowy (np. kupiony na koncie do testowania licencji) 1. promocja (np. zakup za pomocą kodu promocyjnego), |
priceChange |
Najnowsze dostępne informacje o zmianie cen. Ten parametr jest dostępny tylko wtedy, gdy nadejdzie zmiana ceny subskrypcji, która nie została jeszcze zastosowana. Po odnowieniu subskrypcji z nową ceną lub po anulowaniu subskrypcji informacje o zmianie ceny nie zostaną zwrócone. |
profileName |
Nazwa profilu użytkownika, gdy użytkownik kupił subskrypcję. Widoczny tylko w przypadku zakupów dokonywanych przy użyciu funkcji „Subskrybuj z Google”. |
emailAddress |
Adres e-mail użytkownika, który kupił subskrypcję. Widoczny tylko w przypadku zakupów dokonywanych przy użyciu funkcji „Subskrybuj z Google”. |
givenName |
Imię i nazwisko użytkownika w chwili zakupu subskrypcji. Widoczny tylko w przypadku zakupów dokonywanych przy użyciu funkcji „Subskrybuj z Google”. |
familyName |
Imię i nazwisko użytkownika, w którym zakupiono subskrypcję. Widoczny tylko w przypadku zakupów dokonywanych przy użyciu funkcji „Subskrybuj z Google”. |
profileId |
Identyfikator profilu Google użytkownika, w którym zakupiono subskrypcję. Widoczny tylko w przypadku zakupów dokonywanych przy użyciu funkcji „Subskrybuj z Google”. |
acknowledgementState |
Stan potwierdzenia usługi objętej subskrypcją. Możliwe wartości to: 0. 1. Potwierdzono |
externalAccountId |
Identyfikator konta użytkownika w usłudze innej firmy. Widoczny tylko wtedy, gdy konto zostało połączone w ramach zakupu subskrypcji. |
promotionType |
Typ promocji zastosowanej do tego zakupu. To pole jest ustawiane tylko wtedy, gdy podczas zakupu subskrypcji ma zastosowanie promocja. Możliwe wartości to: 0. Kod jednorazowy 1. Kod słowny |
promotionCode |
Kod promocyjny zastosowany przy tym zakupie. To pole jest ustawiane tylko wtedy, gdy podczas zakupu subskrypcji stosowana jest promocja dotycząca kodu promocyjnego. |
obfuscatedExternalAccountId |
Zaciemniona wersja identyfikatora, który jest jednoznacznie powiązany z kontem użytkownika w Twojej aplikacji. Widoczne w przypadku tych zakupów: * Jeśli połączenie konta nastąpiło w ramach zakupu subskrypcji. * Został określony przy użyciu identyfikatora https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid podczas zakupu. |
obfuscatedExternalProfileId |
Zaciemniona wersja identyfikatora, który jest jednoznacznie powiązany z profilem użytkownika w Twojej aplikacji. Widoczny tylko wtedy, gdy podczas zakupu został określony za pomocą parametru https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid. |
IntroductoryPriceInfo
Zawiera informacje o cenie początkowej subskrypcji.
Zapis JSON |
---|
{ "introductoryPriceCurrencyCode": string, "introductoryPriceAmountMicros": string, "introductoryPricePeriod": string, "introductoryPriceCycles": integer } |
Pola | |
---|---|
introductoryPriceCurrencyCode |
Kod waluty ISO 4217 ceny subskrypcji dla nowych użytkowników. Jeśli na przykład cena jest podana w funtach brytyjskich, priceCurrencyCode to „GBP”. |
introductoryPriceAmountMicros |
Cena początkowa subskrypcji bez podatku. Waluta jest taka sama jak priceCurrencyCode. Cena jest wyrażona w mikrojednostkach, gdzie milion mikrojednostek odpowiada jednej jednostce waluty. Jeśli np.cena subskrypcji wynosi 1, 99 EUR, cena priceMicros to 1990 000. |
introductoryPricePeriod |
Okres obowiązywania ceny dla nowych subskrybentów określony w formacie ISO 8601. Typowe wartości to między innymi „P1W” (tydzień), „P1M” (1 miesiąc), „P3M” (3 miesiące), „P6M” (sześć miesięcy) i „P1Y” (jeden rok). |
introductoryPriceCycles |
Liczba okresu rozliczeniowego, w którym oferowane są ceny dla nowych subskrybentów. |
SubscriptionCancelSurveyResult
Informacje podane przez użytkownika podczas procesu anulowania subskrypcji (ankieta dotycząca powodów anulowania).
Zapis JSON |
---|
{ "cancelSurveyReason": integer, "userInputCancelReason": string } |
Pola | |
---|---|
cancelSurveyReason |
Powód anulowania wybrany przez użytkownika w ankiecie. Możliwe wartości to: 0. Inne 1. Nie używam tej usługi zbyt często 2. Problemy techniczne 3. Chodzi o koszty 4. Udało mi się znaleźć lepszą aplikację |
userInputCancelReason |
Niestandardowa przyczyna anulowania danych wejściowych użytkownika. Występuje tylko wtedy, gdy cancelReason ma wartość 0. |
SubscriptionPriceChange
Zawiera informacje o zmianie ceny subskrypcji, które mogą służyć do kontrolowania ścieżki użytkownika w związku ze zmianą ceny w aplikacji. Może to być prośba o potwierdzenie od użytkownika lub dostosowywanie procesu pod kątem skutecznej konwersji.
Zapis JSON |
---|
{
"newPrice": {
object ( |
Pola | |
---|---|
newPrice |
Nowa cena, którą subskrypcja zostanie odnowiona, jeśli użytkownik zaakceptuje zmianę. |
state |
Obecny stan zmiany ceny. Możliwe wartości to: 0. Oczekujące: stan oczekującej zmiany ceny przez użytkownika. W tym stanie możesz opcjonalnie poprosić użytkownika o potwierdzenie za pomocą interfejsu API w aplikacji. 1. Zaakceptowana: stan akceptowanej zmiany ceny, z którą subskrypcja będzie odnawiana, chyba że zostanie anulowana. Zmiana ceny zacznie obowiązywać w przyszłości w momencie odnowienia subskrypcji. Pamiętaj, że ta zmiana może nie pojawić się przy kolejnym odnowieniu subskrypcji. |
Metody |
|
---|---|
|
Potwierdza zakup subskrypcji. |
|
anuluje zakup subskrypcji użytkownika. |
|
Opóźnia zakup subskrypcji przez użytkownika do określonego terminu w przyszłości. |
|
Sprawdza, czy subskrypcja użytkownika jest ważna, i zwraca datę ważności. |
|
Zwraca środki za zakup subskrypcji, ale subskrypcja jest ważna do momentu jej wygaśnięcia i będzie dalej powtarzana. |
|
Zwraca środki za zakup subskrypcji i natychmiast anuluje zakup subskrypcji. |