Method: subscriptions.list

Danh sách các gói thuê bao do đại lý quản lý. Danh sách có thể bao gồm toàn bộ gói thuê bao, toàn bộ gói thuê bao của một khách hàng hoặc toàn bộ gói thuê bao có thể chuyển nhượng của khách hàng.

Phương thức này có thể lọc phản hồi theo customerNamePrefix (không bắt buộc). Để biết thêm thông tin, hãy xem bài viết quản lý gói thuê bao.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số truy vấn

Các tham số
customerAuthToken

string

Chuỗi truy vấn customerAuthToken là bắt buộc khi tạo tài khoản được bán lại, tài khoản này sẽ chuyển gói đăng ký của khách hàng trực tiếp hoặc chuyển gói đăng ký của khách hàng đại lý khác sang quyền quản lý đại lý của bạn. Đây là mã xác thực hệ thập lục phân cần thiết để hoàn tất quá trình chuyển gói thuê bao. Để biết thêm thông tin, hãy xem trung tâm trợ giúp quản trị viên.
customerId

string

Đây có thể là tên miền chính của khách hàng hoặc mã nhận dạng duy nhất của khách hàng. Nếu tên miền cho một khách hàng thay đổi, tên miền cũ không thể dùng để truy cập vào khách hàng, nhưng luôn có thể sử dụng mã nhận dạng duy nhất của khách hàng (do API trả về). Bạn nên lưu trữ mã nhận dạng duy nhất trong hệ thống của mình (nếu có).
customerNamePrefix

string

Khi truy xuất tất cả các gói thuê bao và lọc theo khách hàng cụ thể, bạn có thể nhập tiền tố cho tên khách hàng. Sử dụng một nhóm khách hàng mẫu bao gồm exam.com, example20.com và example.com:

  • exa – Trả về tất cả tên khách hàng bắt đầu bằng 'exa', có thể bao gồm exam.com, example20.com và example.com. Tiền tố tên tương tự như sử dụng dấu hoa thị của biểu thức chính quy, exa*.
  • example – Trả về example20.com và example.com.
maxResults

integer (uint32 format)

Khi truy xuất một danh sách lớn, maxResults là số lượng kết quả tối đa trên mỗi trang. Giá trị nextPageToken đưa bạn đến trang tiếp theo. Giá trị mặc định là 20.
pageToken

string

Mã thông báo để chỉ định trang tiếp theo trong danh sách

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Gói thuê bao quản lý mối quan hệ giữa gói thanh toán của khách hàng Google với SKU của sản phẩm, giấy phép người dùng, trạng thái dùng thử miễn phí trong 30 ngày và các lựa chọn gia hạn. Vai trò chính của đại lý là quản lý các gói thuê bao của khách hàng của Google.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "subscriptions": [
    {
      object (Subscription)
    }
  ],
  "nextPageToken": string
}
Các trường
kind

string

Xác định tài nguyên này là một tập hợp các gói thuê bao. Giá trị: đại lý#thuê bao
subscriptions[]

object (Subscription)

Các gói thuê bao trên trang kết quả này.
nextPageToken

string

Mã thông báo tiếp tục, dùng để phân trang thông qua các tập hợp kết quả lớn. Cung cấp giá trị này trong yêu cầu tiếp theo để trả về trang kết quả tiếp theo.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.