Method: subscriptions.changePlan

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

Cara pembaruan paket berbeda-beda bergantung pada paket dan produknya. Untuk informasi selengkapnya, lihat deskripsi di 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 pengenal 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 diupdate, 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 memuat instance Subscription.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.

ChangePlanRequest

Template JSON untuk permintaan langganan.changePlan rpc.

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 mengetahui informasi selengkapnya 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 kursi pengguna.
purchaseOrderId

string

Ini adalah properti opsional. Informasi pesanan pembelian (PO) ini ditujukan bagi pengecer untuk penggunaan pelacakan 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 dikeluarkan Google (maks. 100 karakter) untuk harga diskon paket langganan. Kode transaksi harus disertakan dalam permintaan changePlan agar dapat menerima tarif diskon. Properti ini bersifat opsional. Jika kode promo telah ditambahkan ke langganan, properti ini dapat dibiarkan kosong dan tarif diskon yang ada akan tetap berlaku (jika tidak kosong, cukup berikan kode promo yang sudah ada pada langganan). Jika kode promo belum pernah ditambahkan ke langganan dan properti ini dibiarkan kosong, harga reguler akan berlaku.