Wycofane

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

Harmonogram wycofywania usługi: 21 maja 2025 r. – 31 sierpnia 2027 r.

Funkcje i interfejsy API w tej sekcji zostaną wycofane 21 maja 2025 r. i wyłączone 31 sierpnia 2027 r. Możesz jednak skorzystać z przedłużenia okresu obowiązywania wycofanych elementów do 1 listopada 2027 roku.

Wycofane interfejsy API subskrypcji

Ta sekcja zawiera listę wycofanych interfejsów API.

Interfejs API Dostępna wymiana
subscriptions.get subscriptionsv2.get
subscriptions.refund Wywołaj subscriptionsv2.get, aby pobrać SubscriptionPurchaseLineItem. latest_successful_order_id, a następnie wywołaj funkcję 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 starszego punktu końcowego subskrypcji są mapowane na odpowiednie pola w purchases.subscriptionv2.

SubscriptionPurchase SubscriptionPurchaseV2
countryCode regionCode
orderId SubscriptionPurchaseLineItem.latest_successful_order_id
(brak odpowiednika) lineItems.offerPhase (określa bieżący etap: bezpłatny okres próbny, cena początkowa, proporcjonalna cena, cena bazowa)
(brak odpowiednika) lineItems (lista SubscriptionPurchaseLineItem) reprezentująca 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 expiryTime)
(brak odpowiednika) subscriptionState (wskazuje stan subskrypcji)
(brak odpowiednika) pausedStateContext (występuje tylko wtedy, gdy stan subskrypcji to SUBSCRIPTION_STATE_PAUSED)
autoResumeTimeMillis pausedStateContext.autoResumeTime
(brak odpowiednika) canceledStateContext (występuje tylko wtedy, gdy stan subskrypcji to SUBSCRIPTION_STATE_CANCELED)
(brak odpowiednika) testPurchase (występuje tylko w przypadku zakupów licencjonowanych testerów)
autoRenewing lineItems.autoRenewingPlan.autoRenewEnabled
priceCurrenceCode, priceAmountMicros lineItems.autoRenewingPlan.recurringPrice
introductoryPriceInfo lineItems.offerPhase.introductoryPrice
Te informacje znajdziesz też w offer dla każdej kupionej subskrypcji.
developerPayload Pole (no equivalent field) developer payload zostało wycofane
paymentState (brak odpowiedniego pola)
Stan płatności możesz wywnioskować z pola subscriptionState:
  • Płatność oczekuje na realizację:
    • SUBSCRIPTION_STATE_PENDING (nowe zakupy z transakcją oczekującą)
    • SUBSCRIPTION_STATE_IN_GRACE_PERIOD
    • SUBSCRIPTION_STATE_ON_HOLD
  • Płatność została otrzymana:
    • SUBSCRIPTION_STATE_ACTIVE
  • Bezpłatny okres próbny:
    • lineItems.offerPhase.freeTrial
  • Odroczone uaktualnienie lub przejście na niższą wersję:
    • 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 subskrypcjami

Usługa purchases.subscriptions:get została uaktualniona do wersji purchases.subscriptionsv2:get, ale pozostałe funkcje zarządzania subskrypcją dewelopera pozostają na razie bez zmian w punkcie końcowym purchases.subscriptions, dlatego możesz nadal używać purchases.subscriptions:acknowledge, purchases.subscriptions:cancel, purchases.subscriptions:defer, purchases.subscriptions:refundpurchases.subscriptions:revoke w taki sam sposób jak wcześniej.