Method: purchases.subscriptionsv2.defer

เลื่อนการต่ออายุการสมัครใช้บริการ

คำขอ HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:defer

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
packageName

string

ต้องระบุ แพ็กเกจของแอปพลิเคชันที่ซื้อการสมัครใช้บริการนี้ (เช่น "com.some.thing")
token

string

ต้องระบุ โทเค็นที่มอบให้แก่อุปกรณ์ของผู้ใช้เมื่อซื้อการสมัครใช้บริการ

เนื้อความของคำขอ

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "deferralContext": {
    object (DeferralContext)
  }
}
ช่อง
deferralContext

object (DeferralContext)

ต้องระบุ รายละเอียดเกี่ยวกับการเลื่อนการสมัครใช้บริการ

เนื้อหาการตอบกลับ

การตอบกลับสำหรับ API v2 purchases.subscriptions.defer

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "itemExpiryTimeDetails": [
    {
      object (ItemExpiryTimeDetails)
    }
  ]
}
ช่อง
itemExpiryTimeDetails[]

object (ItemExpiryTimeDetails)

เวลาหมดอายุใหม่สำหรับรายการการสมัครใช้บริการแต่ละรายการ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/androidpublisher

DeferralContext

บริบทการเลื่อนการเรียกเก็บเงินของ API purchases.subscriptionsv2.defer

การแสดง JSON 
{
  "etag": string,
  "deferDuration": string,
  "validateOnly": boolean
}
ช่อง
etag

string

ต้องระบุ API จะทำงานไม่สำเร็จหาก ETag ไม่ตรงกับ ETag ล่าสุดของการสมัครใช้บริการนี้ ระบบจะดึงข้อมูล ETag จาก purchases.subscriptionsv2.get: https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get
deferDuration

string (Duration format)

ต้องระบุ ระยะเวลาที่ควรเลื่อนการเรียกเก็บเงินสำหรับรายการการสมัครใช้บริการทั้งหมด

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย "s" เช่น "3.5s"
validateOnly

boolean

หากตั้งค่าเป็น "true" คำขอจะเป็นการทดลองเรียกใช้เพื่อตรวจสอบผลของ subscriptionsv2.defer โดยการสมัครใช้บริการจะไม่ได้รับผลกระทบ

ItemExpiryTimeDetails

รายละเอียดเวลาหมดอายุของรายการการสมัครใช้บริการ

การแสดง JSON 
{
  "productId": string,
  "expiryTime": string
}
ช่อง
productId

string

รหัสผลิตภัณฑ์ของสินค้าที่ต้องสมัครใช้บริการ (เช่น "premium_plan")
expiryTime

string (Timestamp format)

เวลาหมดอายุใหม่สำหรับรายการการสมัครใช้บริการนี้

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"