REST Resource: purchases.subscriptionsv2

Zasób: SubscriptionPurchaseV2

Wskazuje stan zakupu subskrypcji przez użytkownika.

Zapis JSON
{
  "kind": string,
  "regionCode": string,
  "lineItems": [
    {
      object (SubscriptionPurchaseLineItem)
    }
  ],
  "startTime": string,
  "subscriptionState": enum (SubscriptionState),
  "linkedPurchaseToken": string,
  "pausedStateContext": {
    object (PausedStateContext)
  },
  "canceledStateContext": {
    object (CanceledStateContext)
  },
  "testPurchase": {
    object (TestPurchase)
  },
  "acknowledgementState": enum (AcknowledgementState),
  "externalAccountIdentifiers": {
    object (ExternalAccountIdentifiers)
  },
  "subscribeWithGoogleInfo": {
    object (SubscribeWithGoogleInfo)
  },
  "etag": string,
  "outOfAppPurchaseContext": {
    object (OutOfAppPurchaseContext)
  },
  "onHoldStateContext": {
    object (OnHoldStateContext)
  },
  "inGracePeriodStateContext": {
    object (InGracePeriodStateContext)
  }
}
Pola
kind

string

Ten rodzaj reprezentuje obiekt SubscriptionPurchaseV2 w usłudze androidpublisher.

regionCode

string

Kod kraju lub regionu rozliczenia użytkownika w formacie ISO 3166-1 alfa-2 w momencie przyznania subskrypcji.

lineItems[]

object (SubscriptionPurchaseLineItem)

Informacje na poziomie produktu dotyczące zakupu subskrypcji. Wszystkie produkty w ramach tego samego zakupu powinny być objęte abonamentem AutoRenewingPlan lub PrepaidPlan.

startTime

string (Timestamp format)

Czas przyznania subskrypcji. Nie jest ustawiana w przypadku oczekujących subskrypcji (subskrypcja została utworzona, ale oczekuje na płatność podczas rejestracji).

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

subscriptionState

enum (SubscriptionState)

Bieżący stan subskrypcji.

linkedPurchaseToken

string

Token zakupu starej subskrypcji, jeśli ta subskrypcja jest jedną z tych: * Ponowna rejestracja anulowanej, ale niewygasłej subskrypcji * Przejście na wyższą/niższą wersję poprzedniej subskrypcji. * Przejście z subskrypcji przedpłaconej na automatycznie odnawianą. * Przekształć subskrypcję z automatycznym odnawianiem w subskrypcję przedpłaconą. * doładowanie subskrypcji przedpłaconej;

pausedStateContext

object (PausedStateContext)

Dodatkowe informacje o wstrzymanych subskrypcjach. Występuje tylko wtedy, gdy subskrypcja ma obecnie stan SUBSCRIPTION_STATE_PAUSED.

canceledStateContext

object (CanceledStateContext)

Dodatkowe informacje o anulowanych subskrypcjach. Występuje tylko wtedy, gdy subskrypcja ma obecnie stan SUBSCRIPTION_STATE_CANCELED lub SUBSCRIPTION_STATE_EXPIRED.

testPurchase

object (TestPurchase)

Występuje tylko wtedy, gdy zakup subskrypcji jest zakupem testowym.

acknowledgementState

enum (AcknowledgementState)

Stan potwierdzenia subskrypcji.

externalAccountIdentifiers

object (ExternalAccountIdentifiers)

Identyfikator konta użytkownika w usłudze zewnętrznej.

subscribeWithGoogleInfo

object (SubscribeWithGoogleInfo)

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

etag

string

Tag encji reprezentujący bieżący stan subskrypcji. Deweloper udostępni ten tag etag na potrzeby działań związanych z subskrypcją. Ten tag etag jest zawsze obecny w przypadku subskrypcji z automatycznym odnawianiem i subskrypcji przedpłaconych.

outOfAppPurchaseContext

object (OutOfAppPurchaseContext)

Dodatkowy kontekst dotyczący zakupów poza aplikacją. Te informacje są dostępne tylko w przypadku ponownych zakupów subskrypcji (zakupów subskrypcji dokonanych po wygaśnięciu poprzedniej subskrypcji tego samego produktu) dokonanych w centrum subskrypcji Google Play. To pole zostanie usunięte po potwierdzeniu subskrypcji.

onHoldStateContext

object (OnHoldStateContext)

Opcjonalnie: Dodatkowy kontekst dotyczący subskrypcji w stanie ON_HOLD. Występuje tylko wtedy, gdy subskrypcja ma obecnie stan SUBSCRIPTION_STATE_ON_HOLD.

