- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- SubscriptionDeferralInfo
- ลองใช้งาน
เลื่อนการซื้อการสมัครใช้บริการของผู้ใช้ออกไปจนกว่าจะถึงเวลาหมดอายุที่ระบุไว้ในอนาคต
คำขอ HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:defer
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
| พารามิเตอร์ | |
|---|---|
| packageName | 
 ชื่อแพ็กเกจของแอปพลิเคชันที่ซื้อการสมัครใช้บริการนี้ (เช่น "com.some.thing") | 
| subscriptionId | 
 รหัสการสมัครใช้บริการที่ซื้อ (เช่น "monthly001") | 
| token | 
 โทเค็นที่ระบุให้กับอุปกรณ์ของผู้ใช้เมื่อซื้อการสมัครใช้บริการ | 
เนื้อความของคำขอ
เนื้อความของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
| การแสดง JSON | 
|---|
| {
  "deferralInfo": {
    object ( | 
| ช่อง | |
|---|---|
| deferralInfo | 
 ข้อมูลเกี่ยวกับเวลาหมดอายุใหม่ที่ต้องการสำหรับการสมัครใช้บริการ | 
เนื้อหาการตอบกลับ
การตอบกลับสําหรับ purchases.subscriptions.defer API
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
| การแสดง JSON | 
|---|
| { "newExpiryTimeMillis": string } | 
| ช่อง | |
|---|---|
| newExpiryTimeMillis | 
 เวลาหมดอายุใหม่ของการสมัครใช้บริการเป็นมิลลิวินาทีนับตั้งแต่เริ่มต้น | 
ตัวอย่าง
ตัวอย่างคําขอมีดังนี้
curl -X POST \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "deferralInfo": { "desiredExpiryTimeMillis": "1735689600000", "expectedExpiryTimeMillis": "1704067200000" } }' \ 'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptions/monthly.premium.v1/tokens/aBcDeFgHiJkLmNoPqRsTuVwXyZaBcDeFgHiJkLmNoPqRsTuVwXyZ.1234567890:defer'
ตัวอย่างคำตอบมีดังนี้
{ "newExpiryTimeMillis": "1776004800000" }
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
- https://www.googleapis.com/auth/androidpublisher
SubscriptionDeferralInfo
SubscriptionDeferralInfo มีข้อมูลที่จําเป็นสําหรับเลื่อนการซื้อการสมัครใช้บริการไปจนกว่าจะถึงเวลาหมดอายุในอนาคต
| การแสดง JSON | 
|---|
| { "expectedExpiryTimeMillis": string, "desiredExpiryTimeMillis": string } | 
| ช่อง | |
|---|---|
| expectedExpiryTimeMillis | 
 เวลาหมดอายุที่คาดไว้ของการสมัครใช้บริการ หากเวลาหมดอายุปัจจุบันของการสมัครใช้บริการไม่ใช่ค่าที่ระบุไว้ที่นี่ การเลื่อนเวลาจะไม่เกิดขึ้น | 
| desiredExpiryTimeMillis | 
 เวลาหมดอายุครั้งถัดไปที่ต้องการกำหนดให้กับการสมัครใช้บริการเป็นมิลลิวินาทีนับจาก Epoch เวลาที่กำหนดต้องอยู่หลัง/มากกว่าเวลาหมดอายุปัจจุบันของการสมัครใช้บริการ |