REST Resource: subscriptions

Resource: Subscription

Template JSON untuk langganan.

Representasi JSON 
{
  "customerId": string,
  "subscriptionId": string,
  "skuId": string,
  "creationTime": string,
  "kind": string,
  "seats": {
    object (Seats)
  },
  "renewalSettings": {
    object (RenewalSettings)
  },
  "purchaseOrderId": string,
  "status": string,
  "resourceUiUrl": string,
  "billingMethod": string,
  "suspensionReasons": [
    string
  ],
  "customerDomain": string,
  "dealCode": string,
  "skuName": string,
  "plan": {
    "planName": string,
    "isCommitmentPlan": boolean,
    "commitmentInterval": {
      "startTime": string,
      "endTime": string
    }
  },
  "trialSettings": {
    "isInTrial": boolean,
    "trialEndTime": string
  },
  "transferInfo": {
    "transferabilityExpirationTime": string,
    "minimumTransferableSeats": integer,
    "currentLegacySkuId": string
  }
}
Kolom
customerId

string

Properti ini akan selalu ditampilkan dalam respons sebagai ID unik yang dibuat oleh Google. Dalam permintaan, properti ini dapat berupa domain utama atau ID unik yang dihasilkan oleh Google.
subscriptionId

string

subscriptionId adalah ID langganan dan bersifat unik untuk setiap pelanggan. Ini adalah properti yang wajib ada. Karena subscriptionId berubah saat langganan diperbarui, sebaiknya jangan gunakan ID ini sebagai kunci untuk data persisten. Gunakan subscriptionId seperti yang dijelaskan dalam mengambil semua langganan reseller.
skuId

string

Properti wajib. skuId adalah ID sistem unik untuk SKU produk yang ditetapkan kepada pelanggan dalam langganan. Untuk produk dan SKU yang tersedia dalam versi API ini, lihat ID Produk dan SKU.
creationTime

string (int64 format)

Properti creationTime adalah tanggal saat langganan dibuat. Format ini dalam milidetik menggunakan format Epoch. Lihat contoh Konverter epoch.
kind

string

Mengidentifikasi resource sebagai Langganan. Nilai: reseller#subscription
seats

object (Seats)

Ini adalah properti yang wajib ada. Jumlah dan batas lisensi kursi pengguna dalam paket.
renewalSettings

object (RenewalSettings)

Setelan perpanjangan untuk paket komitmen tahunan. Untuk informasi yang lebih mendetail, lihat opsi perpanjangan di pusat bantuan administrator.
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.
status

string

Ini adalah properti opsional.
resourceUiUrl

string

URL ke halaman Langganan pelanggan di konsol Admin. URL hanya baca dibuat oleh layanan API. Ini digunakan jika aplikasi klien Anda mengharuskan pelanggan menyelesaikan tugas menggunakan halaman Langganan di konsol Admin.
billingMethod

string

Kolom hanya baca yang menampilkan metode penagihan saat ini untuk langganan.
suspensionReasons[]

string

Kolom hanya baca yang berisi enumerasi semua alasan penangguhan saat ini untuk langganan. Langganan dapat memiliki banyak alasan penangguhan yang bersamaan dan tumpang-tindih. STATUS langganan adalah SUSPENDED hingga semua penangguhan yang tertunda dihapus.

Kemungkinan opsi mencakup:

  • PENDING_TOS_ACCEPTANCE - Pelanggan belum login dan menyetujui Persyaratan Layanan G Suite yang Dijual Kembali.
  • RENEWAL_WITH_TYPE_CANCEL - Komitmen pelanggan berakhir dan layanannya dibatalkan di akhir periode langganan.
  • RESELLER_INITIATED - Penangguhan manual yang dipanggil oleh Reseller.
  • TRIAL_ENDED - Uji coba pelanggan berakhir tanpa memilih paket.
  • OTHER - Pelanggan ditangguhkan karena alasan internal Google (misalnya, penyalahgunaan atau lainnya).

customerDomain

string

Nama domain primer pelanggan
dealCode

string

Kode yang diterbitkan Google (maks. 100 karakter) untuk harga diskon pada paket langganan. Kode promo harus disertakan dalam permintaan insert agar dapat menerima tarif diskon. Properti ini bersifat opsional, harga reguler akan berlaku jika dibiarkan kosong.
skuName

string

Nama tampilan eksternal hanya baca untuk SKU produk yang ditetapkan kepada pelanggan dalam langganan. Nama SKU dapat berubah atas pertimbangan Google. Untuk produk dan SKU yang tersedia dalam versi API ini, lihat ID Produk dan SKU.
plan

object

Properti plan wajib diisi. Dalam versi API ini, paket G Suite adalah paket fleksibel, paket komitmen tahunan, dan paket uji coba gratis 30 hari. Untuk mengetahui informasi selengkapnya tentang paket pembayaran API, lihat Konsep API.
plan.planName

string

Properti planName wajib diisi. Ini adalah nama paket 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. Langganan dalam uji coba akan ditangguhkan setelah hari ke-30 uji coba gratis jika tidak ada paket pembayaran yang ditetapkan. Memanggil changePlan akan menetapkan paket pembayaran ke uji coba, tetapi tidak akan mengaktifkan paket tersebut. Uji coba akan otomatis memulai paket pembayaran yang ditetapkan setelah hari ke-30 uji coba gratis atau segera setelah memanggil startPaidService.
  • FREE — Paket gratis bersifat eksklusif untuk SKU Cloud Identity dan tidak dikenai penagihan apa pun.

