Kullanımdan Kaldırmalar

Bu belgede, desteği sonlandırılma sürecindeki Google Play Developer API'leri ve ilgili özellikler listelenmiştir.

Desteği sonlandırma zaman çizelgesi - 21 Mayıs 2025 - 31 Ağustos 2027

Bu bölümdeki özelliklerin ve API'lerin desteği 21 Mayıs 2025'te sonlandırılacak ve 31 Ağustos 2027'de kullanımdan kaldırılacak. Ancak desteği sonlandırılan öğeler için 1 Kasım 2027'ye kadar ek süre kullanabilirsiniz.

Kullanımdan kaldırılan abonelik API'leri

Bu bölümde, API desteğinin sonlandırıldığı özellikler listelenmiştir.

API Kullanılabilir değişim cihazı
subscriptions.get subscriptionsv2.get
subscriptions.refund SubscriptionPurchaseLineItem almak için subscriptionsv2.get'i çağırın. latest_successful_order_id, ardından siparişlerin geri ödemesini yapmak için Orders.refund işlevini çağırın.
subscriptions.revoke subscriptionsv2.revoke
SubscriptionPurchaseV2. latestOrderId SubscriptionPurchaseLineItem. latest_successful_order_id
RealTimeDeveloperNotification. SubscriptionNotification.subscriptionId Değişim yok
RealTimeDeveloperNotification. SubscriptionNotification. notificationType SUBSCRIPTION_PRICE_CHANGE_CONFIRMED SUBSCRIPTION_PRICE _CHANGE_UPDATED

Yinelenen abonelikler için SubscriptionPurchaseV2 alanları

purchases.subscriptionv2, yeni abonelik nesneleri hakkında daha fazla ayrıntı sağlayan yeni alanlar içerir. Aşağıdaki tabloda, eski abonelik uç noktasındaki alanların purchases.subscriptionv2'teki ilgili alanlarla nasıl eşlendiği gösterilmektedir.

SubscriptionPurchase SubscriptionPurchaseV2
countryCode regionCode
orderId SubscriptionPurchaseLineItem.latest_successful_order_id
(eşdeğer alan yok) Satın alma işlemiyle edinilen ürünleri temsil eden lineItems (SubscriptionPurchaseLineItem listesi)
(eşdeğer alan yok) lineItems.offerDetails.basePlanId
(eşdeğer alan yok) lineItems.offerDetails.offerId
(eşdeğer alan yok) lineItems.offerDetails.offerTags
startTimeMillis startTime
expiryTimeMillis lineItems.expiryTime (satın alma işleminde edinilen her aboneliğin kendi expiryTime değeri vardır)
(eşdeğer alan yok) subscriptionState (aboneliğin durumunu gösterir)
(eşdeğer alan yok) pausedStateContext (yalnızca abonelik durumu SUBSCRIPTION_STATE_PAUSED ise mevcuttur)
autoResumeTimeMillis pausedStateContext.autoResumeTime
(eşdeğer alan yok) canceledStateContext (yalnızca abonelik durumu SUBSCRIPTION_STATE_CANCELED ise mevcuttur)
(eşdeğer alan yok) testPurchase (yalnızca lisanslı test kullanıcısı satın alma işlemlerinde bulunur)
autoRenewing lineItems.autoRenewingPlan.autoRenewEnabled
priceCurrenceCode, priceAmountMicros lineItems.autoRenewingPlan.recurringPrice
introductoryPriceInfo (eşdeğer alan yok)
Bu bilgiler, satın alınan aboneliklerin her birinin offer bölümünde bulunabilir.
developerPayload (no equivalent field) developer payload desteği sonlandırıldı
paymentState (eşdeğer alan yok)
Ödeme durumunu subscriptionState'dan anlayabilirsiniz:
  • Ödeme beklemede:
    • SUBSCRIPTION_STATE_PENDING (beklemedeki işlemle yeni satın alma işlemleri)
    • SUBSCRIPTION_STATE_IN_GRACE_PERIOD
    • SUBSCRIPTION_STATE_ON_HOLD
  • Ödeme alındı:
    • SUBSCRIPTION_STATE_ACTIVE
  • Ücretsiz deneme:
    • Orders.get API'sini kullanarak getirebileceğiniz Order.line_items.subscription_details.offer_phase alanı.
  • Ertelenen yükseltme / düşürme:
    • SUBSCRIPTION_STATE_PENDING
cancelReason, userCancellationTimeMillis, cancelSurveyResult canceledStateContext
linkedPurchaseToken linkedPurchaseToken (değişiklik yok)
purchaseType Test: testPurchase
üzerinden Promosyon: signupPromotion
priceChange lineItems.autoRenewingPlan.priceChangeDetails
profileName, emailAddress, givenName, familyName, profileId subscribeWithGoogleInfo
acknowledgementState acknowledgementState (no change)
promotionType, promotionCode signupPromotion
externalAccountId, obfuscatedExternalAccountId, obfuscatedExteranlProfileId externalAccountIdentifiers

Diğer abonelik yönetimi işlevleri

purchases.subscriptions:get, purchases.subscriptionsv2:get sürümüne yükseltilmiş olsa da geliştirici aboneliği yönetimi işlevlerinin geri kalanı purchases.subscriptions uç noktasında şimdilik değişmeden kalacak. Bu nedenle, purchases.subscriptions:acknowledge, purchases.subscriptions:cancel, purchases.subscriptions:defer, purchases.subscriptions:refund ve purchases.subscriptions:revoke işlevlerini daha önce olduğu gibi kullanmaya devam edebilirsiniz.