Wycofane

Ten dokument zawiera listę interfejsów Google Play Developer API i powiązanych funkcji, które są w okresie wycofania.

Harmonogram wycofywania – od 19 maja 2026 r. do 31 sierpnia 2028 r.

Funkcje i interfejsy API wymienione w tej sekcji są wycofywane od 19 maja 2026 r. Zostaną one wyłączone 31 sierpnia 2028 r. Możesz jednak skorzystać z przedłużenia okresu wycofania do 1 listopada 2028 r.

Wycofane interfejsy API subskrypcji

Ta sekcja zawiera listę wycofanych interfejsów API.

Interfejs API Dostępny zamiennik
subscriptions.cancel subscriptionsv2.cancel
subscriptions.defer subscriptionsv2.defer
Order.lineItems.subscriptionDetails.offer_phase Order.lineItems.subscriptionDetails.offer_phase_details

Harmonogram wycofywania – od 21 maja 2025 r. do 31 sierpnia 2027 r.

Funkcje i interfejsy API wymienione w tej sekcji są wycofywane od 21 maja 2025 r. Zostaną one wyłączone 31 sierpnia 2027 r. Możesz jednak skorzystać z przedłużenia okresu wycofania do 1 listopada 2027 r.

Wycofane interfejsy API subskrypcji

Ta sekcja zawiera listę wycofanych interfejsów API.

Interfejs API Dostępny zamiennik
subscriptions.get subscriptionsv2.get
subscriptions.refund Aby uzyskać SubscriptionPurchaseLineItem, wywołaj subscriptionsv2.get. latest_successful_order_id, a następnie wywołaj Orders.refund, aby zwrócić środki za zamówienia.
subscriptions.revoke subscriptionsv2.revoke
SubscriptionPurchaseV2. latestOrderId SubscriptionPurchaseLineItem. latest_successful_order_id
RealTimeDeveloperNotification. SubscriptionNotification.subscriptionId Brak zamiennika
RealTimeDeveloperNotification. SubscriptionNotification. notificationType SUBSCRIPTION_PRICE_CHANGE_CONFIRMED SUBSCRIPTION_PRICE _CHANGE_UPDATED

Pola SubscriptionPurchaseV2 w przypadku subskrypcji cyklicznych

purchases.subscriptionv2 zawiera nowe pola, które dostarczają więcej szczegółów o nowych obiektach subskrypcji. W tabeli poniżej pokazujemy, jak pola z dotychczasowego punktu końcowego subskrypcji są mapowane na odpowiednie pola w purchases.subscriptionv2.

SubscriptionPurchase SubscriptionPurchaseV2
countryCode regionCode
orderId lineItems.latestSuccessfulOrderId
Identyfikator oczekującego zamówienia możesz uzyskać z inGracePeriodStateContext.renewalDeclined.pendingOrderId lub onHoldStateContext.renewalDeclined.pendingOrderId.
startTimeMillis startTime
expiryTimeMillis lineItems.expiryTime (każda subskrypcja kupiona w ramach zakupu ma własny expiryTime)
autoResumeTimeMillis pausedStateContext.autoResumeTime
autoRenewing lineItems.autoRenewingPlan.autoRenewEnabled
priceCurrenceCode, priceAmountMicros lineItems.autoRenewingPlan.recurringPrice
introductoryPriceInfo lineItems.offerPhase.introductoryPrice
Te informacje można też znaleźć w offer dla każdej zakupionej subskrypcji.
developerPayload (brak odpowiedniego pola) pole developerPayload zostało wycofane
paymentState (brak odpowiedniego pola)
Stan płatności możesz wywnioskować z subscriptionState:
  • Płatność oczekuje:
    • SUBSCRIPTION_STATE_PENDING (nowe zakupy z oczekującą transakcją)
    • SUBSCRIPTION_STATE_IN_GRACE_PERIOD
    • SUBSCRIPTION_STATE_ON_HOLD
  • Płatność została otrzymana:
    • SUBSCRIPTION_STATE_ACTIVE
  • Bezpłatna wersja próbna:
    • lineItems.offerPhase.freeTrial
  • Odroczone uaktualnienie lub obniżenie wersji:
    • lineItems.deferredItemReplacement
cancelReason, userCancellationTimeMillis, cancelSurveyResult canceledStateContext
linkedPurchaseToken linkedPurchaseToken (bez zmian)
purchaseType Test: przez testPurchase
Promocja: signupPromotion
priceChange lineItems.autoRenewingPlan.priceChangeDetails
profileName, emailAddress, givenName, familyName, profileId subscribeWithGoogleInfo
acknowledgementState acknowledgementState (no change)
promotionType, promotionCode signupPromotion
externalAccountId, obfuscatedExternalAccountId, obfuscatedExteranlProfileId externalAccountIdentifiers