Method: purchases.subscriptions.defer

เลิกใช้งานแล้ว: โปรดใช้ purchases.subscriptionsv2.defer แทน เลื่อนการซื้อการสมัครใช้บริการของผู้ใช้จนกว่าจะถึงเวลาหมดอายุที่ระบุไว้ในอนาคต

คำขอ HTTP

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

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

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

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

string

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

string

รหัสการสมัครใช้บริการที่ซื้อ (เช่น "monthly001")
token

string

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

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

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

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

object (SubscriptionDeferralInfo)

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

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

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

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

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

string (int64 format)

เวลาหมดอายุใหม่ของการสมัครใช้บริการเป็นมิลลิวินาทีนับตั้งแต่ Epoch

ตัวอย่าง

ตัวอย่างคำขอมีดังนี้

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

string (int64 format)

เวลาหมดอายุที่คาดไว้ของการสมัครใช้บริการ หากเวลาหมดอายุปัจจุบันของการสมัครใช้บริการไม่ใช่ค่าที่ระบุไว้ที่นี่ ระบบจะไม่เลื่อนเวลา
desiredExpiryTimeMillis

string (int64 format)

เวลาหมดอายุถัดไปที่ต้องการกำหนดให้กับการสมัครใช้บริการเป็นมิลลิวินาทีตั้งแต่ Epoch เวลาที่ระบุต้องอยู่หลัง/มากกว่าเวลาหมดอายุปัจจุบันของการสมัครใช้บริการ