- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- เนื้อหาคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- DefiniteTransition
- TentativeTransition
- ลองใช้งาน
กำหนดเวลาการเปลี่ยนแพ็กเกจสำหรับการสมัครใช้บริการ
คำขอ HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:schedulePlanTransition
URL ใช้ไวยากรณ์การแปลงรหัส gRPC
พารามิเตอร์เส้นทาง
| พารามิเตอร์ | |
|---|---|
packageName |
ต้องระบุ แพ็กเกจของแอปพลิเคชันที่ซื้อการสมัครใช้บริการนี้ (เช่น "com.some.thing") |
token |
ต้องระบุ โทเค็นที่ส่งไปยังอุปกรณ์ของผู้ใช้เมื่อซื้อการสมัครใช้บริการ |
เนื้อความของคำขอ
เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
| การแสดง JSON |
|---|
{ "productId": string, "earliestTransitionEffectiveTime": string, // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "definiteTransition": { object ( |
| ช่อง | |
|---|---|
productId |
ต้องระบุ ผลิตภัณฑ์ที่ต้องสมัครใช้บริการ (เช่น "premium_plan") ที่ต้องกำหนดเวลาการเปลี่ยนรุ่น |
earliestTransitionEffectiveTime |
ต้องระบุ เวลาที่เร็วที่สุดที่การเปลี่ยนแพ็กเกจอาจมีผล การเปลี่ยนแพ็กเกจจริงจะเกิดขึ้นเมื่อถึงเวลาต่ออายุในวันที่หรือหลังจากวันที่นี้ ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น |
| [ต้องระบุ] โหมดสำหรับการเปลี่ยนแพ็กเกจ รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้ | |
definiteTransition |
เมื่อใช้โหมดนี้ การเปลี่ยนไปใช้แพ็กเกจใหม่ของผู้ใช้จะถือเป็นที่สิ้นสุดและยกเลิกไม่ได้ |
tentativeTransition |
เมื่อใช้โหมดนี้ การเปลี่ยนไปใช้แพ็กเกจใหม่ของผู้ใช้จะเป็นแบบชั่วคราวและยกเลิกได้ |
| สิ้นสุดฟิลด์ที่แยกกันโดยสิ้นเชิง | |
etag |
หากตั้งค่าไว้ API จะไม่สำเร็จหาก ETag ไม่ตรงกับ ETag ล่าสุดสำหรับการสมัครใช้บริการนี้ ระบบจะดึงข้อมูล ETag จาก purchases.subscriptionsv2.get: https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get |
เนื้อหาการตอบกลับ
การตอบกลับสำหรับ API purchases.subscriptionsv2.schedulePlanTransition
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
| การแสดง JSON |
|---|
{
"planTransitionDetails": {
object ( |
| ช่อง | |
|---|---|
planTransitionDetails |
รายละเอียดการเปลี่ยนแพ็กเกจของรายการที่สมัครใช้บริการ |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/androidpublisher
DefiniteTransition
ประเภทนี้ไม่มีช่อง
ใช้เพื่อระบุว่าการเปลี่ยนแพ็กเกจเป็นแบบแน่นอน
TentativeTransition
ประเภทนี้ไม่มีช่อง
ใช้เพื่อระบุว่าการเปลี่ยนแพ็กเกจเป็นแบบชั่วคราว