Method: accounts.promotions.list

Liệt kê các chương trình khuyến mãi trong tài khoản Merchant Center của bạn. Phản hồi có thể chứa ít mục hơn so với số lượng mà pageSize chỉ định. Dựa vào pageToken để xác định xem có mục nào khác cần được yêu cầu hay không.

Sau khi chèn hoặc cập nhật chương trình khuyến mãi, có thể mất vài phút để truy xuất chương trình khuyến mãi đã xử lý đã cập nhật.

Yêu cầu HTTP

GET https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions

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

Tham số đường dẫn

Thông số
parent

string

Bắt buộc. Tài khoản để liệt kê các chương trình khuyến mãi được xử lý. Định dạng accounts/{account}

Tham số truy vấn

Thông số
pageSize

integer

Chỉ có đầu ra. Số lượng chương trình khuyến mãi tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Giá trị tối đa là 250; các giá trị trên 250 sẽ bị buộc thành 250. Nếu bạn chưa chỉ định, hệ thống sẽ trả về số lượng chương trình khuyến mãi tối đa.
pageToken

string

Chỉ có đầu ra. Mã thông báo trang, nhận được từ lệnh gọi promotions.list trước đó. Cung cấp giá trị này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho promotions.list phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

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

Thông báo phản hồi cho phương thức promotions.list.

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 
{
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "nextPageToken": string
}
Trường
promotions[]

object (Promotion)

Các chương trình khuyến mãi đã xử lý từ tài khoản được chỉ định.
nextPageToken

string

Mã thông báo có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo. Nếu trường này bị bỏ qua thì sẽ không có trang tiếp theo.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.