inGracePeriodStateContext

object (InGracePeriodStateContext)

Opcjonalnie: Dodatkowy kontekst dotyczący subskrypcji w stanie IN_GRACE_PERIOD. Występuje tylko wtedy, gdy subskrypcja ma obecnie stan SUBSCRIPTION_STATE_IN_GRACE_PERIOD.

SubscriptionState

Możliwe stany subskrypcji, np. czy jest aktywna, czy anulowana. Produkty w ramach zakupu subskrypcji mogą być abonamentami odnawianymi automatycznie lub abonamentami przedpłaconymi.

Wartości w polu enum
SUBSCRIPTION_STATE_UNSPECIFIED Nieokreślony stan subskrypcji.
SUBSCRIPTION_STATE_PENDING Subskrypcja została utworzona, ale podczas rejestracji oczekuje na płatność. W tym stanie wszystkie produkty oczekują na płatność.
SUBSCRIPTION_STATE_ACTIVE Subskrypcja jest aktywna. – (1) Jeśli subskrypcja jest abonamentem odnawianym automatycznie, co najmniej 1 element ma wartość autoRenewEnabled i nie wygasł. - (2) Jeśli subskrypcja jest abonamentem przedpłaconym, co najmniej 1 produkt nie wygasł.
SUBSCRIPTION_STATE_PAUSED Subskrypcja została wstrzymana. Stan jest dostępny tylko wtedy, gdy subskrypcja jest abonamentem odnawianym automatycznie. 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 odnawianym automatycznie. W tym stanie wszystkie elementy są w okresie prolongaty.
SUBSCRIPTION_STATE_ON_HOLD Subskrypcja jest wstrzymana (zawieszona). Stan jest dostępny tylko wtedy, gdy subskrypcja jest abonamentem odnawianym automatycznie. W tym stanie wszystkie elementy są objęte blokadą.
SUBSCRIPTION_STATE_CANCELED Subskrypcja została anulowana, ale jeszcze nie wygasła. Stan jest dostępny tylko wtedy, gdy subskrypcja jest abonamentem odnawianym automatycznie. Wszystkie elementy mają wartość „false” w polu autoRenewEnabled.
SUBSCRIPTION_STATE_EXPIRED Subskrypcja wygasła. Wszystkie elementy mają datę ważności w przeszłości.
SUBSCRIPTION_STATE_PENDING_PURCHASE_CANCELED Oczekująca transakcja dotycząca subskrypcji została anulowana. Jeśli ten oczekujący zakup dotyczył istniejącej subskrypcji, użyj linkedPurchaseToken, aby uzyskać jej bieżący stan.

PausedStateContext

Informacje dotyczące subskrypcji w stanie wstrzymania.

Zapis JSON
{
  "autoResumeTime": string
}
Pola
autoResumeTime

string (Timestamp format)

Czas, w którym subskrypcja zostanie automatycznie wznowiona.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

CanceledStateContext

Informacje dotyczące subskrypcji w stanie SUBSCRIPTION_STATE_CANCELED lub SUBSCRIPTION_STATE_EXPIRED.

Zapis JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "userInitiatedCancellation": {
    object (UserInitiatedCancellation)
  },
  "systemInitiatedCancellation": {
    object (SystemInitiatedCancellation)
  },
  "developerInitiatedCancellation": {
    object (DeveloperInitiatedCancellation)
  },
  "replacementCancellation": {
    object (ReplacementCancellation)
  }
  // End of mutually exclusive fields.
}
Pola
Powód anulowania subskrypcji. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
userInitiatedCancellation

object (UserInitiatedCancellation)

Subskrypcja została anulowana przez użytkownika.

systemInitiatedCancellation

object (SystemInitiatedCancellation)

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

developerInitiatedCancellation

object (DeveloperInitiatedCancellation)

Subskrypcja została anulowana przez dewelopera.

replacementCancellation

object (ReplacementCancellation)

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

Koniec pól wykluczających się wzajemnie.

UserInitiatedCancellation

Informacje dotyczące anulowania subskrypcji przez użytkowników.

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

object (CancelSurveyResult)

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

cancelTime

string (Timestamp format)

Czas, w którym subskrypcja została anulowana przez użytkownika. Po tym czasie użytkownik może nadal mieć dostęp do subskrypcji. Aby sprawdzić, czy użytkownik nadal ma dostęp, użyj lineItems.expiry_time.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

CancelSurveyResult

