REST Resource: purchases.subscriptions

{
  "kind": string,
  "startTimeMillis": string,
  "expiryTimeMillis": string,
  "autoResumeTimeMillis": string,
  "autoRenewing": boolean,
  "priceCurrencyCode": string,
  "priceAmountMicros": string,
  "introductoryPriceInfo": {
    object (IntroductoryPriceInfo)
  },
  "countryCode": string,
  "developerPayload": string,
  "paymentState": integer,
  "cancelReason": integer,
  "userCancellationTimeMillis": string,
  "cancelSurveyResult": {
    object (SubscriptionCancelSurveyResult)
  },
  "orderId": string,
  "linkedPurchaseToken": string,
  "purchaseType": integer,
  "priceChange": {
    object (SubscriptionPriceChange)
  },
  "profileName": string,
  "emailAddress": string,
  "givenName": string,
  "familyName": string,
  "profileId": string,
  "acknowledgementState": integer,
  "externalAccountId": string,
  "promotionType": integer,
  "promotionCode": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string
}

string

Ten typ reprezentuje obiekt subscriptionPurchase w usłudze androidpublisher.

string (int64 format)

Czas przyznania subskrypcji w milisekundach od początku epoki.

string (int64 format)

Czas, po którym subskrypcja wygaśnie (w milisekundach od początku epoki).

string (int64 format)

Czas, kiedy nastąpi automatyczne wznowienie subskrypcji (w milisekundach od początku epoki). To ustawienie ma zastosowanie tylko wtedy, gdy użytkownik poprosił o wstrzymanie subskrypcji.

boolean

Określa, czy subskrypcja jest automatycznie odnawiana po upływie terminu wygaśnięcia.

string

Kod waluty w standardzie ISO 4217. Jeśli na przykład cena jest podana w funtach brytyjskich, parametr priceCurrencyCode to "GBP".

string (int64 format)

Cena subskrypcji – w przypadku krajów bez podatku podatek nie zawiera podatku. W krajach z podatkiem cena zawiera podatek. Cena jest wyrażona w mikrojednostkach, w których 1 000 000 jest mikrojednostką waluty. Jeśli na przykład cena subskrypcji to 1, 99 EUR, priceAmountMicros to 1990000.

object (IntroductoryPriceInfo)

Informacje o cenie początkowej subskrypcji. Jest to możliwe tylko w przypadku zakupu subskrypcji z ceną początkową.

To pole nie wskazuje, że obecnie trwa okres obowiązywania ceny początkowej.

string

Kod kraju/regionu zgodnie z normą ISO 3166-1 alfa-2 użytkownika w momencie przyznania subskrypcji.

string

Ciąg znaków określony przez dewelopera, który zawiera dodatkowe informacje o zamówieniu.

integer

Stan płatności za subskrypcję. Możliwe wartości: 0 Płatność oczekująca 1. Płatność otrzymana 2. Bezpłatny okres próbny 3. Oczekuje na odroczone przejście na niższą lub wyższą wersję

Nie istnieje w przypadku anulowania subskrypcji, które wygasły.

integer

Przyczyna anulowania lub nieodnawiania subskrypcji. Możliwe wartości: 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

string (int64 format)

Czas anulowania subskrypcji przez użytkownika w milisekundach od początku epoki. Wartość podawana tylko w przypadku anulowania (Przyczyna 0).

object (SubscriptionCancelSurveyResult)

Informacje podane przez użytkownika, gdy przeprowadził proces anulowania subskrypcji (ankieta z informacją o anulowaniu subskrypcji).

string

Identyfikator zamówienia, z którego ostatnio dokonano zakupu powiązanego z subskrypcją. Jeśli subskrypcja została anulowana z powodu odrzucenia płatności, będzie to identyfikator zamówienia z odrzuconej płatności.

string

Token zakupu pierwotnego, jeśli jedna z tych subskrypcji to 0. Ponowna rejestracja anulowanej, niewygasłej subskrypcji 1. Przechodzenie na wyższą lub niższą wersję subskrypcji

Załóżmy na przykład, że użytkownik pierwotnie się zarejestrował, a Ty otrzymujesz token zakupu X, więc anuluje on subskrypcję i przechodzi przez proces ponownej rejestracji (przed wygaśnięciem subskrypcji), a Ty otrzymujesz token zakupu Y, a następnie użytkownik przenosi subskrypcję i otrzymujesz token zakupu Z. Jeśli wywołasz ten interfejs API za pomocą tokena zakupu Z, w tym polu zostanie ustawiona wartość Y. Jeśli wywołasz ten interfejs API za pomocą tokena zakupu Y, w tym polu zostanie ustawiona wartość X. Jeśli wywołasz ten interfejs API za pomocą tokena zakupu X, to pole nie zostanie ustawione.

integer

Rodzaj zakupu subskrypcji. To pole jest ustawione tylko wtedy, gdy zakupu nie dokonano za pomocą standardowego procesu rozliczeń w aplikacji. Możliwe wartości: 0 Testowy (np. zakupiony za pomocą konta do testowania licencji) 1. Promocja (np. kupiony za pomocą kodu promocyjnego)

