Method: subscriptions.list

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

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 wajib ada 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 ID 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 pemfilteran untuk 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 mencakup exam.com, example20.com, dan example.com. Awalan nama mirip dengan penggunaan tanda bintang ekspresi reguler, exa*.
  • example -- Menampilkan example20.com dan example.com.
maxResults

integer (uint32 format)

Saat mengambil daftar besar, maxResults adalah jumlah hasil maksimum per halaman. Nilai nextPageToken membawa 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 menelusuri 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.