Wycofane

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

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

Funkcje i interfejsy API opisane w tej sekcji zostały wycofane 21 maja 2025 r. i zostaną wyłączone 31 sierpnia 2027 r. Możesz jednak skorzystać z przedłużenia ważności dla wycofanych elementów do 1 listopada 2027 r.

Wycofane interfejsy API subskrypcji

Ta sekcja zawiera listę wycofanych interfejsów API.

Interfejs API Dostępna wymiana
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 wymiany
RealTimeDeveloperNotification. SubscriptionNotification. notificationType SUBSCRIPTION_PRICE_CHANGE_CONFIRMED SUBSCRIPTION_PRICE _CHANGE_UPDATED

Pola SubscriptionPurchaseV2 dla subskrypcji cyklicznych

purchases.subscriptionv2 zawiera nowe pola, które zawierają więcej informacji o nowych obiektach subskrypcji. Poniższa tabela pokazuje, jak pola z końcowego punktu obsługi subskrypcji w starszej wersji są mapowane na odpowiadające im pola w purchases.subscriptionv2.

SubscriptionPurchase SubscriptionPurchaseV2
countryCode regionCode
orderId SubscriptionPurchaseLineItem.latest_successful_order_id
(brak odpowiednika) lineItems (lista obiektów SubscriptionPurchaseLineItem) reprezentujących produkty nabyte w ramach zakupu
(brak odpowiednika) lineItems.offerDetails.basePlanId
(brak odpowiednika) lineItems.offerDetails.offerId
(brak odpowiednika) lineItems.offerDetails.offerTags
startTimeMillis startTime
expiryTimeMillis lineItems.expiryTime (każda subskrypcja uzyskana w ramach zakupu ma własny identyfikator expiryTime)
(brak odpowiednika) subscriptionState (wskazuje stan subskrypcji)
(brak odpowiednika) pausedStateContext (obecny tylko wtedy, gdy stan subskrypcji to SUBSCRIPTION_STATE_PAUSED)
autoResumeTimeMillis pausedStateContext.autoResumeTime
(brak odpowiednika) canceledStateContext (obecny tylko wtedy, gdy stan subskrypcji to SUBSCRIPTION_STATE_CANCELED)
(brak odpowiednika) testPurchase (tylko w przypadku zakupów dokonanych przez licencjonowanych testerów)
autoRenewing lineItems.autoRenewingPlan.autoRenewEnabled
priceCurrenceCode, priceAmountMicros lineItems.autoRenewingPlan.recurringPrice
introductoryPriceInfo (brak pola odpowiadającego)
Informacje te można znaleźć w offer dla każdej z kupionych subskrypcji.
developerPayload (brak odpowiednika) Dane dewelopera zostały wycofane
paymentState (brak pola odpowiadającego)
Stan płatności możesz określić na podstawie pola subscriptionState:
  • Płatność oczekuje:
    • SUBSCRIPTION_STATE_PENDING (nowe zakupy z oczekującą transakcją)
    • SUBSCRIPTION_STATE_IN_GRACE_PERIOD
    • SUBSCRIPTION_STATE_ON_HOLD
  • Otrzymano płatność:
    • SUBSCRIPTION_STATE_ACTIVE
  • Bezpłatny okres próbny:
    • Pole Order.line_items.subscription_details.offer_phase, które możesz pobrać za pomocą interfejsu Orders.get API.
  • Odłożone uaktualnienie lub obniżenie poziomu:
    • SUBSCRIPTION_STATE_PENDING
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

Inne funkcje zarządzania subskrypcją

Chociaż usługa purchases.subscriptions:get została zaktualizowana do wersji purchases.subscriptionsv2:get, pozostałe funkcje zarządzania subskrypcją dewelopera pozostają na razie bez zmian w punkcie końcowym purchases.subscriptions, więc możesz nadal używać opcji purchases.subscriptions:acknowledge, purchases.subscriptions:cancel, purchases.subscriptions:defer, purchases.subscriptions:refundpurchases.subscriptions:revoke.