- Zasób: SubscriptionPurchaseV2
- SubscriptionState
- PausedStateContext
- CanceledStateContext
- UserInitiatedCancellation
- CancelSurveyResult
- CancelSurveyReason
- SystemInitiatedCancellation
- DeveloperInitiatedCancellation
- ReplacementCancellation
- TestPurchase
- AcknowledgementState
- ExternalAccountIdentifiers
- SubscribeWithGoogleInfo
- SubscriptionPurchaseLineItem
- AutoRenewingPlan
- SubscriptionItemPriceChangeDetails
- PriceChangeMode
- PriceChangeState
- InstallmentPlan
- PendingCancellation
- PlanTransitionDetails
- TransitionInfo
- TransitionState
- PriceStepUpConsentDetails
- ConsentState
- PrepaidPlan
- OfferDetails
- DeferredItemReplacement
- DeferredItemRemoval
- SignupPromotion
- OneTimeCode
- VanityCode
- ItemReplacement
- ReplacementMode
- OfferPhase
- ProrationPeriodOfferPhase
- OriginalOfferPhaseType
- FreeTrialOfferPhase
- IntroductoryPriceOfferPhase
- BasePriceOfferPhase
- DeveloperTargetedOffer
- OutOfAppPurchaseContext
- OnHoldStateContext
- RenewalDeclinedContext
- InGracePeriodStateContext
- Metody
Zasób: SubscriptionPurchaseV2
Wskazuje stan zakupu subskrypcji przez użytkownika.
| Zapis JSON |
|---|
{ "kind": string, "regionCode": string, "lineItems": [ { object ( |
| Pola | |
|---|---|
kind |
Ten rodzaj reprezentuje obiekt SubscriptionPurchaseV2 w usłudze androidpublisher. |
regionCode |
Kod kraju lub regionu rozliczenia użytkownika w formacie ISO 3166-1 alfa-2 w momencie przyznania subskrypcji. |
lineItems[] |
Informacje na poziomie produktu dotyczące zakupu subskrypcji. Wszystkie produkty w ramach tego samego zakupu powinny być objęte abonamentem AutoRenewingPlan lub PrepaidPlan. |
startTime |
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: |
subscriptionState |
Bieżący stan subskrypcji. |
linkedPurchaseToken |
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 |
Dodatkowe informacje o wstrzymanych subskrypcjach. Występuje tylko wtedy, gdy subskrypcja ma obecnie stan SUBSCRIPTION_STATE_PAUSED. |
canceledStateContext |
Dodatkowe informacje o anulowanych subskrypcjach. Występuje tylko wtedy, gdy subskrypcja ma obecnie stan SUBSCRIPTION_STATE_CANCELED lub SUBSCRIPTION_STATE_EXPIRED. |
testPurchase |
Występuje tylko wtedy, gdy zakup subskrypcji jest zakupem testowym. |
acknowledgementState |
Stan potwierdzenia subskrypcji. |
externalAccountIdentifiers |
Identyfikator konta użytkownika w usłudze zewnętrznej. |
subscribeWithGoogleInfo |
Profil użytkownika powiązany z zakupami dokonanymi za pomocą funkcji „Subskrybuj z Google”. |
etag |
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 |
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 |
Opcjonalnie: Dodatkowy kontekst dotyczący subskrypcji w stanie ON_HOLD. Występuje tylko wtedy, gdy subskrypcja ma obecnie stan SUBSCRIPTION_STATE_ON_HOLD. |
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 |
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: |
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 ( |
| 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 |
Subskrypcja została anulowana przez użytkownika. |
systemInitiatedCancellation |
Subskrypcja została anulowana przez system, na przykład z powodu problemu z płatnością. |
developerInitiatedCancellation |
Subskrypcja została anulowana przez dewelopera. |
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 ( |
| Pola | |
|---|---|
cancelSurveyResult |
Informacje podane przez użytkownika podczas procesu anulowania subskrypcji (ankieta dotycząca powodu anulowania). |
cancelTime |
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: |
CancelSurveyResult
Wynik ankiety dotyczącej anulowania, gdy subskrypcja została anulowana przez użytkownika.
| Zapis JSON |
|---|
{
"reason": enum ( |
| Pola | |
|---|---|
reason |
Powód wybrany przez użytkownika w ankiecie dotyczącej anulowania. |
reasonUserInput |
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_COST_RELATED |
Problemy związane z kosztami. |
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 |
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 |
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 |
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 |
Identyfikator profilu Google użytkownika, który kupił subskrypcję. |
profileName |
Nazwa profilu użytkownika w momencie zakupu subskrypcji. |
emailAddress |
Adres e-mail użytkownika, który kupił subskrypcję. |
givenName |
Imię użytkownika, który kupił subskrypcję. |
familyName |
Nazwisko użytkownika w momencie zakupu subskrypcji. |
SubscriptionPurchaseLineItem
Informacje na poziomie produktu dotyczące zakupu subskrypcji.
| Zapis JSON |
|---|
{ "productId": string, "expiryTime": string, "developerTargetedOffers": [ { object ( |
| Pola | |
|---|---|
productId |
Identyfikator zakupionego produktu (np. „monthly001”). |
expiryTime |
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: |
developerTargetedOffers[] |
Opcjonalnie: Szczegóły ofert skierowanych do deweloperów zarejestrowanych w przypadku tego elementu zamówienia. |
latestSuccessfulOrderId |
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 |
Produkt jest automatycznie odnawiany. |
prepaidPlan |
Produkt jest opłacony z góry. |
| Koniec pól wykluczających się wzajemnie. | |
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 |
Informacje o odroczonej wymianie produktu. |
deferredItemRemoval |
Informacje o odroczonym usunięciu elementu. |
| Koniec pól wykluczających się wzajemnie. | |
signupPromotion |
Szczegóły promocji dotyczące tego produktu. Ustawiane tylko wtedy, gdy podczas rejestracji zastosowano promocję. |
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 |
Szczegóły bieżącego etapu oferty dla tego produktu. |
AutoRenewingPlan
Informacje dotyczące abonamentu odnawianego automatycznie.
| Zapis JSON |
|---|
{ "autoRenewEnabled": boolean, "recurringPrice": { object ( |
| Pola | |
|---|---|
autoRenewEnabled |
Jeśli subskrypcja jest obecnie ustawiona na automatyczne odnawianie, np.użytkownik nie anulował subskrypcji. |
recurringPrice |
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 |
priceChangeDetails |
Informacje o ostatniej zmianie ceny produktu od momentu rozpoczęcia subskrypcji. |
installmentDetails |
Zobowiązanie dotyczące abonamentu ratalnego i informacje o stanie abonamentu odnawianego automatycznie. |
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. |
priceStepUpConsentDetails |
Informacje o najnowszej zgodzie na podwyższenie ceny. |
SubscriptionItemPriceChangeDetails
Informacje o zmianie ceny subskrypcji.
| Zapis JSON |
|---|
{ "newPrice": { object ( |
| Pola | |
|---|---|
newPrice |
Nowa cena cykliczna produktu objętego subskrypcją. |
priceChangeMode |
Tryb zmiany ceny określa, jak zmienia się cena produktu w subskrypcji. |
priceChangeState |
Stan, w którym obecnie obowiązuje zmiana ceny. |
expectedNewPriceChargeTime |
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: |
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 ( |
| Pola | |
|---|---|
initialCommittedPaymentsCount |
Łączna liczba płatności, do których użytkownik jest początkowo zobowiązany. |
subsequentCommittedPaymentsCount |
Łą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 |
Łączna liczba płatności w ramach zobowiązania, które pozostały do uregulowania w tym cyklu odnowienia. |
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 ( |
| Pola | |
|---|---|
productId |
[Wymagany] Identyfikator produktu, na który zostanie przeniesiony ten abonament (np. „monthly001”). |
basePlanId |
[Wymagane] Identyfikator abonamentu podstawowego, na który zostanie przeniesiony ten abonament. |
offerId |
Identyfikator oferty. Widoczna tylko w przypadku ofert z rabatem. Ta wartość jest ustawiana tylko wtedy, gdy plan docelowy nie jest abonamentem podstawowym. |
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 ( |
| Pola | |
|---|---|
transitionState |
Tylko dane wyjściowe. [Wymagane] Bieżący stan przejścia. |
price |
Domyślna cena abonamentu podstawowego, na który zostanie przeniesiony plan. |
expectedTransitionTime |
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: |
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 ( |
| Pola | |
|---|---|
state |
Tylko dane wyjściowe. Stan zgody na podwyżkę ceny. |
consentDeadlineTime |
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: |
newPrice |
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 |
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: |
OfferDetails
Szczegóły oferty związane z elementem zamówienia zakupu.
| Zapis JSON |
|---|
{ "offerTags": [ string ], "basePlanId": string, "offerId": string } |
| Pola | |
|---|---|
offerTags[] |
Najnowsze tagi ofert powiązane z ofertą. Zawiera tagi odziedziczone z abonamentu podstawowego. |
basePlanId |
Identyfikator abonamentu podstawowego. Jest obecny we wszystkich abonamentach podstawowych i ofertach. |
offerId |
Identyfikator oferty. Widoczna tylko w przypadku ofert z rabatem. |
DeferredItemReplacement
Informacje dotyczące odroczonej wymiany produktu.
| Zapis JSON |
|---|
{ "productId": string } |
| Pola | |
|---|---|
productId |
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 ( |
| 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 |
Zastosowano kod jednorazowy. |
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 |
Kod promocyjny. |
ItemReplacement
Szczegóły dotyczące zastępowanego elementu zamówienia subskrypcji.
| Zapis JSON |
|---|
{
"productId": string,
"replacementMode": enum ( |
| Pola | |
|---|---|
productId |
Identyfikator produktu zastępowanego elementu zamówienia subskrypcji. |
replacementMode |
Tryb zastępowania zastosowany podczas zakupu. |
basePlanId |
Identyfikator abonamentu podstawowego zastępowanego elementu zamówienia subskrypcji. |
offerId |
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 ( |
| 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 |
Ustaw, gdy etap oferty jest okresem proporcjonalnym. |
freeTrial |
Ustaw, gdy etap oferty jest bezpłatnym okresem próbnym. |
introductoryPrice |
Ustaw, gdy etap oferty jest etapem oferty z ceną początkową. |
basePrice |
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 ( |
| Pola | |
|---|---|
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 |
Opcjonalnie: Identyfikator oferty utworzonej przez dewelopera, która jest kierowana na subskrypcję. |
activateTime |
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: |
OutOfAppPurchaseContext
Informacje dotyczące zakupu poza aplikacją.
| Zapis JSON |
|---|
{
"expiredExternalAccountIdentifiers": {
object ( |
| Pola | |
|---|---|
expiredExternalAccountIdentifiers |
Identyfikator konta użytkownika z ostatniej wygasłej subskrypcji dla tego SKU. |
expiredPurchaseToken |
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 ( |
| 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 |
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 |
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 ( |
| 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 |
Opcjonalnie: Płatność za odnowienie została odrzucona. |
| Koniec pól wykluczających się wzajemnie. | |
Metody |
|
|---|---|
|
Aktywuje kierowanie na konkretną ofertę. |
|
Anulowanie zakupu subskrypcji przez użytkownika. |
|
Anulowanie zmiany abonamentu subskrypcji. |
|
Dezaktywuje kierowanie na konkretną ofertę. |
|
Odracza odnowienie subskrypcji. |
|
Pobieranie metadanych subskrypcji |
|
Anulowanie zakupu subskrypcji przez użytkownika. |
|
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. |