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
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.
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
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.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2024-09-09 UTC."],[[["Updates a subscription's plan, allowing changes from trial or flexible plans to annual commitments with monthly or yearly payments, with varying update processes based on the specific plan and products."],["Requires sending a POST request to a specific URL, including the `customerId` and `subscriptionId` as path parameters."],["The request body must contain a `ChangePlanRequest` object specifying the desired plan name, number of seats, and optional purchase order ID and deal code."],["Successful responses return a `Subscription` object representing the updated subscription."],["Requires authorization with the `https://www.googleapis.com/auth/apps.order` scope."]]],[]]
