Method: purchases.subscriptionsv2.scheduleplantransition

กำหนดเวลาการเปลี่ยนแพ็กเกจสำหรับการสมัครใช้บริการ

คำขอ HTTP

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

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

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

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

string

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

token

string

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

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

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

การแสดง 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 (DefiniteTransition)
  },
  "tentativeTransition": {
    object (TentativeTransition)
  }
  // End of mutually exclusive fields.
  "etag": string
}
ช่อง
productId

string

ต้องระบุ ผลิตภัณฑ์ที่ต้องสมัครใช้บริการ (เช่น "premium_plan") ที่ต้องกำหนดเวลาการเปลี่ยนรุ่น

earliestTransitionEffectiveTime

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"

[ต้องระบุ] โหมดสำหรับการเปลี่ยนแพ็กเกจ รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
definiteTransition

object (DefiniteTransition)

เมื่อใช้โหมดนี้ การเปลี่ยนไปใช้แพ็กเกจใหม่ของผู้ใช้จะถือเป็นที่สิ้นสุดและยกเลิกไม่ได้

tentativeTransition

object (TentativeTransition)

เมื่อใช้โหมดนี้ การเปลี่ยนไปใช้แพ็กเกจใหม่ของผู้ใช้จะเป็นแบบชั่วคราวและยกเลิกได้

สิ้นสุดฟิลด์ที่แยกกันโดยสิ้นเชิง
etag

string

หากตั้งค่าไว้ 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)
  }
}
ช่อง
planTransitionDetails

object (PlanTransitionDetails)

รายละเอียดการเปลี่ยนแพ็กเกจของรายการที่สมัครใช้บริการ

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

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

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

DefiniteTransition

ประเภทนี้ไม่มีช่อง

ใช้เพื่อระบุว่าการเปลี่ยนแพ็กเกจเป็นแบบแน่นอน

TentativeTransition

ประเภทนี้ไม่มีช่อง

ใช้เพื่อระบุว่าการเปลี่ยนแพ็กเกจเป็นแบบชั่วคราว