Method: purchases.subscriptionsv2.revoke

subscriptionsv2.revoke mencabut pembelian langganan untuk pengguna.

Permintaan HTTP

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

URL 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 
{
  "revocationContext": {
    object (RevocationContext)
  }
}
Kolom
revocationContext

object (RevocationContext)

Wajib. Detail tambahan seputar pencabutan langganan.

Isi respons

Jika berhasil, isi respons akan kosong.

Contoh

Berikut adalah contoh permintaan:

curl -X POST \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptionsv2/tokens/sample_purchase_token:revoke' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "revocationContext": {
      "proratedRefund": {}
    }
  }'

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

RevocationContext

Konteks pencabutan API purchases.subscriptionsv2.revoke.

Representasi JSON 
{

  // Union field RefundType can be only one of the following:
  "fullRefund": {
    object (FullRefund)
  },
  "proratedRefund": {
    object (ProratedRefund)
  },
  "itemBasedRefund": {
    object (ItemBasedRefund)
  }
  // End of list of possible types for union field RefundType.
}
Kolom
Kolom union RefundType. Menentukan jenis pengembalian dana yang harus diberikan. Jenis pengembalian dana harus ditentukan sebagai bagian dari permintaan yang valid. RefundType hanya dapat berupa salah satu dari berikut:
fullRefund

object (FullRefund)

Opsional. Digunakan saat pengguna harus mendapatkan pengembalian dana dengan jumlah penuh tagihan terbaru untuk setiap item dalam langganan.
proratedRefund

object (ProratedRefund)

Opsional. Digunakan saat pengguna harus mendapatkan pengembalian dana dengan jumlah prorata yang mereka bayarkan untuk langganan berdasarkan jumlah waktu yang tersisa dalam langganan.
itemBasedRefund

object (ItemBasedRefund)

Opsional. Digunakan saat item tertentu harus dikembalikan dananya dalam langganan dengan item add-on.

FullRefund

Jenis ini tidak memiliki kolom.

Digunakan untuk menentukan apakah jenis pengembalian dana dalam RevocationContext merupakan pengembalian dana penuh.

ProratedRefund

Jenis ini tidak memiliki kolom.

Digunakan untuk menentukan apakah jenis pengembalian dana dalam RevocationContext merupakan pengembalian dana prorata.

ItemBasedRefund

Digunakan untuk menentukan item tertentu yang akan dicabut dalam langganan dengan beberapa item.

Representasi JSON 
{
  "productId": string
}
Kolom
productId

string

Wajib. Jika langganan adalah langganan dengan add-on, ID produk item langganan yang akan dicabut.