Method: purchases.subscriptionsv2.defer

Hoãn gia hạn gói thuê bao.

Yêu cầu HTTP

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

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à người dùng đã mua gói thuê bao này (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 
{
  "deferralContext": {
    object (DeferralContext)
  }
}
Trường
deferralContext

object (DeferralContext)

Bắt buộc. Thông tin chi tiết về việc hoãn gói thuê bao.

Nội dung phản hồi

Phản hồi cho API purchases.subscriptions.defer phiên bản 2.

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 
{
  "itemExpiryTimeDetails": [
    {
      object (ItemExpiryTimeDetails)
    }
  ]
}
Trường
itemExpiryTimeDetails[]

object (ItemExpiryTimeDetails)

Thời gian hết hạn mới cho từng mục thuê bao.

Phạm vi uỷ quyền

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

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

DeferralContext

Ngữ cảnh hoãn của API purchases.subscriptionsv2.defer.

Biểu diễn dưới dạng JSON 
{
  "etag": string,
  "deferDuration": string,
  "validateOnly": boolean
}
Trường
etag

string

Bắt buộc. API sẽ không hoạt độ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
deferDuration

string (Duration format)

Bắt buộc. Khoảng thời gian mà tất cả các mục trong gói thuê bao sẽ được hoãn lại.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
validateOnly

boolean

Nếu được đặt thành "true", yêu cầu này là một lượt chạy thử để xác thực hiệu quả của subscriptionsv2.defer, gói thuê bao sẽ không bị ảnh hưởng.

ItemExpiryTimeDetails

Thông tin chi tiết về thời gian hết hạn của một mặt hàng thuê bao.

Biểu diễn dưới dạng JSON 
{
  "productId": string,
  "expiryTime": string
}
Trường
productId

string

Mã sản phẩm của mặt hàng thuê bao (ví dụ: "premium_plan").
expiryTime

string (Timestamp format)

Thời gian hết hạn mới của mục thuê bao 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".