Method: subscriptions.list

Daftar langganan yang dikelola oleh reseller. Daftar tersebut 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 mengetahui 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 yang dijual kembali yang mentransfer langganan pelanggan langsung atau mentransfer langganan pelanggan reseller lainnya 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 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.

customerNamePrefix

string

Saat mengambil semua langganan Anda dan memfilter pelanggan tertentu, Anda dapat memasukkan awalan untuk nama pelanggan. Menggunakan contoh grup pelanggan yang menyertakan 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, eksa*.
  • example -- Menampilkan example20.com dan example.com.

maxResults

integer (uint32 format)

Saat mengambil daftar yang 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

Jika berhasil, isi respons memuat data dengan struktur berikut:

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.

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 lanjutan, 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 Ringkasan OAuth 2.0.