Method: subscriptions.list

Daftar langganan yang dikelola oleh reseller. Daftar dapat berupa semua langganan, semua langganan pelanggan, atau semua langganan pelanggan yang dapat ditransfer.

Secara opsional, metode ini dapat memfilter respons berdasarkan customerNamePrefix. Untuk informasi selengkapnya, lihat mengelola langganan.

Permintaan HTTP

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions

URL menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
customerAuthToken

string

String kueri customerAuthToken diperlukan saat membuat akun reseller yang mentransfer langganan pelanggan langsung atau mentransfer langganan pelanggan reseller lain ke pengelolaan reseller Anda. Ini adalah token autentikasi heksadesimal yang diperlukan untuk menyelesaikan transfer langganan. Untuk informasi selengkapnya, lihat pusat bantuan administrator.
customerId

string

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.
customerNamePrefix

string

Saat mengambil semua langganan dan memfilter pelanggan tertentu, Anda dapat memasukkan awalan untuk nama pelanggan. Menggunakan contoh grup pelanggan yang mencakup exam.com, example20.com, dan example.com:

  • exa -- Menampilkan semua nama pelanggan yang diawali dengan 'exa' yang dapat menyertakan exam.com, example20.com, dan example.com. Awalan nama mirip dengan penggunaan tanda bintang pada ekspresi reguler, exa*.
  • example -- Menampilkan example20.com dan example.com.
maxResults

integer (uint32 format)

Saat mengambil daftar besar, maxResults adalah jumlah maksimum hasil per halaman. Nilai nextPageToken akan mengarahkan Anda ke halaman berikutnya. Nilai default-nya adalah 20.
pageToken

string

Token untuk menentukan halaman berikutnya dalam daftar

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Langganan mengelola hubungan paket pembayaran pelanggan Google dengan SKU produk, lisensi pengguna, status uji coba gratis 30 hari, dan opsi perpanjangan. Peran utama reseller adalah mengelola langganan pelanggan Google.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "kind": string,
  "subscriptions": [
    {
      object (Subscription)
    }
  ],
  "nextPageToken": string
}
Kolom
kind

string

Mengidentifikasi resource sebagai kumpulan langganan. Nilai: reseller#subscriptions
subscriptions[]

object (Subscription)

Langganan di halaman hasil ini.
nextPageToken

string

Token kelanjutan, digunakan untuk melakukan page melalui kumpulan hasil yang besar. Berikan nilai ini dalam permintaan berikutnya untuk menampilkan halaman hasil berikutnya.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.