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 |
Chuỗi truy vấn |
customerId |
Đâ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 |
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
|
maxResults |
Khi truy xuất một danh sách lớn, |
pageToken |
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 ( |
Các trường | |
---|---|
kind |
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[] |
Các gói thuê bao trên trang kết quả này. |
nextPageToken |
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.