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

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

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

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

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

ส่วนนี้แสดงรายการ 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 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 ไม่มี API ที่ใช้แทนได้
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