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 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 pengenal 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 Anda tidak menggunakan ID ini sebagai kunci untuk data persisten. Selain itu, subscriptionId dapat ditemukan menggunakan metode mengambil 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 ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

PermintaanPaket Diubah

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 selengkapnya tentang paket pembayaran Google, lihat Konsep API.

Nilai yang memungkinkan 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 slot adalah jumlah lisensi slot pengguna.

purchaseOrderId

string

Ini adalah properti opsional. Informasi pesanan pembelian (PO) ini digunakan reseller untuk digunakan dalam pelacakan perusahaan. Jika nilai purchaseOrderId diberikan, nilai tersebut akan muncul di respons API dan muncul di invoice. Properti dapat menerima hingga 80 karakter teks biasa.

dealCode

string

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