Method: purchases.subscriptions.defer

Trì hoãn giao dịch mua gói thuê bao của người dùng cho đến một thời điểm hết hạn cụ thể trong tương lai.

Yêu cầu HTTP

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

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

Tham số đường dẫn

Thông số
packageName

string

Tên gói của ứng dụng mà bạn đã mua gói thuê bao này (ví dụ: "com.some.thing").
subscriptionId

string

Mã nhận dạng gói thuê bao được mua (ví dụ: "monthly001").
token

string

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 có cấu trúc sau:

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

object (SubscriptionDeferralInfo)

Thông tin về thời gian hết hạn mới mong muốn cho gói thuê bao.

Nội dung phản hồi

Phản hồi cho API purchases.subscriptions.defer.

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 
{
  "newExpiryTimeMillis": string
}
Trường
newExpiryTimeMillis

string (int64 format)

Thời gian hết hạn mới của gói thuê bao tính bằng mili giây kể từ thời gian bắt đầu của hệ thống.

Mẫu

Sau đây là một yêu cầu mẫu:

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'

Sau đây là phản hồi mẫu:

{
  "newExpiryTimeMillis": "1776004800000"
}

Phạm vi uỷ quyền

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

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

SubscriptionDeferralInfo

SubscriptionDeferralInfo chứa dữ liệu cần thiết để hoãn giao dịch mua gói thuê bao đến một thời điểm hết hạn trong tương lai.

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

string (int64 format)

Thời gian hết hạn dự kiến của gói thuê bao. Nếu thời gian hết hạn hiện tại của gói thuê bao không phải là giá trị được chỉ định tại đây, thì việc trì hoãn sẽ không xảy ra.
desiredExpiryTimeMillis

string (int64 format)

Thời gian hết hạn tiếp theo mà bạn muốn chỉ định cho gói thuê bao, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống. Thời gian đã cho phải sau/lớn hơn thời gian hết hạn hiện tại của gói thuê bao.