Wynik ankiety dotyczącej anulowania, gdy subskrypcja została anulowana przez użytkownika.

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

enum (CancelSurveyReason)

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

reasonUserInput

string

Ustawiane tylko w przypadku CANCEL_SURVEY_REASON_OTHERS. To jest odpowiedź użytkownika na ankietę w formie swobodnej.

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 Subskrypcja nie jest wystarczająco często używana.
CANCEL_SURVEY_REASON_TECHNICAL_ISSUES Problemy techniczne podczas korzystania z aplikacji.
CANCEL_SURVEY_REASON_FOUND_BETTER_APP Użytkownik znalazł lepszą aplikację.
CANCEL_SURVEY_REASON_OTHERS Inne przyczyny.

SystemInitiatedCancellation

Ten typ nie ma pól.

Informacje dotyczące anulowania zainicjowanego przez system Google.

DeveloperInitiatedCancellation

Ten typ nie ma pól.

Informacje dotyczące anulowania zainicjowanego przez deweloperów.

ReplacementCancellation

Ten typ nie ma pól.

Informacje dotyczące anulowania spowodowanego zastąpieniem 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
externalAccountId

string

Identyfikator konta użytkownika w usłudze zewnętrznej. Występuje tylko wtedy, gdy połączenie konta nastąpiło w ramach procesu zakupu subskrypcji.

obfuscatedExternalAccountId

string

Zamaskowana wersja identyfikatora, który jest jednoznacznie powiązany z kontem użytkownika w Twojej aplikacji. Jest on dostępny w przypadku tych zakupów: * Jeśli połączenie kont nastąpiło w ramach procesu zakupu subskrypcji. * został określony za pomocą https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid podczas dokonywania zakupu.

obfuscatedExternalProfileId

string

Zaszyfrowana wersja identyfikatora, który jest jednoznacznie powiązany z profilem użytkownika w Twojej aplikacji. Jest on dostępny tylko wtedy, gdy został określony za pomocą metody https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid podczas dokonywania zakupu.

SubscribeWithGoogleInfo

Informacje powiązane z zakupami dokonanymi za pomocą funkcji „Subskrybuj z Google”.

Zapis JSON
{
  "profileId": string,
  "profileName": string,
  "emailAddress": string,
  "givenName": string,
  "familyName": string
}
Pola
profileId

string

Identyfikator profilu Google użytkownika, który kupił subskrypcję.

profileName

string

Nazwa profilu użytkownika w momencie zakupu subskrypcji.

emailAddress

string

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

givenName

string

Imię użytkownika, który kupił subskrypcję.

familyName

string

Nazwisko użytkownika w momencie zakupu subskrypcji.

SubscriptionPurchaseLineItem

Informacje na poziomie produktu dotyczące zakupu subskrypcji.

Zapis JSON
{
  "productId": string,
  "expiryTime": string,
  "developerTargetedOffers": [
    {
      object (DeveloperTargetedOffer)
    }
  ],
  "latestSuccessfulOrderId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "autoRenewingPlan": {
    object (AutoRenewingPlan)
  },
  "prepaidPlan": {
    object (PrepaidPlan)
  }
  // End of mutually exclusive fields.
  "offerDetails": {
    object (OfferDetails)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "deferredItemReplacement": {
    object (DeferredItemReplacement)
  },
  "deferredItemRemoval": {
    object (DeferredItemRemoval)
  }
  // End of mutually exclusive fields.
  "signupPromotion": {
    object (SignupPromotion)
  },
  "itemReplacement": {
    object (ItemReplacement)
  },
  "offerPhase": {
    object (OfferPhase)
  }
}
Pola
productId

string

Identyfikator zakupionego produktu (np. „monthly001”).

expiryTime

string (Timestamp format)

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

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

developerTargetedOffers[]

object (DeveloperTargetedOffer)

Opcjonalnie: Szczegóły ofert skierowanych do deweloperów zarejestrowanych w przypadku tego elementu zamówienia.

latestSuccessfulOrderId

string

Identyfikator zamówienia ostatniego udanego zamówienia powiązanego z tym elementem. Nie występuje, jeśli element nie należy jeszcze do użytkownika (np. element, na który jest odroczona wymiana).

Typ abonamentu. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
autoRenewingPlan

object (AutoRenewingPlan)

Produkt jest automatycznie odnawiany.

prepaidPlan

object (PrepaidPlan)

Produkt jest opłacony z góry.

Koniec pól wykluczających się wzajemnie.
offerDetails

object (OfferDetails)

Szczegóły oferty dotyczące tego produktu.

