Method: properties.audienceExports.list

Liệt kê tất cả các tệp xuất đối tượng 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 các tệp xuất đối tượng hiện có thay vì tạo các lượt xuất đối tượng mới không cần thiết. Một đối tượng có thể có nhiều dữ liệu xuất đối tượng đại diện cho lượng người dùng thuộc một đối tượng vào các ngày khác nhau.

Hãy xem bài viết Tạo tệp xuất đối tượng để tìm hiểu về tính năng Xuất đối tượng kèm theo ví dụ.

Audience Export API có một số phương thức ở mức alpha và các phương pháp khác ở mức ổn định trong giai đoạn beta. Mục đích là để nâng cao độ ổn định của phiên bản beta sau khi nhận được một số ý kiến phản hồi và áp dụng. Để gửi ý kiến phản hồi về API này, hãy hoàn tất biểu mẫu Ý kiến phản hồi về Google Analytics Audience Export API.

Yêu cầu HTTP

GET https://analyticsdata.googleapis.com/v1beta/{parent=properties/*}/audienceExports

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ả dữ liệu xuất đối tượng cho tài sản này sẽ được liệt kê trong phản hồi. Định dạng properties/{property}

Tham số truy vấn

Tham số
pageSize

integer

Không bắt buộc. Số lượng tệp xuất đối tượng tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu không chỉ định, hệ thống sẽ trả về tối đa 200 tệp xuất đối tượng. Giá trị tối đa là 1000 (các giá trị cao hơn sẽ được chuyển đổi thành 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 audienceExports.list trước đó. Cung cấp URL 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 audienceExports.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 lượt xuất đối tượng 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 
{
  "audienceExports": [
    {
      object (AudienceExport)
    }
  ],
  "nextPageToken": string
}
Trường
audienceExports[]

object (AudienceExport)

Mỗi lượt xuất đối tượng cho một tài sản.
nextPageToken

string

Mã thông báo này 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ì không có trang tiếp theo nào.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau đây:

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