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

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

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

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

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

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