To pole jest widoczne, gdy element ma odroczoną zmianę. Można go usunąć lub zastąpić. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
deferredItemReplacement

object (DeferredItemReplacement)

Informacje o odroczonej wymianie produktu.

deferredItemRemoval

object (DeferredItemRemoval)

Informacje o odroczonym usunięciu elementu.

Koniec pól wykluczających się wzajemnie.
signupPromotion

object (SignupPromotion)

Szczegóły promocji dotyczące tego produktu. Ustawiane tylko wtedy, gdy podczas rejestracji zastosowano promocję.

itemReplacement

object (ItemReplacement)

Szczegóły zastępowanego elementu. To pole jest wypełniane tylko wtedy, gdy ten element zastąpił inny element w poprzedniej subskrypcji. Jest ono dostępne tylko przez 60 dni od momentu zakupu.

offerPhase

object (OfferPhase)

Szczegóły bieżącego etapu oferty dla tego produktu.

AutoRenewingPlan

Informacje dotyczące abonamentu odnawianego automatycznie.

Zapis JSON
{
  "autoRenewEnabled": boolean,
  "recurringPrice": {
    object (Money)
  },
  "priceChangeDetails": {
    object (SubscriptionItemPriceChangeDetails)
  },
  "installmentDetails": {
    object (InstallmentPlan)
  },
  "planTransitionDetails": {
    object (PlanTransitionDetails)
  },
  "priceStepUpConsentDetails": {
    object (PriceStepUpConsentDetails)
  }
}
Pola
autoRenewEnabled

boolean

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

recurringPrice

object (Money)

Bieżąca cena cykliczna abonamentu odnawianego automatycznie. Pamiętaj, że cena nie uwzględnia rabatów ani podatków. Jeśli potrzebujesz szczegółów transakcji, w przypadku cen bez podatku wywołaj interfejs API orders.get.

priceChangeDetails

object (SubscriptionItemPriceChangeDetails)

Informacje o ostatniej zmianie ceny produktu od momentu rozpoczęcia subskrypcji.

installmentDetails

object (InstallmentPlan)

Zobowiązanie dotyczące abonamentu ratalnego i informacje o stanie abonamentu odnawianego automatycznie.

planTransitionDetails

object (PlanTransitionDetails)

Informacje o powiązanym przejściu na inny abonament. Będzie obecny tylko wtedy, gdy z tym abonamentem jest powiązany plan przejścia, i będzie zawierać tylko najnowsze szczegóły przejścia powiązane z tym elementem.

SubscriptionItemPriceChangeDetails

Informacje o zmianie ceny subskrypcji.

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

object (Money)

Nowa cena cykliczna produktu objętego subskrypcją.

priceChangeMode

enum (PriceChangeMode)

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

priceChangeState

enum (PriceChangeState)

Stan, w którym obecnie obowiązuje zmiana ceny.

expectedNewPriceChargeTime

string (Timestamp format)

Czas odnowienia, w którym zmiana ceny zacznie obowiązywać użytkownika. Może się to zmienić (na późniejszy termin) w przypadku przesunięcia czasu odnowienia, np. z powodu wstrzymania. To pole jest wypełniane tylko wtedy, gdy zmiana ceny nie została jeszcze wprowadzona.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

PriceChangeMode

Tryb zmiany ceny.

Wartości w polu enum
PRICE_CHANGE_MODE_UNSPECIFIED Nie określono trybu zmiany ceny. Ta wartość nie powinna być nigdy ustawiana.
PRICE_DECREASE Jeśli cena subskrypcji maleje.
PRICE_INCREASE Jeśli cena subskrypcji wzrasta i użytkownik musi ją zaakceptować.
OPT_OUT_PRICE_INCREASE Jeśli cena subskrypcji wzrasta w trybie rezygnacji.

PriceChangeState

Stan zmiany ceny.

Wartości w polu enum
PRICE_CHANGE_STATE_UNSPECIFIED Stan zmiany ceny nie został określony. Nie należy używać tej wartości.
OUTSTANDING Czekam, aż użytkownik zaakceptuje zmianę ceny.
CONFIRMED Zmiana ceny została potwierdzona dla użytkownika.
APPLIED Zmiana ceny została zastosowana, tzn. użytkownik zaczął płacić nową cenę.
CANCELED Zmiana ceny została anulowana.

InstallmentPlan

Informacje o planie ratalnym.

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

integer

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

subsequentCommittedPaymentsCount

integer

