REST Resource: purchases.subscriptionsv2

{
  "kind": string,
  "regionCode": string,
  "lineItems": [
    {
      object (SubscriptionPurchaseLineItem)
    }
  ],
  "startTime": string,
  "subscriptionState": enum (SubscriptionState),
  "latestOrderId": string,
  "linkedPurchaseToken": string,
  "pausedStateContext": {
    object (PausedStateContext)
  },
  "canceledStateContext": {
    object (CanceledStateContext)
  },
  "testPurchase": {
    object (TestPurchase)
  },
  "acknowledgementState": enum (AcknowledgementState),
  "externalAccountIdentifiers": {
    object (ExternalAccountIdentifiers)
  },
  "subscribeWithGoogleInfo": {
    object (SubscribeWithGoogleInfo)
  }
}

string

Ten rodzaj reprezentuje obiekt SubscriptionPurchaseV2 w usłudze androidpublisher.

string

Kod kraju/regionu rozliczenia według normy ISO 3166-1 alfa-2 użytkownika w momencie przyznawania subskrypcji.

object (SubscriptionPurchaseLineItem)

Informacje o zakupie subskrypcji na poziomie produktu. Wszystkie elementy w ramach tego samego zakupu powinny korzystać z opcji AutoRenewingPlan lub wszystkie z abonamentem przedpłaconym.

string (Timestamp format)

Czas przyznania subskrypcji. Nie ustawiono dla oczekujących subskrypcji (subskrypcja została utworzona, ale rejestracja oczekuje na płatność).

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

enum (SubscriptionState)

Bieżący stan subskrypcji.

string

Identyfikator ostatniego zamówienia powiązanego z zakupem subskrypcji. W przypadku subskrypcji z automatycznym odnawianiem jest to identyfikator zamówienia rejestracji, jeśli nie zostało jeszcze odnowione, lub identyfikator ostatniego zamówienia cyklicznego (zamówienie zrealizowane, oczekujące lub odrzucone). W przypadku subskrypcji przedpłaconej jest to identyfikator zamówienia powiązany z tokenem zakupu, którego dotyczy zapytanie.

string

Token zakupu starej subskrypcji, jeśli jest to jedna z tych opcji: * ponowna rejestracja anulowanej, ale jeszcze nieważnej subskrypcji, * przejście na wyższą lub niższą wersję poprzedniej subskrypcji. * Przejście z subskrypcji przedpłaconej na subskrypcję odnawianą automatycznie. * Zmień subskrypcję z automatycznego odnawiania na przedpłaconą. * Przedłużanie subskrypcji przedpłaconej.

object (PausedStateContext)

Dodatkowy kontekst dotyczący wstrzymanych subskrypcji. Widoczne tylko wtedy, gdy subskrypcja ma obecnie stan subscriptionState SUBSCRIPTION_STATE_PAUSED.

object (CanceledStateContext)

Dodatkowy kontekst związany z anulowanymi subskrypcjami. Widoczne tylko wtedy, gdy subskrypcja ma obecnie stan subscriptionState SUBSCRIPTION_STATE_CANCELED lub SUBSCRIPTION_STATE_EXPIRED.

object (TestPurchase)

Widoczne tylko wtedy, gdy ten zakup subskrypcji jest zakupem testowym.

enum (AcknowledgementState)

Stan potwierdzenia subskrypcji.

object (ExternalAccountIdentifiers)

Identyfikator konta użytkownika w usłudze innej firmy.

object (SubscribeWithGoogleInfo)

Profil użytkownika powiązany z zakupami dokonanymi za pomocą funkcji „Subskrybuj z Google”.

{
  "autoResumeTime": string
}

string (Timestamp format)

Godzina, po której subskrypcja zostanie automatycznie wznowiona.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

{

  // Union field cancellation_reason can be only one of the following:
  "userInitiatedCancellation": {
    object (UserInitiatedCancellation)
  },
  "systemInitiatedCancellation": {
    object (SystemInitiatedCancellation)
  },
  "developerInitiatedCancellation": {
    object (DeveloperInitiatedCancellation)
  },
  "replacementCancellation": {
    object (ReplacementCancellation)
  }
  // End of list of possible types for union field cancellation_reason.
}

object (UserInitiatedCancellation)

Subskrypcja została anulowana przez użytkownika.

object (SystemInitiatedCancellation)

Subskrypcja została anulowana przez system, na przykład z powodu problemu z płatnością.

object (DeveloperInitiatedCancellation)

Subskrypcja została anulowana przez dewelopera.

object (ReplacementCancellation)

Subskrypcja została zastąpiona nową subskrypcją.

{
  "cancelSurveyResult": {
    object (CancelSurveyResult)
  },
  "cancelTime": string
}

object (CancelSurveyResult)

Informacje podane przez użytkownika podczas procesu anulowania subskrypcji (ankieta dotycząca powodów anulowania).

string (Timestamp format)

Godzina anulowania subskrypcji przez użytkownika. Po tym czasie użytkownik może nadal mieć dostęp do subskrypcji. Użyj wartości lineItems.expiry_time, aby określić, czy użytkownik nadal ma dostęp.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

{
  "reason": enum (CancelSurveyReason),
  "reasonUserInput": string
}

enum (CancelSurveyReason)

