Penghentian Penggunaan

Dokumen ini mencantumkan Google Play Developer API dan fitur terkait yang berada dalam periode penghentian penggunaan.

Linimasa penghentian penggunaan - 21 Mei 2025 hingga 31 Agustus 2027

Fitur dan API di bagian ini tidak digunakan lagi mulai 21 Mei 2025, dan akan dinonaktifkan pada 31 Agustus 2027. Namun, Anda dapat menggunakan ekstensi untuk item yang tidak digunakan lagi hingga 1 November 2027.

API langganan yang tidak digunakan lagi

Bagian ini mencantumkan penghentian API.

API Penggantian yang tersedia
subscriptions.get subscriptionsv2.get
subscriptions.refund Panggil subscriptionsv2.get untuk mendapatkan SubscriptionPurchaseLineItem. latest_successful_order_id, lalu panggil Orders.refund untuk mengembalikan dana pesanan.
subscriptions.revoke subscriptionsv2.revoke
SubscriptionPurchaseV2. latestOrderId SubscriptionPurchaseLineItem. latest_successful_order_id
RealTimeDeveloperNotification. SubscriptionNotification.subscriptionId Tidak ada penggantian
RealTimeDeveloperNotification. SubscriptionNotification. notificationType SUBSCRIPTION_PRICE_CHANGE_CONFIRMED SUBSCRIPTION_PRICE _CHANGE_UPDATED

Kolom SubscriptionPurchaseV2 untuk langganan berulang

purchases.subscriptionv2 berisi kolom baru yang memberikan detail selengkapnya tentang objek langganan baru. Tabel berikut menunjukkan cara kolom dari endpoint langganan lama dipetakan ke kolom yang sesuai dalam purchases.subscriptionv2.

SubscriptionPurchase SubscriptionPurchaseV2
countryCode regionCode
orderId SubscriptionPurchaseLineItem.latest_successful_order_id
(tidak ada kolom yang setara) lineItems (daftar SubscriptionPurchaseLineItem) yang mewakili produk yang diperoleh dengan pembelian
(tidak ada kolom yang setara) lineItems.offerDetails.basePlanId
(tidak ada kolom yang setara) lineItems.offerDetails.offerId
(tidak ada kolom yang setara) lineItems.offerDetails.offerTags
startTimeMillis startTime
expiryTimeMillis lineItems.expiryTime (setiap langganan yang diperoleh dalam pembelian memiliki expiryTime-nya sendiri)
(tidak ada kolom yang setara) subscriptionState (menunjukkan status langganan)
(tidak ada kolom yang setara) pausedStateContext (hanya ada jika status langganan adalah SUBSCRIPTION_STATE_PAUSED)
autoResumeTimeMillis pausedStateContext.autoResumeTime
(tidak ada kolom yang setara) canceledStateContext (hanya ada jika status langganan adalah SUBSCRIPTION_STATE_CANCELED)
(tidak ada kolom yang setara) testPurchase (hanya ada dalam pembelian penguji berlisensi)
autoRenewing lineItems.autoRenewingPlan.autoRenewEnabled
priceCurrenceCode, priceAmountMicros lineItems.autoRenewingPlan.recurringPrice
introductoryPriceInfo (tidak ada kolom yang setara)
Informasi ini dapat ditemukan di offer untuk setiap langganan yang dibeli.
developerPayload (tidak ada kolom yang setara) payload developer tidak digunakan lagi
paymentState (tidak ada kolom yang setara)
Anda dapat menyimpulkan status pembayaran dari subscriptionState:
  • Pembayaran tertunda:
    • SUBSCRIPTION_STATE_PENDING (pembelian baru dengan transaksi tertunda)
    • SUBSCRIPTION_STATE_IN_GRACE_PERIOD
    • SUBSCRIPTION_STATE_ON_HOLD
  • Pembayaran telah diterima:
    • SUBSCRIPTION_STATE_ACTIVE
  • Uji coba gratis:
    • Kolom Order.line_items.subscription_details.offer_phase yang dapat Anda ambil dengan Orders.get API.
  • Upgrade/downgrade yang ditangguhkan:
    • SUBSCRIPTION_STATE_PENDING
cancelReason, userCancellationTimeMillis, cancelSurveyResult canceledStateContext
linkedPurchaseToken linkedPurchaseToken (tidak ada perubahan)
purchaseType Pengujian: melalui testPurchase
Promosi: signupPromotion
priceChange lineItems.autoRenewingPlan.priceChangeDetails
profileName, emailAddress, givenName, familyName, profileId subscribeWithGoogleInfo
acknowledgementState acknowledgementState (no change)
promotionType, promotionCode signupPromotion
externalAccountId, obfuscatedExternalAccountId, obfuscatedExteranlProfileId externalAccountIdentifiers

Fungsi pengelolaan langganan lainnya

Saat purchases.subscriptions:get telah diupgrade ke purchases.subscriptionsv2:get, fungsi pengelolaan langganan developer lainnya tetap tidak berubah untuk saat ini di endpoint purchases.subscriptions, sehingga Anda dapat terus menggunakan purchases.subscriptions:acknowledge, purchases.subscriptions:cancel, purchases.subscriptions:defer, purchases.subscriptions:refund, dan purchases.subscriptions:revoke seperti yang Anda lakukan sebelumnya.