Łączna liczba płatności, do których użytkownik będzie zobowiązany po każdym okresie zobowiązania. Puste pole oznacza, że po upływie początkowego okresu zobowiązania plan ratalny zostanie zastąpiony standardową subskrypcją z automatycznym odnawianiem.

remainingCommittedPaymentsCount

integer

Łączna liczba płatności w ramach zobowiązania, które pozostały do uregulowania w tym cyklu odnowienia.

pendingCancellation

object (PendingCancellation)

Jeśli jest widoczny, oznacza to, że ten plan ratalny oczekuje na anulowanie. Anulowanie nastąpi dopiero po dokonaniu przez użytkownika wszystkich zobowiązanych płatności.

PendingCancellation

Ten typ nie ma pól.

Wskazuje, czy istnieje oczekujące anulowanie wirtualnego planu ratalnego. Anulowanie nastąpi dopiero po dokonaniu przez użytkownika wszystkich zobowiązanych płatności.

PlanTransitionDetails

Informacje związane ze zmianą abonamentu.

Zapis JSON
{
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "transitionInfo": {
    object (TransitionInfo)
  }
}
Pola
productId

string

[Wymagany] Identyfikator produktu, na który zostanie przeniesiony ten abonament (np. „monthly001”).

basePlanId

string

[Wymagane] Identyfikator abonamentu podstawowego, na który zostanie przeniesiony ten abonament.

offerId

string

Identyfikator oferty. Widoczna tylko w przypadku ofert z rabatem. Ta wartość jest ustawiana tylko wtedy, gdy plan docelowy nie jest abonamentem podstawowym.

transitionInfo

object (TransitionInfo)

Dodatkowe informacje o zaplanowanym przejściu na inny abonament. Będzie widoczny tylko wtedy, gdy zaplanowano przejście na inny abonament.

TransitionInfo

Informacje związane z zaplanowaną zmianą abonamentu.

Zapis JSON
{
  "transitionState": enum (TransitionState),
  "price": {
    object (Money)
  },
  "expectedTransitionTime": string
}
Pola
transitionState

enum (TransitionState)

Tylko dane wyjściowe. [Wymagane] Bieżący stan przejścia.

price

object (Money)

Domyślna cena abonamentu podstawowego, na który zostanie przeniesiony plan.

expectedTransitionTime

string (Timestamp format)

Bieżący oczekiwany czas, w którym może nastąpić zmiana abonamentu. Może się ona zmienić (na późniejszą) w przypadku przesunięcia czasu odnowienia, np. z powodu wstrzymania lub zawieszenia konta.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

TransitionState

Potencjalne stany, w których może znajdować się przejście.

Wartości w polu enum
TRANSITION_STATE_UNSPECIFIED Nieokreślony stan przejścia.
SCHEDULED Przeniesienie jest zaplanowane na przyszłość.
IN_PROGRESS Proces przenoszenia został rozpoczęty, a użytkownik otrzymał powiadomienie o przeniesieniu.
COMPLETED Przenoszenie zostało zakończone.
CANCELED Przejście zostało anulowane.

PriceStepUpConsentDetails

Informacje dotyczące podwyżki ceny, która wymaga zgody użytkownika.

Zapis JSON
{
  "state": enum (ConsentState),
  "consentDeadlineTime": string,
  "newPrice": {
    object (Money)
  }
}
Pola
state

enum (ConsentState)

Tylko dane wyjściowe. Stan zgody na podwyżkę ceny.

consentDeadlineTime

string (Timestamp format)

Termin, do którego użytkownik musi wyrazić zgodę. Jeśli nie wyrazisz zgody do tego czasu, subskrypcja zostanie anulowana.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

newPrice

object (Money)

Nowa cena, która wymaga zgody użytkownika.

ConsentState

Stan zgody na podwyżkę ceny.

Wartości w polu enum
CONSENT_STATE_UNSPECIFIED Nieokreślony stan zgody użytkownika.
PENDING Użytkownik nie wyraził jeszcze zgody.
CONFIRMED Użytkownik wyraził zgodę, a nowa cena czeka na wejście w życie.
COMPLETED Użytkownik wyraził zgodę i nowa cena zaczęła obowiązywać.

PrepaidPlan

Informacje dotyczące abonamentu przedpłaconego.

Zapis JSON
{
  "allowExtendAfterTime": string
}
Pola
allowExtendAfterTime

string (Timestamp format)

Jeśli jest podany, jest to czas, po którym dozwolone są zakupy doładowania w ramach abonamentu przedpłaconego. Nie będzie widoczny w przypadku wygasłych abonamentów przedpłaconych.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