Powód wybrany przez użytkownika w ankiecie dotyczącej anulowania.

string

Ustawiony tylko dla CANCEL_SURVEY_REASON_OTHERS. To jest swobodna odpowiedź użytkownika na ankietę.

{
  "externalAccountId": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string
}

string

Identyfikator konta użytkownika w usłudze innej firmy. Widoczny tylko wtedy, gdy konto zostało połączone w ramach zakupu subskrypcji.

string

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.

string

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.

{
  "profileId": string,
  "profileName": string,
  "emailAddress": string,
  "givenName": string,
  "familyName": string
}

string

Identyfikator profilu Google użytkownika, w którym zakupiono subskrypcję.

string

Nazwa profilu użytkownika, gdy użytkownik kupił subskrypcję.

string

Adres e-mail użytkownika, który kupił subskrypcję.

string

Imię i nazwisko użytkownika w chwili zakupu subskrypcji.

string

Imię i nazwisko użytkownika, w którym zakupiono subskrypcję.

{
  "productId": string,
  "expiryTime": string,

  // Union field plan_type can be only one of the following:
  "autoRenewingPlan": {
    object (AutoRenewingPlan)
  },
  "prepaidPlan": {
    object (PrepaidPlan)
  }
  // End of list of possible types for union field plan_type.
  "offerDetails": {
    object (OfferDetails)
  },

  // Union field deferred_item_change can be only one of the following:
  "deferredItemReplacement": {
    object (DeferredItemReplacement)
  }
  // End of list of possible types for union field deferred_item_change.
}

string

Identyfikator kupionego produktu (np. „month001”).

string (Timestamp format)

Czas, w którym subskrypcja wygasła lub wygaśnie, chyba że dostęp zostanie przedłużony (np. zostanie odnowiona).

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

object (AutoRenewingPlan)

Produkt odnawia się automatycznie.

object (PrepaidPlan)

Produkt jest opłacany z góry.

object (OfferDetails)

Szczegóły oferty tego produktu.

object (DeferredItemReplacement)

Informacje na temat odroczonej wymiany produktu.

{
  "autoRenewEnabled": boolean,
  "priceChangeDetails": {
    object (SubscriptionItemPriceChangeDetails)
  },
  "installmentDetails": {
    object (InstallmentPlan)
  }
}

boolean

Jeśli obecnie masz włączone automatyczne odnawianie subskrypcji, np. użytkownik nie anulował subskrypcji

object (SubscriptionItemPriceChangeDetails)

Informacja o ostatniej zmianie ceny produktu od momentu rejestracji subskrypcji.

object (InstallmentPlan)

Zobowiązanie na plan ratalny i informacje dotyczące stanu dotyczące abonamentu z automatycznym odnawianiem.

{
  "newPrice": {
    object (Money)
  },
  "priceChangeMode": enum (PriceChangeMode),
  "priceChangeState": enum (PriceChangeState),
  "expectedNewPriceChargeTime": string
}

object (Money)

Nowa cykliczna cena subskrypcji.

enum (PriceChangeMode)

Tryb zmiany ceny określa, jak zmienia się cena produktu w ramach subskrypcji.

enum (PriceChangeState)

informować o bieżącej zmianie ceny.

string (Timestamp format)

Godzina odnowienia, w której zmiana ceny zacznie obowiązywać w przypadku użytkownika. Może się to zmienić(w przyszłości) w zależności od sytuacji, w której czas odnowienia się zmienia, np. przez wstrzymanie. To pole jest wypełniane tylko wtedy, gdy zmiana ceny nie została wprowadzona.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

{
  "initialCommittedPaymentsCount": integer,
  "subsequentCommittedPaymentsCount": integer,
  "remainingCommittedPaymentsCount": integer,
  "pendingCancellation": {
    object (PendingCancellation)
  }
}

integer

Łączna liczba płatności, do których użytkownik zobowiązał się początkowo.

integer

Łączna liczba płatności, które użytkownik zobowiązuje się zrealizować po każdym okresie zobowiązania. Brak wartości oznacza, że po początkowym zobowiązaniu abonament ratalny zostanie przełączony na zwykłą subskrypcję z automatycznym odnawianiem.

integer

Łączna liczba płatności w ramach zobowiązania, które należy opłacić w tym cyklu odnowienia.

object (PendingCancellation)

Jeśli ten plan ratalny jest dostępny, oczekuje na anulowanie. Anulowanie nastąpi dopiero po dokonaniu przez użytkownika wszystkich zobowiązań.

{
  "allowExtendAfterTime": string
}

string (Timestamp format)

Jeśli występuje, po upływie tego czasu można doładować abonament przedpłacony. Nie będzie dostępny w przypadku wygasłych abonamentów przedpłaconych.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

{
  "offerTags": [
    string
  ],
  "basePlanId": string,
  "offerId": string
}

string

Najnowsze tagi oferty powiązane z ofertą. Obejmuje on tagi odziedziczone z abonamentu podstawowego.

string

Identyfikator abonamentu podstawowego. Widoczne w przypadku wszystkich abonamentów podstawowych i ofert.

string

Identyfikator oferty. Widoczny tylko w przypadku ofert z rabatem.

{
  "productId": string
}

string

Identyfikator productId zastąpi istniejący identyfikator produktu.