plan.isCommitmentPlan

boolean

Nilai boolean properti isCommitmentPlan mengidentifikasi paket sebagai paket komitmen tahunan:

  • true — Paket langganan adalah paket komitmen tahunan.
  • false — Paket ini bukan paket komitmen tahunan.
plan.commitmentInterval

object

Dalam versi API ini, interval paket komitmen tahunan adalah satu tahun.

plan.commitmentInterval.startTime

string (int64 format)

startTime interval rencana komitmen tahunan dalam milidetik menggunakan format UNIX Epoch. Lihat contoh Konverter epoch.
plan.commitmentInterval.endTime

string (int64 format)

endTime interval rencana komitmen tahunan dalam milidetik menggunakan format UNIX Epoch. Lihat contoh Konverter epoch.
trialSettings

object

Komitmen tahunan G Suite dan paket pembayaran fleksibel dapat diuji coba gratis selama 30 hari. Untuk informasi selengkapnya, lihat Konsep API.
trialSettings.isInTrial

boolean

Menentukan apakah paket langganan masih dalam uji coba gratis 30 hari atau tidak:

  • true — Paket masih dalam uji coba.
  • false — Paket tidak dalam uji coba.
trialSettings.trialEndTime

string (int64 format)

Tanggal saat uji coba berakhir. Nilainya dalam milidetik menggunakan format UNIX Epoch. Lihat contoh Konverter epoch.
transferInfo

object

Informasi terkait transfer hanya baca untuk langganan. Untuk informasi selengkapnya, lihat mengambil langganan yang dapat ditransfer untuk pelanggan.
transferInfo.transferabilityExpirationTime

string (int64 format)

Waktu saat token transfer atau intent untuk transfer akan berakhir masa berlakunya. Waktu dalam milidetik menggunakan format UNIX Epoch.
transferInfo.minimumTransferableSeats

integer

Saat menyisipkan langganan, ini adalah jumlah minimum kursi yang tercantum dalam pesanan transfer untuk produk ini. Misalnya, jika pelanggan memiliki 20 pengguna, reseller tidak dapat melakukan pemesanan transfer sebanyak 15 slot. Jumlah minimum adalah 20 kursi.
transferInfo.currentLegacySkuId

string

skuId langganan yang dijual kembali saat ini. Kolom ini hanya diisi jika pelanggan memiliki langganan dengan SKU lama dan resource langganan diisi dengan skuId SKU yang direkomendasikan untuk transfer.

Slot

Template JSON untuk kursi langganan.

Representasi JSON 
{
  "numberOfSeats": integer,
  "maximumNumberOfSeats": integer,
  "licensedNumberOfSeats": integer,
  "kind": string
}
Kolom
numberOfSeats

integer

Ini adalah properti wajib dan eksklusif untuk langganan dengan paket ANNUAL_MONTHLY_PAY dan ANNUAL_YEARLY_PAY. Properti ini menetapkan jumlah maksimum lisensi yang dapat ditetapkan kepada pengguna di langganan. Reseller dapat menambahkan lebih banyak lisensi, tetapi setelah ditetapkan, numberOfSeats tidak dapat dikurangi hingga perpanjangan. Reseller akan ditagih berdasarkan nilai numberOfSeats, berapa pun jumlah lisensi pengguna yang ditetapkan.

maximumNumberOfSeats

integer

Ini adalah properti wajib dan eksklusif untuk langganan dengan paket FLEXIBLE atau TRIAL. Properti ini menetapkan jumlah maksimum pengguna berlisensi yang diizinkan di langganan. Jumlah ini dapat ditingkatkan hingga batas maksimum yang ditentukan dalam kontrak reseller. Jumlah minimum adalah jumlah pengguna saat ini di akun pelanggan.

licensedNumberOfSeats

integer

Kolom hanya baca yang berisi jumlah pengguna saat ini yang diberi lisensi untuk produk yang ditentukan di skuId. Nilai kolom ini setara dengan jumlah numerik pengguna yang ditampilkan oleh metode Enterprise License Manager API: listForProductAndSku.
kind

string

Mengidentifikasi resource sebagai setelan kursi langganan. Nilai: subscriptions#seats

RenewalSettings

Template JSON untuk setelan perpanjangan langganan.

Representasi JSON 
{
  "renewalType": string,
  "kind": string
}
Kolom
renewalType

string

Setelan perpanjangan untuk paket komitmen tahunan. Untuk informasi yang lebih mendetail, lihat opsi perpanjangan di pusat bantuan administrator. Saat memperpanjang langganan, renewalType adalah properti wajib.
kind

string

Mengidentifikasi resource sebagai setelan perpanjangan langganan. Nilai: subscriptions#renewalSettings

Metode

activate

 Mengaktifkan langganan yang sebelumnya ditangguhkan oleh reseller.

changePlan

 Memperbarui paket langganan.

changeRenewalSettings

 Memperbarui setelan perpanjangan lisensi pengguna.

changeSeats

 Memperbarui setelan lisensi pengguna langganan.

delete

 Membatalkan, menangguhkan, atau mentransfer langganan ke langsung.

get

 Mendapatkan langganan tertentu.

insert

 Membuat atau mentransfer langganan.

list

 Daftar langganan yang dikelola oleh reseller.

startPaidService

 Segera pindahkan langganan uji coba gratis 30 hari ke langganan layanan berbayar.

suspend

 Menangguhkan langganan yang aktif.