object (SubscriptionPriceChange)

Najnowsze dostępne informacje o zmianie cen. Ta funkcja działa tylko wtedy, gdy do nadchodzącej zmiany ceny subskrypcji nie została jeszcze zastosowana.

Jeśli subskrypcja zostanie odnowiona z nową ceną lub zostanie anulowana, żadne informacje o zmianie ceny nie zostaną zwrócone.

string

Nazwa profilu użytkownika, który dokonał subskrypcji. Widoczny tylko w przypadku zakupów dokonanych za pomocą usługi „Subskrybuj z Google”.

string

Adres e-mail użytkownika podczas zakupu subskrypcji. Widoczny tylko w przypadku zakupów dokonanych za pomocą usługi „Subskrybuj z Google”.

string

Nazwa użytkownika, która została kupiona podczas zakupu subskrypcji. Widoczny tylko w przypadku zakupów dokonanych za pomocą usługi „Subskrybuj z Google”.

string

Nazwisko użytkownika, który wykupił subskrypcję. Widoczny tylko w przypadku zakupów dokonanych za pomocą usługi „Subskrybuj z Google”.

string

Identyfikator profilu Google użytkownika podczas kupowania subskrypcji. Widoczny tylko w przypadku zakupów dokonanych za pomocą usługi „Subskrybuj z Google”.

integer

Stan potwierdzenia subskrypcji. Możliwe wartości: 0 Jeszcze trzeba potwierdzić. 1. Potwierdzono

string

Identyfikator konta użytkownika w usłudze zewnętrznej. To ustawienie jest dostępne tylko wtedy, gdy w ramach procesu zakupu subskrypcji nastąpiło połączenie konta.

integer

Typ promocji zastosowanej do tego zakupu. To pole jest ustawione tylko wtedy, gdy do zakupu została zastosowana promocja. Możliwe wartości: 0 Kod jednorazowy 1. Kod słowny

string

Kod promocyjny zastosowany przy tym zakupie. To pole jest ustawione tylko wtedy, gdy podczas zakupu subskrypcji zastosowano skrócony kod promocyjny.

string

Zaciemniona wersja identyfikatora, która jest jednoznacznie powiązana z kontem użytkownika w Twojej aplikacji. Prezentowana w przypadku tych zakupów: * Jeśli konto zostało połączone w ramach procesu zakupu subskrypcji. * Została określona za pomocą parametru https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid podczas zakupu.

string

Zniekształcona wersja identyfikatora jednoznacznie powiązana z profilem użytkownika w aplikacji. Jest widoczna tylko wtedy, gdy została określona za pomocą parametru https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid podczas zakupu.

{
  "introductoryPriceCurrencyCode": string,
  "introductoryPriceAmountMicros": string,
  "introductoryPricePeriod": string,
  "introductoryPriceCycles": integer
}

string

Kod waluty w standardzie ISO 4217 dla ceny subskrypcji dla nowych użytkowników. Jeśli na przykład cena jest podana w funtach brytyjskich, parametr priceCurrencyCode to "GBP".

string (int64 format)

Cena początkowa subskrypcji bez podatku. Waluta jest taka sama jak priceCurrencyCode. Cena jest wyrażona w mikrojednostkach, w których 1 000 000 jest mikrojednostką waluty. Jeśli na przykład cena subskrypcji to 1, 99 EUR, priceAmountMicros to 1990000.

string

Okres obowiązywania ceny początkowej w formacie ISO 8601. Typowe wartości to między innymi „"P1W&quot” (tydzień), "P1M" (1 miesiąc), "P3M" (3 miesiące) i „P6M" (6 miesięcy)” oraz „"P1Y" rok”.

integer

Liczba okresów rozliczeniowych, w których obowiązuje cena początkowa.

{
  "cancelSurveyReason": integer,
  "userInputCancelReason": string
}

integer

Powód anulowania wybrany przez użytkownika w ankiecie. Możliwe wartości: 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ę

string

Dostosowana przyczyna anulowania podana przez użytkownika. Ten element jest dostępny tylko wtedy, gdy parametr cancellationPrzyczyna ma wartość 0.

{
  "newPrice": {
    object (Price)
  },
  "state": integer
}

object (Price)

Nowa cena, za którą subskrypcja zostanie odnowiona, jeśli użytkownik zaakceptuje zmianę ceny.

integer

Bieżący stan zmiany ceny. Możliwe wartości: 0 Zaległe: stan oczekującej zmiany ceny oczekującej na zgodę użytkownika. W takiej sytuacji możesz poprosić użytkownika o potwierdzenie za pomocą interfejsu In-App API. 1. Zaakceptowana: stan akceptowanej zmiany ceny, z której subskrypcja może zostać odnowiona, chyba że zostanie anulowana. Zmiana ceny zacznie obowiązywać w przyszłości, gdy subskrypcja będzie odnawiana. Pamiętaj, że zmiana może nie nastąpić przy odnowieniu subskrypcji.