การเลิกใช้งาน

เอกสารนี้แสดง Google Play Developer API และฟีเจอร์ที่เกี่ยวข้องซึ่งอยู่ในช่วงเลิกใช้งาน

ไทม์ไลน์การเลิกใช้งาน - 19 พฤษภาคม 2026 ถึง 31 สิงหาคม 2028

ฟีเจอร์และ API ในส่วนนี้จะเลิกใช้งานตั้งแต่วันที่ 19 พฤษภาคม 2026 และจะปิดให้บริการในวันที่ 31 สิงหาคม 2028 สำหรับรายการที่เลิกใช้งานแล้ว คุณสามารถขอ ขยายเวลาได้จนถึงวันที่ 1 พฤศจิกายน 2028 โดยส่งคำขอแจ้งปัญหาผ่าน ทาง Play Console > ความช่วยเหลือ

API การสมัครใช้บริการที่เลิกใช้งานแล้ว

ส่วนนี้แสดงรายการ API ที่เลิกใช้งานแล้ว

API รายการทดแทนที่ใช้ได้
subscriptions.cancel subscriptionsv2.cancel
subscriptions.defer subscriptionsv2.defer
Order.lineItems.subscriptionDetails.offer_phase Order.lineItems.subscriptionDetails.offer_phase_details

ไทม์ไลน์การเลิกใช้งาน - 21 พฤษภาคม 2025 ถึง 31 สิงหาคม 2027

ฟีเจอร์และ API ในส่วนนี้จะเลิกใช้งานตั้งแต่วันที่ 21 พฤษภาคม 2025 และจะปิดให้บริการในวันที่ 31 สิงหาคม 2027 สำหรับรายการที่เลิกใช้งานแล้ว คุณสามารถขอขยายเวลาได้จนถึงวันที่ 1 พฤศจิกายน 2027 โดยส่งคำขอแจ้งปัญหาผ่าน Play Console > ความช่วยเหลือ

API การสมัครใช้บริการที่เลิกใช้งานแล้ว

ส่วนนี้แสดงรายการ API ที่เลิกใช้งานแล้ว

API รายการทดแทนที่ใช้ได้
subscriptions.get subscriptionsv2.get
subscriptions.refund เรียก subscriptionsv2.get เพื่อรับ SubscriptionPurchaseLineItem latest_successful_order_id, แล้วเรียก Orders.refund เพื่อคืนเงินคำสั่งซื้อ
subscriptions.revoke subscriptionsv2.revoke
SubscriptionPurchaseV2. latestOrderId SubscriptionPurchaseLineItem. latest_successful_order_id
RealTimeDeveloperNotification. SubscriptionNotification.subscriptionId ไม่มีรายการทดแทน
RealTimeDeveloperNotification. SubscriptionNotification. notificationType SUBSCRIPTION_PRICE_CHANGE_CONFIRMED SUBSCRIPTION_PRICE _CHANGE_UPDATED

ช่อง SubscriptionPurchaseV2 สำหรับการสมัครใช้บริการแบบต่อเนื่อง

purchases.subscriptionv2 มีช่องใหม่ที่ให้รายละเอียดเพิ่มเติมเกี่ยวกับออบเจ็กต์การสมัครใช้บริการใหม่ ตารางต่อไปนี้แสดงวิธีที่ช่องจากปลายทางการสมัครใช้บริการเดิมแมปกับช่องที่เกี่ยวข้องใน purchases.subscriptionv2

SubscriptionPurchase SubscriptionPurchaseV2
countryCode regionCode
orderId lineItems.latestSuccessfulOrderId
คุณสามารถรับรหัสคำสั่งซื้อที่รอดำเนินการได้จาก inGracePeriodStateContext.renewalDeclined.pendingOrderId หรือ onHoldStateContext.renewalDeclined.pendingOrderId
startTimeMillis startTime
expiryTimeMillis lineItems.expiryTime (การสมัครใช้บริการแต่ละรายการที่ได้มาจากการซื้อจะมี expiryTime ของตัวเอง)
autoResumeTimeMillis pausedStateContext.autoResumeTime
autoRenewing lineItems.autoRenewingPlan.autoRenewEnabled
priceCurrenceCode, priceAmountMicros lineItems.autoRenewingPlan.recurringPrice
introductoryPriceInfo lineItems.offerPhase.introductoryPrice
นอกจากนี้ คุณยังดูข้อมูลนี้ได้ใน offer สำหรับ การสมัครใช้บริการแต่ละรายการที่ซื้อ
developerPayload (ไม่มีช่องที่เทียบเท่า) เพย์โหลดของนักพัฒนาแอปเลิกใช้งานแล้ว
paymentState (ไม่มีช่องที่เทียบเท่า)
คุณสามารถอนุมานสถานะการชำระเงินได้จาก subscriptionState:
  • การชำระเงินรอดำเนินการ:
    • SUBSCRIPTION_STATE_PENDING (การซื้อใหม่ที่มีธุรกรรมรอดำเนินการ)
    • SUBSCRIPTION_STATE_IN_GRACE_PERIOD
    • SUBSCRIPTION_STATE_ON_HOLD
  • ได้รับการชำระเงินแล้ว:
    • SUBSCRIPTION_STATE_ACTIVE
  • ช่วงทดลองใช้ฟรี:
    • lineItems.offerPhase.freeTrial
  • การอัปเกรด / ดาวน์เกรดที่เลื่อนออกไป:
    • lineItems.deferredItemReplacement
cancelReason, userCancellationTimeMillis, cancelSurveyResult canceledStateContext
linkedPurchaseToken linkedPurchaseToken (ไม่มีการเปลี่ยนแปลง)
purchaseType การทดสอบ: ผ่าน testPurchase
โปรโมชัน: signupPromotion
priceChange lineItems.autoRenewingPlan.priceChangeDetails
profileName, emailAddress, givenName, familyName, profileId subscribeWithGoogleInfo
acknowledgementState acknowledgementState (no change)
promotionType, promotionCode signupPromotion
externalAccountId, obfuscatedExternalAccountId, obfuscatedExteranlProfileId externalAccountIdentifiers