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

เอกสารนี้แสดงรายการ 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.offerPhase` (ระบุเฟสปัจจุบัน: ช่วงทดลองใช้ฟรี ราคาช่วงแนะนำ การปรับตามสัดส่วน ราคาฐาน)
(ไม่มีฟิลด์ที่เทียบเท่า)	`lineItems` (list of 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`	`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 การอัปเกรด / ดาวน์เกรดที่เลื่อนออกไป `SUBSCRIPTION_STATE_PENDING`
`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 ได้ต่อไปเช่นเดิม