Method: purchases.subscriptions.defer

Menunda pembelian langganan pengguna hingga waktu habis masa berlaku tertentu pada masa mendatang.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
packageName

string

Nama paket aplikasi yang langganannya ini dibeli (misalnya, 'com.some.thing').
subscriptionId

string

ID langganan yang dibeli (misalnya, 'monthly001').
token

string

Token yang diberikan ke perangkat pengguna saat langganan dibeli.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "deferralInfo": {
    object (SubscriptionDeferralInfo)
  }
}
Kolom
deferralInfo

object (SubscriptionDeferralInfo)

Informasi tentang waktu habis masa berlaku yang baru dan diinginkan untuk langganan.

Isi respons

Respons untuk purchases.subscriptions.defer API.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "newExpiryTimeMillis": string
}
Kolom
newExpiryTimeMillis

string (int64 format)

Waktu habis masa berlaku yang baru untuk langganan dalam milidetik sejak Epoch.

Contoh

Berikut adalah contoh permintaan:

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'

Berikut adalah contoh respons:

{
  "newExpiryTimeMillis": "1776004800000"
}

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

SubscriptionDeferralInfo

SubscriptionDeferralInfo berisi data yang diperlukan untuk menunda pembelian langganan hingga waktu habis masa berlaku pada masa mendatang.

Representasi JSON 
{
  "expectedExpiryTimeMillis": string,
  "desiredExpiryTimeMillis": string
}
Kolom
expectedExpiryTimeMillis

string (int64 format)

Perkiraan waktu habis masa berlaku untuk langganan. Jika waktu habis masa berlaku saat ini untuk langganan bukan nilai yang ditentukan di sini, penundaan tidak akan terjadi.
desiredExpiryTimeMillis

string (int64 format)

Waktu habis masa berlaku berikutnya yang diinginkan untuk ditetapkan ke langganan, dalam milidetik sejak Epoch. Waktu yang diberikan harus lebih lambat/lebih besar dari waktu habis masa berlaku untuk langganan.