เอกสารนี้จะแสดง Google Play Developer API และฟีเจอร์ที่เกี่ยวข้องซึ่งอยู่ในระยะเวลาเลิกใช้งาน
ลำดับเวลาการเลิกใช้งาน - 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 |
SubscriptionPurchaseLineItem.latest_successful_order_id |
| (ไม่มีฟิลด์ที่เทียบเท่า) | lineItems (รายการ
SubscriptionPurchaseLineItem)
ที่แสดงถึงผลิตภัณฑ์ที่ได้มาจากการซื้อ |
| (ไม่มีฟิลด์ที่เทียบเท่า) | lineItems.offerDetails.basePlanId |
| (ไม่มีฟิลด์ที่เทียบเท่า) | lineItems.offerDetails.offerId |
| (ไม่มีฟิลด์ที่เทียบเท่า) | lineItems.offerDetails.offerTags |
startTimeMillis |
startTime |
expiryTimeMillis |
lineItems.expiryTime (การสมัครใช้บริการแต่ละรายการที่ซื้อจะมี expiryTime ของตนเอง) |
| (ไม่มีฟิลด์ที่เทียบเท่า) | subscriptionState (ระบุสถานะของการสมัครใช้บริการ) |
| (ไม่มีฟิลด์ที่เทียบเท่า) | pausedStateContext (แสดงเฉพาะในกรณีที่สถานะการสมัครใช้บริการเป็น SUBSCRIPTION_STATE_PAUSED) |
autoResumeTimeMillis |
pausedStateContext.autoResumeTime |
| (ไม่มีฟิลด์ที่เทียบเท่า) | canceledStateContext (แสดงเฉพาะในกรณีที่สถานะการสมัครใช้บริการเป็น SUBSCRIPTION_STATE_CANCELED) |
| (ไม่มีฟิลด์ที่เทียบเท่า) | testPurchase (มีเฉพาะในการซื้อของผู้ทดสอบที่ได้รับอนุญาตเท่านั้น) |
autoRenewing |
lineItems.autoRenewingPlan.autoRenewEnabled |
priceCurrenceCode,
priceAmountMicros |
lineItems.autoRenewingPlan.recurringPrice |
introductoryPriceInfo |
(ไม่มีช่องที่เทียบเท่า) ดูข้อมูลนี้ได้ใน offer สำหรับการสมัครใช้บริการแต่ละรายการที่ซื้อ |
| developerPayload | (ไม่มีช่องที่เทียบเท่า) เลิกใช้งานเพย์โหลดของนักพัฒนาแอปแล้ว |
| paymentState | (ไม่มีช่องที่เทียบเท่า) คุณสามารถอนุมานสถานะการชำระเงินจาก subscriptionState ดังนี้
|
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 |
ฟังก์ชันการจัดการการสมัครใช้บริการอื่นๆ
แม้ว่าเราจะอัปเกรด purchases.subscriptions:get ไปใช้ purchases.subscriptionsv2:get แล้ว แต่ฟังก์ชันการจัดการการสมัครใช้บริการของนักพัฒนาแอปที่เหลือจะยังคงเหมือนเดิมในปลายทาง purchases.subscriptions ในระหว่างนี้ คุณจึงใช้ purchases.subscriptions:acknowledge, purchases.subscriptions:cancel, purchases.subscriptions:defer, purchases.subscriptions:refund และ purchases.subscriptions:revoke ได้ต่อไปตามปกติ