Hãy thử máy chủ MCP cho Google Analytics. Cài đặt từ
GitHub và xem
thông báo để biết thêm thông tin chi tiết.
Method: properties.recurringAudienceLists.list
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Liệt kê tất 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 thức này để tìm và sử dụng lại các danh sách đối tượng định kỳ hiện có thay vì tạo các 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 nhiều tổ hợp phương diện; ví dụ: chỉ phương diện deviceId hoặc cả 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. Để gửi ý kiến phản hồi về API này, hãy hoàn tất biểu mẫu Phản hồi về Audience Export API 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 nội dung 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 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 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ẽ được ép 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 recurringAudienceLists.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 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ả 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 bạn bỏ qua trường này, 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.readonlyhttps://www.googleapis.com/auth/analytics
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-26 UTC."],[[["\u003cp\u003eLists all recurring audience lists for a given Google Analytics property, allowing for reuse of existing lists.\u003c/p\u003e\n"],["\u003cp\u003eEnables finding audience lists with different dimension combinations (e.g., deviceId, userId).\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination to retrieve large numbers of recurring audience lists.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific authorization scopes for access.\u003c/p\u003e\n"],["\u003cp\u003eCurrently in alpha, with a feedback form available for user input.\u003c/p\u003e\n"]]],["This document details how to list recurring audience lists for a property using the Google Analytics Audience Export API. The API uses a `GET` request to a specified URL with the property ID as a path parameter. Optional query parameters (`pageSize`, `pageToken`) manage pagination. The request body is empty. The response is a JSON object containing an array of recurring audience lists and a `nextPageToken` for further pagination, if required. Authorization requires specific OAuth scopes.\n"],null,["# Method: properties.recurringAudienceLists.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListRecurringAudienceListsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists all recurring audience lists for a property. This method can be used for you to find and reuse existing recurring audience lists rather than creating unnecessary new recurring audience lists. The same audience can have multiple recurring audience lists that represent different dimension combinations; for example, just the dimension `deviceId` or both the dimensions `deviceId` and `userId`.\n\nThis method is introduced at alpha stability with the intention of gathering feedback on syntax and capabilities before entering beta. To give your feedback on this API, complete the [Google Analytics Audience Export API Feedback](https://forms.gle/EeA5u5LW6PEggtCEA) form.\n\n### HTTP request\n\n`GET https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/recurringAudienceLists`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-----------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. All recurring audience lists for this property will be listed in the response. Format: `properties/{property}` |\n\n### Query parameters\n\n| Parameters ||\n|---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `page``Size` | `integer` Optional. The maximum number of recurring audience lists to return. The service may return fewer than this value. If unspecified, at most 200 recurring audience lists will be returned. The maximum value is 1000 (higher values will be coerced to the maximum). |\n| `page``Token` | `string` Optional. A page token, received from a previous `recurringAudienceLists.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `recurringAudienceLists.list` must match the call that provided the page token. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA list of all recurring audience lists for a property.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"recurringAudienceLists\": [ { object (/analytics/devguides/reporting/data/v1/rest/v1alpha/properties.recurringAudienceLists#RecurringAudienceList) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|--------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `recurring``Audience``Lists[]` | `object (`[RecurringAudienceList](/analytics/devguides/reporting/data/v1/rest/v1alpha/properties.recurringAudienceLists#RecurringAudienceList)`)` Each recurring audience list for a property. |\n| `next``Page``Token` | `string` A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/analytics.readonly`\n- `https://www.googleapis.com/auth/analytics`"]]
