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 memperbarui paket berbeda-beda, bergantung pada paket dan produk. Untuk mengetahui 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 utama 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 ada.
subscriptionId

string

Ini adalah properti yang wajib ada. 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. Selain itu, 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 mengetahui informasi selengkapnya, lihat Panduan otorisasi.

ChangePlanRequest

Template JSON untuk permintaan rpc subscriptions.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 mengetahui informasi selengkapnya tentang paket pembayaran Google, lihat Konsep API.

Nilai yang mungkin 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 selama 30 hari

seats

object (Seats)

Ini adalah properti yang wajib ada. Properti kursi adalah jumlah lisensi kursi pengguna.
purchaseOrderId

string

Ini adalah properti opsional. Informasi pesanan pembelian (PO) ini ditujukan untuk digunakan oleh reseller untuk penggunaan pelacakan perusahaan mereka. Jika nilai purchaseOrderId diberikan, nilai tersebut akan muncul dalam 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 pada paket langganan. Kode promo 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, hanya 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.