Method: purchases.subscriptionsv2.defer

Menunda perpanjangan langganan.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
packageName

string

Wajib. Paket aplikasi yang langganannya ini dibeli (misalnya, 'com.some.thing').
token

string

Wajib. Token yang diberikan ke perangkat pengguna saat langganan dibeli.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "deferralContext": {
    object (DeferralContext)
  }
}
Kolom
deferralContext

object (DeferralContext)

Wajib. Detail tentang penundaan langganan.

Isi respons

Respons untuk API purchases.subscriptions.defer v2.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "itemExpiryTimeDetails": [
    {
      object (ItemExpiryTimeDetails)
    }
  ]
}
Kolom
itemExpiryTimeDetails[]

object (ItemExpiryTimeDetails)

Waktu habis masa berlaku baru untuk setiap item langganan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

DeferralContext

Konteks penangguhan API purchases.subscriptionsv2.defer.

Representasi JSON 
{
  "etag": string,
  "deferDuration": string,
  "validateOnly": boolean
}
Kolom
etag

string

Wajib. API akan gagal jika etag tidak sesuai dengan etag terbaru untuk langganan ini. ETag diambil dari purchases.subscriptionsv2.get: https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get
deferDuration

string (Duration format)

Wajib. Durasi penangguhan semua item langganan.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
validateOnly

boolean

Jika disetel ke "true", permintaan adalah uji coba untuk memvalidasi efek subscriptionsv2.defer, langganan tidak akan terpengaruh.

ItemExpiryTimeDetails

Detail waktu habis masa berlaku item langganan.

Representasi JSON 
{
  "productId": string,
  "expiryTime": string
}
Kolom
productId

string

ID produk item langganan (misalnya, 'premium_plan').
expiryTime

string (Timestamp format)

Waktu habis masa berlaku baru untuk item langganan ini.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".