Method: purchases.subscriptionsv2.scheduleplantransition

Lên lịch chuyển đổi gói cho một gói thuê bao.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
packageName

string

Bắt buộc. Gói của ứng dụng mà gói thuê bao này được mua (ví dụ: "com.some.thing").

token

string

Bắt buộc. Mã thông báo được cung cấp cho thiết bị của người dùng khi người dùng mua gói thuê bao.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng 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
}
Trường
productId

string

Bắt buộc. Sản phẩm thuê bao (ví dụ: "premium_plan") mà bạn phải lên lịch chuyển đổi.

earliestTransitionEffectiveTime

string (Timestamp format)

Bắt buộc. Thời điểm sớm nhất mà quá trình chuyển đổi gói có thể có hiệu lực. Quá trình chuyển đổi thực tế sẽ diễn ra vào thời điểm gia hạn, tức là vào hoặc sau thời điểm này.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

[Bắt buộc] Chế độ chuyển đổi gói. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
definiteTransition

object (DefiniteTransition)

Khi sử dụng chế độ này, quá trình chuyển đổi của người dùng sang gói mới là chắc chắn và không thể huỷ.

tentativeTransition

object (TentativeTransition)

Khi sử dụng chế độ này, quá trình chuyển đổi của người dùng sang gói mới là tạm thời và có thể bị huỷ.

Kết thúc các trường loại trừ lẫn nhau.
etag

string

Nếu bạn đặt tham số này, API sẽ không thành công nếu etag không khớp với etag mới nhất cho gói thuê bao này. Etag được truy xuất từ purchases.subscriptionsv2.get: https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get

Nội dung phản hồi

Nội dung phản hồi cho API purchases.subscriptionsv2.schedulePlanTransition.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON
{
  "planTransitionDetails": {
    object (PlanTransitionDetails)
  }
}
Trường
planTransitionDetails

object (PlanTransitionDetails)

Thông tin chi tiết về việc chuyển đổi gói của mặt hàng thuê bao.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

DefiniteTransition

Loại này không có trường nào.

Dùng để cho biết rằng việc chuyển đổi gói là chắc chắn.

TentativeTransition

Loại này không có trường nào.

Dùng để cho biết rằng việc chuyển đổi gói là tạm thời.