OfferDetails

Szczegóły oferty związane z elementem zamówienia zakupu.

Zapis JSON
{
  "offerTags": [
    string
  ],
  "basePlanId": string,
  "offerId": string
}
Pola
offerTags[]

string

Najnowsze tagi ofert powiązane z ofertą. Zawiera tagi odziedziczone z abonamentu podstawowego.

basePlanId

string

Identyfikator abonamentu podstawowego. Jest obecny we wszystkich abonamentach podstawowych i ofertach.

offerId

string

Identyfikator oferty. Widoczna tylko w przypadku ofert z rabatem.

DeferredItemReplacement

Informacje dotyczące odroczonej wymiany produktu.

Zapis JSON
{
  "productId": string
}
Pola
productId

string

Identyfikator productId, który zastąpi dotychczasowy identyfikator productId.

DeferredItemRemoval

Ten typ nie ma pól.

Informacje dotyczące odroczonej wymiany produktu.

SignupPromotion

Promocja zastosowana do tego produktu w momencie zakupu.

Zapis JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "oneTimeCode": {
    object (OneTimeCode)
  },
  "vanityCode": {
    object (VanityCode)
  }
  // End of mutually exclusive fields.
}
Pola
Typ promocji zastosowanej do produktu. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
oneTimeCode

object (OneTimeCode)

Zastosowano kod jednorazowy.

vanityCode

object (VanityCode)

Zastosowano kod vanity.

Koniec pól wykluczających się wzajemnie.

OneTimeCode

Ten typ nie ma pól.

Jednorazowy kod promocyjny.

VanityCode

Wstępnie zdefiniowany kod promocyjny do wielokrotnego wykorzystania.

Zapis JSON
{
  "promotionCode": string
}
Pola
promotionCode

string

Kod promocyjny.

ItemReplacement

Szczegóły dotyczące zastępowanego elementu zamówienia subskrypcji.

Zapis JSON
{
  "productId": string,
  "replacementMode": enum (ReplacementMode),
  "basePlanId": string,
  "offerId": string
}
Pola
productId

string

Identyfikator produktu zastępowanego elementu zamówienia subskrypcji.

replacementMode

enum (ReplacementMode)

Tryb zastępowania zastosowany podczas zakupu.

basePlanId

string

Identyfikator abonamentu podstawowego zastępowanego elementu zamówienia subskrypcji.

offerId

string

Identyfikator oferty zastępowanego elementu zamówienia subskrypcji (jeśli dotyczy).

ReplacementMode

Tryb zastępowania subskrypcji.

Wartości w polu enum
REPLACEMENT_MODE_UNSPECIFIED Nieokreślony tryb zastępowania.
WITH_TIME_PRORATION Nowy abonament zostanie naliczony proporcjonalnie i pomniejszony o środki ze starego abonamentu.
CHARGE_PRORATED_PRICE Użytkownik zostanie obciążony proporcjonalną opłatą za nowy abonament.
WITHOUT_PRORATION Nowy pakiet zastąpi stary bez proporcjonalnego rozliczania czasu.
CHARGE_FULL_PRICE Użytkownik zostanie obciążony pełną ceną za nowy pakiet.
DEFERRED Stary abonament zostanie anulowany, a nowy zacznie obowiązywać po wygaśnięciu starego.
KEEP_EXISTING W przypadku tej wymiany abonament pozostanie bez zmian.

OfferPhase

Szczegóły etapu oferty.

Zapis JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "prorationPeriod": {
    object (ProrationPeriodOfferPhase)
  },
  "freeTrial": {
    object (FreeTrialOfferPhase)
  },
  "introductoryPrice": {
    object (IntroductoryPriceOfferPhase)
  },
  "basePrice": {
    object (BasePriceOfferPhase)
  }
  // End of mutually exclusive fields.
}
Pola
Szczegóły etapu oferty. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
prorationPeriod

object (ProrationPeriodOfferPhase)

Ustaw, gdy etap oferty jest okresem proporcjonalnym.

freeTrial

object (FreeTrialOfferPhase)

Ustaw, gdy etap oferty jest bezpłatnym okresem próbnym.

introductoryPrice

object (IntroductoryPriceOfferPhase)

Ustaw, gdy etap oferty jest etapem oferty z ceną początkową.

basePrice

object (BasePriceOfferPhase)

Ustaw, gdy etap oferty jest etapem cenowym abonamentu podstawowego.

Koniec pól wykluczających się wzajemnie.

ProrationPeriodOfferPhase

