Method: subscriptions.list

Danh sách các gói thuê bao do đại lý quản lý. Danh sách này có thể là tất cả gói thuê bao, tất cả gói thuê bao của khách hàng hoặc tất cả gói thuê bao có thể chuyển của khách hàng.

Nếu muốn, phương thức này có thể lọc phản hồi theo customerNamePrefix. Để 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

Thông 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 để chuyển gói thuê bao của khách hàng trực tiếp hoặc chuyển gói thuê bao của khách hàng đại lý khác sang tài khoản quản lý đại lý của bạn. Đây là mã thông báo xác thực 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 dành cho 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 giá trị nhận dạng duy nhất của khách hàng. Nếu tên miền của khách hàng thay đổi, bạn không thể sử dụng tên miền cũ để truy cập vào khách hàng đó, nhưng bạn luôn có thể sử dụng giá trị nhận dạng duy nhất của khách hàng (do API trả về). Bạn nên lưu trữ giá trị 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ả gói thuê bao và lọc cho 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ư việc 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ố kết quả tối đa trên mỗi trang. Giá trị nextPageToken sẽ đư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 kế hoạch 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í 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 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
}
Trường
kind

string

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

object (Subscription)

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

string

Mã thông báo tiếp tục, dùng để phân trang qua các tập hợp kết quả lớn. Cung cấp giá trị này trong một 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.