Method: subscriptions.changePlan

Memperbarui paket langganan. Gunakan metode ini untuk memperbarui paket untuk uji coba 30 hari atau langganan paket fleksibel ke paket komitmen tahunan dengan pembayaran bulanan atau tahunan.

Cara pembaruan paket berbeda-beda bergantung pada rencana dan produk. Untuk informasi selengkapnya, lihat deskripsi dalam artikel mengelola langganan.

Permintaan HTTP

POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/changePlan

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

Ini dapat berupa nama domain primer pelanggan atau ID unik pelanggan. Jika nama domain untuk pelanggan berubah, nama domain lama tidak dapat digunakan untuk mengakses pelanggan, tetapi ID unik pelanggan (seperti yang ditampilkan oleh API) selalu dapat digunakan. Sebaiknya simpan ID unik di sistem Anda, jika berlaku.
subscriptionId

string

Ini adalah properti wajib. subscriptionId adalah ID langganan dan bersifat unik untuk setiap pelanggan. Karena subscriptionId berubah saat langganan diperbarui, sebaiknya jangan gunakan ID ini sebagai kunci untuk data persisten. Dan subscriptionId dapat ditemukan menggunakan metode ambil semua langganan reseller.

Isi permintaan

Isi permintaan memuat instance ChangePlanRequest.

Isi respons

Jika berhasil, isi respons akan berisi instance Subscription.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/apps.order

Untuk informasi selengkapnya, lihat Panduan otorisasi.

ChangePlanRequest

Template JSON untuk permintaan rpc subscription.changePlan.

Representasi JSON 
{
  "kind": string,
  "planName": string,
  "seats": {
    object (Seats)
  },
  "purchaseOrderId": string,
  "dealCode": string
}
Kolom
kind

string

Mengidentifikasi resource sebagai permintaan paket perubahan langganan. Nilai: subscriptions#changePlanRequest
planName

string

Properti planName wajib diisi. Ini adalah nama paket pembayaran langganan. Untuk informasi lebih lanjut tentang paket pembayaran Google, lihat Konsep API.

Kemungkinan nilainya adalah:

  • ANNUAL_MONTHLY_PAY - Paket komitmen tahunan dengan pembayaran bulanan
  • ANNUAL_YEARLY_PAY - Paket komitmen tahunan dengan pembayaran tahunan
  • FLEXIBLE - Paket fleksibel
  • TRIAL - Paket uji coba gratis 30 hari

seats

object (Seats)

Ini adalah properti wajib. Properti kursi adalah jumlah lisensi slot pengguna.
purchaseOrderId

string

Ini adalah properti opsional. Informasi pesanan pembelian (PO) ini ditujukan bagi reseller untuk melacak penggunaan produk oleh perusahaan mereka. Jika nilai purchaseOrderId diberikan, nilai tersebut akan muncul di respons API dan muncul di invoice. Properti ini menerima hingga 80 karakter teks biasa.
dealCode

string

Kode yang diterbitkan Google (maks. 100 karakter) untuk harga diskon paket langganan. Kode promo harus disertakan dalam permintaan changePlan untuk mendapatkan tarif diskon. Properti ini bersifat opsional. Jika kode promo telah ditambahkan ke langganan, properti ini boleh dibiarkan kosong dan tarif diskon yang ada akan tetap berlaku (jika tidak kosong, cukup berikan kode promo yang sudah ada di langganan). Jika kode promo belum pernah ditambahkan ke langganan dan properti ini dibiarkan kosong, harga reguler akan berlaku.