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ả các gói thuê bao, toàn bộ gói thuê bao của khách hàng hoặc tất cả các 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

Tham số
customerAuthToken

string

Chuỗi truy vấn customerAuthToken là bắt buộc khi tạo tài khoản 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 khác là đại lý 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 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 riêng biệt của khách hàng. Nếu tên miền dành cho 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 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 vào 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 ra những khách hàng cụ thể, bạn có thể nhập tiền tố cho tên khách hàng. Dùng một nhóm khách hàng mẫu bao gồm exam.com, example20.comexample.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.comexample.com. Tiền tố tên tương tự như việc sử dụng dấu hoa thị, exa* của biểu thức chính quy.
  • example -- Trả về example20.comexample.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 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 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 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ị: đại lý#subscriptions

subscriptions[]

object (Subscription)

Các kênh đã đăng ký 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. Hãy 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.