- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- Hãy làm thử!
Liệt kê tất cả danh sách đối tượng cho một cơ sở lưu trú. Bạn có thể sử dụng phương pháp này để tìm và sử dụng lại các danh sách đối tượng hiện có thay vì tạo danh sách đối tượng mới không cần thiết. Một đối tượng có thể có nhiều danh sách đối tượng đại diện cho danh sách 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 danh sách đối tượng để tìm hiểu giới thiệu về Danh sách đối tượng kèm theo ví dụ.
Phương pháp này hiện có ở phiên bản ổn định thử nghiệm tại audienceExports.list. Để đư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/*}/audienceLists
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Tham số | |
---|---|
parent |
Bắt buộc. Tất cả danh sách đối tượng cho tài sản này sẽ được liệt kê trong câu trả lời. Định dạng |
Tham số truy vấn
Tham số | |
---|---|
pageSize |
Không bắt buộc. Số lượng danh sách đố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 bạn không chỉ định, hệ thống sẽ trả về tối đa 200 danh sách đối tượng. 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 |
Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi Khi phân trang, tất cả các tham số khác được cung cấp cho |
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 cho một cơ sở lưu trú.
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 |
---|
{
"audienceLists": [
{
object ( |
Trường | |
---|---|
audienceLists[] |
Mỗi danh sách đối tượng cho một tài sản. |
nextPageToken |
Mã thông báo có thể được gửi dưới dạng |
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