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 zgodny ze standardem ISO 3166-1 alfa-2 w momencie przyznania subskrypcji.

object (SubscriptionPurchaseLineItem)

Informacje na poziomie produktu dotyczące zakupu subskrypcji. Wszystkie elementy w tym samym zakupie powinny być albo wszystkie w ramach automatycznego odnawiania subskrypcji, albo wszystkie w ramach przedpłaconego Planu.

string (Timestamp format)

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

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC 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)

Obecny stan subskrypcji.

string

Identyfikator ostatniego zamówienia powiązanego z zakupem subskrypcji. W przypadku subskrypcji odnawianej automatycznie jest to identyfikator zamówienia rejestracyjnego, jeśli nie zostało ono jeszcze odnowione, lub identyfikator ostatniego zamówienia cyklicznego (zamówienie zakończone sukcesem, zamówienie 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 ona jedna z tych sytuacji: * ponowna rejestracja anulowanej, ale jeszcze nie wygasłej subskrypcji; * przejście na wyższą lub niższą wersję usługi z poprzedniej subskrypcji. * Zmień abonament przedpłacony na odnawiane automatycznie. * Przejdź z automatycznie odnawianej subskrypcji na abonament przedpłacony. * Doładuj przedpłaconą subskrypcję.

object (PausedStateContext)

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

object (CanceledStateContext)

Dodatkowe informacje o anulowanych subskrypcjach. Widoczny tylko wtedy, gdy subskrypcja ma obecnie stan subscriptionState SUBSCRIPTION_STATE_CANCELED lub SUBSCRIPTION_STATE_expirationD.

object (TestPurchase)

Widoczny tylko wtedy, gdy 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, o której subskrypcja zostanie automatycznie wznowiona.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC 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, np. z powodu problemu z płatnościami.

object (DeveloperInitiatedCancellation)

Subskrypcja została anulowana przez dewelopera.

object (ReplacementCancellation)

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

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

object (CancelSurveyResult)

Informacje podane przez użytkownika podczas anulowania subskrypcji (ankieta dotycząca przyczyny anulowania).

string (Timestamp format)

Godzina anulowania subskrypcji przez użytkownika. Po upływie tego czasu użytkownik może nadal mieć dostęp do subskrypcji. Użyj parametru lineItems.expiry_time, aby sprawdzić, czy użytkownik nadal ma dostęp.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC 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 wybrania przez użytkownika w ankiecie dotyczącej anulowania.

string

Ustawiono 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 połączenie kont miało miejsce w ramach procesu zakupu subskrypcji.

string

Zaciemniona wersja identyfikatora, który jest jednoznacznie powiązany z kontem użytkownika w Twojej aplikacji. Widoczny w przypadku tych zakupów: * Jeśli połączenie kont miało miejsce w ramach procesu zakupu subskrypcji. * Zostały one określone za pomocą adresu https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid podczas zakupu.

string

Zaciemniona wersja identyfikatora, która jest w sposób unikalny powiązany z profilem użytkownika w Twojej aplikacji. Występuje tylko wtedy, gdy został podany za pomocą funkcji https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid podczas zakupu.

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

string

Identyfikator profilu Google użytkownika w momencie zakupu subskrypcji.

string

Nazwa profilu użytkownika w momencie zakupu subskrypcji.

string

Adres e-mail użytkownika w momencie zakupu subskrypcji.

string

Nazwa użytkownika w momencie zakupu subskrypcji.

string

Nazwisko użytkownika w momencie zakupu subskrypcji.

{
  "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 zakupionego produktu (np. „month001”).

string (Timestamp format)

Czas wygaśnięcia lub wygaśnięcia subskrypcji, chyba że dostęp zostanie przedłużony (na przykład zostanie odnowiona).

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC 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 jest odnawiany automatycznie.

object (PrepaidPlan)

Produkt jest opłacany z góry.

object (OfferDetails)

Szczegóły oferty dotyczące tego produktu.

object (DeferredItemReplacement)

Informacje na temat odroczonej wymiany produktu.

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

boolean

Jeśli subskrypcja jest obecnie ustawiona na automatyczne odnawianie, np. użytkownik nie ją anulował

object (SubscriptionItemPriceChangeDetails)

Informacje o ostatniej zmianie ceny produktu od momentu zarejestrowania się w subskrypcji.

object (InstallmentPlan)

Zobowiązanie z abonamentem ratalnym i informacje o stanie dotyczące abonamentu odnawianego automatycznie.

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

object (Money)

Nowa cena cykliczna subskrypcji.

enum (PriceChangeMode)

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

enum (PriceChangeState)

Podaj, w jakiej cenie jest obecnie zmieniona cena.

string (Timestamp format)

Termin odnowienia, w którym zmiana ceny zacznie obowiązywać dla użytkownika. Może się ona zmienić(w przyszłości) z powodu przesunięć czasu odnowienia, np. wstrzymania. Pole jest wypełniane tylko wtedy, gdy zmiana ceny nie została zastosowana.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC 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, do których zobowiązuje się użytkownik po każdym okresie zobowiązania. Brak wartości oznacza, że po początkowym zobowiązaniem abonament zostanie przywrócony do normalnej subskrypcji automatycznego odnawiania.

integer

Łączna liczba pozostałych zobowiązań do spłacenia w tym cyklu odnowienia.

object (PendingCancellation)

Jeśli występuje, ten plan ratalny oczekuje na anulowanie. Anulowanie nastąpi dopiero wtedy, gdy użytkownik zrealizuje wszystkie zobowiązania w ramach zobowiązania.

{
  "allowExtendAfterTime": string
}

string (Timestamp format)

Jeśli ten atrybut jest podany, jest to czas, po którym będzie można kupować doładowania w ramach abonamentu przedpłaconego. nie występuje w przypadku wygasłych abonamentów przedpłaconych,

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC 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 tagi odziedziczone z abonamentu podstawowego.

string

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

string

Identyfikator oferty. Widoczne tylko w przypadku ofert z rabatem.

{
  "productId": string
}

string

Identyfikator productId zastąpi istniejący identyfikator produktu.