Method: subscriptions.suspend

Menangguhkan langganan yang aktif.

Anda dapat menggunakan metode ini untuk menangguhkan langganan berbayar yang saat ini dalam status ACTIVE.

  • Untuk langganan FLEXIBLE, penagihan dijeda.
  • Untuk langganan ANNUAL_MONTHLY_PAY atau ANNUAL_YEARLY_PAY:
    • Menangguhkan langganan tidak mengubah tanggal perpanjangan yang awalnya menjadi komitmen Anda.
    • Langganan yang ditangguhkan tidak akan diperpanjang.Jika Anda mengaktifkan langganan setelah tanggal perpanjangan awal, langganan tahunan baru akan dibuat, dimulai pada hari aktivasi.

Sebaiknya Anda menangguhkan langganan hanya untuk waktu yang singkat karena penangguhan selama lebih dari 60 hari dapat mengakibatkan langganan dibatalkan.

Permintaan HTTP

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

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 harus kosong.

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.