- Yêu cầu HTTP
- Tham số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- DefiniteTransition
- TentativeTransition
- Hãy làm thử!
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 |
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 |
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 ( |
| Trường | |
|---|---|
productId |
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 |
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ụ: |
| [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 |
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 |
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 |
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 ( |
| Trường | |
|---|---|
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.