Szczegóły etapu oferty z okresem proporcjonalnym.

Zapis JSON
{
  "originalOfferPhaseType": enum (OriginalOfferPhaseType)
}
Pola
originalOfferPhaseType

enum (OriginalOfferPhaseType)

Pierwotny typ etapu oferty przed okresem proporcjonalnym. Ustawiane tylko wtedy, gdy okres proporcjonalny jest aktualizowany na podstawie istniejącej fazy oferty.

OriginalOfferPhaseType

Etap pierwotnej oferty płatności, jeśli płatność za ofertę jest płatnością proporcjonalną.

Wartości w polu enum
ORIGINAL_OFFER_PHASE_TYPE_UNSPECIFIED Nieokreślony typ etapu oferty pierwotnej.
BASE Subskrypcja jest w fazie ceny podstawowej (np. bilet normalny).
INTRODUCTORY Subskrypcja jest na etapie ceny początkowej.
FREE_TRIAL Subskrypcja jest w bezpłatnym okresie próbnym.

FreeTrialOfferPhase

Ten typ nie ma pól.

Szczegóły dotyczące etapu oferty bezpłatnego okresu próbnego.

IntroductoryPriceOfferPhase

Ten typ nie ma pól.

Szczegóły etapu oferty z ceną dla nowych użytkowników.

BasePriceOfferPhase

Ten typ nie ma pól.

Szczegóły dotyczące etapu oferty z ceną podstawową.

DeveloperTargetedOffer

Informacje o ofercie skierowanej do deweloperów dotyczącej elementu zamówienia z subskrypcją.

Zapis JSON
{
  "offerId": string,
  "activateTime": string
}
Pola
offerId

string

Opcjonalnie: Identyfikator oferty utworzonej przez dewelopera, która jest kierowana na subskrypcję.

activateTime

string (Timestamp format)

Opcjonalnie: Czas aktywacji kierowania oferty.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

OutOfAppPurchaseContext

Informacje dotyczące zakupu poza aplikacją.

Zapis JSON
{
  "expiredExternalAccountIdentifiers": {
    object (ExternalAccountIdentifiers)
  },
  "expiredPurchaseToken": string
}
Pola
expiredExternalAccountIdentifiers

object (ExternalAccountIdentifiers)

Identyfikator konta użytkownika z ostatniej wygasłej subskrypcji dla tego SKU.

expiredPurchaseToken

string

Token zakupu ostatniej wygasłej subskrypcji. Ten token zakupu może służyć tylko do identyfikacji użytkownika, jeśli powiązanie między tokenem purchaseToken a użytkownikiem jest przechowywane w Twojej bazie danych. Nie można go użyć do wywołania interfejsu Google Developer API, jeśli od jego wygaśnięcia minęło więcej niż 60 dni.

OnHoldStateContext

Dodatkowy kontekst dotyczący subskrypcji w stanie ON_HOLD.

Zapis JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "renewalDeclined": {
    object (RenewalDeclinedContext)
  }
  // End of mutually exclusive fields.
}
Pola
Powód, dla którego subskrypcja jest w stanie ON_HOLD. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
renewalDeclined

object (RenewalDeclinedContext)

Opcjonalnie: Płatność za odnowienie została odrzucona.

Koniec pól wykluczających się wzajemnie.

RenewalDeclinedContext

Kontekst związany ze scenariuszem odrzucenia odnowienia.

Zapis JSON
{
  "pendingOrderId": string
}
Pola
pendingOrderId

string

Wymagane. Identyfikator oczekującego lub nieudanego zamówienia, które powoduje ten stan.

InGracePeriodStateContext

Dodatkowy kontekst dotyczący subskrypcji w stanie IN_GRACE_PERIOD.

Zapis JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "renewalDeclined": {
    object (RenewalDeclinedContext)
  }
  // End of mutually exclusive fields.
}
Pola
Powód, dla którego subskrypcja jest w stanie IN_GRACE_PERIOD. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
renewalDeclined

object (RenewalDeclinedContext)

Opcjonalnie: Płatność za odnowienie została odrzucona.

Koniec pól wykluczających się wzajemnie.

Metody

activateoffertargeting

Aktywuje kierowanie na konkretną ofertę.

cancel

Anulowanie zakupu subskrypcji przez użytkownika.

cancelplantransition

Anulowanie zmiany abonamentu subskrypcji.

deactivateoffertargeting

Dezaktywuje kierowanie na konkretną ofertę.

defer

Odracza odnowienie subskrypcji.

get

Pobieranie metadanych subskrypcji

