Method: properties.recurringAudienceLists.list

Liệt kê tất cả các danh sách đối tượng định kỳ cho một tài sản. Bạn có thể sử dụng phương pháp này để tìm và sử dụng lại danh sách đối tượng định kỳ hiện có thay vì tạo danh sách đối tượng định kỳ mới không cần thiết. Một đối tượng có thể có nhiều danh sách đối tượng định kỳ đại diện cho các kiểu kết hợp phương diện khác nhau; ví dụ: chỉ phương diện deviceId hoặc cả hai phương diện deviceId và userId.

Phương thức này được ra mắt với độ ổn định alpha, nhằm mục đích thu thập thông tin phản hồi về cú pháp và chức năng trước khi chuyển sang giai đoạn thử nghiệm beta. Để đưa ra ý kiến phản hồi về API này, hãy hoàn thành biểu mẫu Phản hồi về API Xuất đối tượng của Google Analytics.

Yêu cầu HTTP

GET https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/recurringAudienceLists

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

Tham số đường dẫn

Tham số
parent

string

Bắt buộc. Tất cả danh sách đối tượng định kỳ cho tài sản này sẽ được liệt kê trong câu trả lời. Định dạng properties/{property}

Tham số truy vấn

Tham số
pageSize

integer

Không bắt buộc. Số lượng danh sách đối tượng định kỳ tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu bạn không chỉ định, hệ thống sẽ trả về tối đa 200 danh sách đối tượng định kỳ. Giá trị tối đa là 1000 (các giá trị cao hơn sẽ bị ép buộc lên giá trị tối đa).
pageToken

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi recurringAudienceLists.list trước đó. Cung cấp mã 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 recurringAudienceLists.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

Danh sách tất cả các danh sách đối tượng định kỳ cho một tài sản.

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

object (RecurringAudienceList)

Mỗi danh sách đối tượng định kỳ cho một tài sản.
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 một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics