Method: subscriptions.list

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

Secara opsional, metode ini dapat memfilter respons menurut 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 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 utama 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 ada.
customerNamePrefix

string

Saat mengambil semua langganan 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 menggunakan tanda bintang 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 lanjutan, yang digunakan untuk mengelompokkan 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 mengetahui informasi selengkapnya, lihat Panduan otorisasi.