revoke

Anulowanie zakupu subskrypcji przez użytkownika.

scheduleplantransition

Zaplanuj przejście na inny abonament w ramach subskrypcji.

Kody błędów

Operacje tego zasobu zwracają te kody błędów HTTP:

Kod błędu Przyczyna Opis Rozdzielczość
400 / 410 subscriptionExpired Subskrypcja wygasła i nie można wykonać żądanej operacji. Sprawdź datę ważności subskrypcji. Tej operacji nie można wykonać na wygasłych subskrypcjach.
400 subscriptionInvalidArgument W żądaniu subskrypcji podano nieprawidłowy argument. Przejrzyj dokumentację API i upewnij się, że wszystkie wymagane pola są podane i prawidłowo sformatowane.
400 invalidPurchaseState Zakup nie jest w prawidłowym stanie, aby można było wykonać żądaną operację. Może na przykład próbujesz potwierdzić zakup, który został już wykorzystany, lub anulować subskrypcję, która nie jest aktywna. Przed próbą wykonania operacji sprawdź bieżący stan zasobu za pomocą odpowiedniego interfejsu API Get. Upewnij się, że zasób jest w stanie odpowiednim do wykonania działania.
400 invalidValue W żądaniu podano nieprawidłową wartość. Często jest zwracany w przypadku nieprawidłowo sformatowanego lub nieprawidłowego tokena zakupu. Popraw nieprawidłową wartość pola w treści lub parametrach żądania na podstawie dokumentacji API.
400 prepaidSubscriptionNotSupported Żądana operacja nie jest obsługiwana w przypadku subskrypcji przedpłaconych. Upewnij się, że operacja jest odpowiednia dla danego typu subskrypcji. Ten błąd dotyczy tylko metod takich jak Cancel.
400 productNotOwnedByUser Podany token zakupu jest prawidłowy, ale użytkownik nie jest obecnie właścicielem produktu. Może się tak zdarzyć, jeśli przed potwierdzeniem zakupu środki zostały zwrócone, zakup został anulowany lub wygasł. Przed próbą wykonania operacji sprawdź bieżący stan zasobu za pomocą odpowiedniego interfejsu API Get. Upewnij się, że zasób jest w stanie odpowiednim do wykonania działania.
400 purchaseTokenMismatch Podany token zakupu nie pasuje do zakupu, nazwy pakietu, identyfikatora subskrypcji lub identyfikatora produktu. Sprawdź, czy wszystkie informacje w prośbie są prawidłowe i zgodne ze sobą.
400 required W żądaniu brakuje wymaganego pola lub parametru. Zapoznaj się z dokumentacją API, aby upewnić się, że uwzględniono wszystkie wymagane pola i parametry.
400 unsupportedIabType Operacja nie jest obsługiwana w przypadku danego typu rozliczeń w aplikacji. Upewnij się, że metoda interfejsu API jest zgodna z typem produktu, którym zarządzasz.
403 userInsufficientPermission Użytkownik nie ma wystarczających uprawnień do wykonania żądanej operacji. Sprawdź, czy uwierzytelniony użytkownik ma niezbędne uprawnienia w Konsoli Google Play. Więcej informacji znajdziesz w artykule Używanie konta usługi.
404 notFound Nie znaleziono żądanego zasobu. Sprawdź, czy identyfikatory (np. token zakupu, nazwa pakietu, identyfikator produktu, identyfikator subskrypcji) są prawidłowe.
409 concurrentUpdate Podjęto próbę zaktualizowania obiektu, który jest aktualizowany jednocześnie. Ponów żądanie ze wzrastającym czasem do ponowienia. Unikaj jednoczesnego wprowadzania zmian w tym samym zasobie.
410 purchaseTokenNoLongerValid Token zakupu jest trwale nieprawidłowy, ponieważ powiązane konto użytkownika zostało usunięte lub rekord zakupu już nie istnieje. Przestań używać tego tokena zakupu.
410 subscriptionNoLongerAvailable Zakup subskrypcji nie jest już dostępny do zapytania, ponieważ wygasł zbyt dawno temu. Ten błąd oznacza, że subskrypcja wygasła ponad 60 dni temu. Nie należy już wysyłać zapytań o te subskrypcje.
5xx Generic error Ogólny błąd serwera Google Play. Ponów żądanie.

Jeśli problem nie ustąpi, skontaktuj się z menedżerem konta Google Play lub prześlij prośbę o pomoc. Sprawdź w Panelu stanu Google Play, czy nie występują znane przerwy w działaniu usługi.