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.keyEvents.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.
Trả về danh sách các Sự kiện chính trong thuộc tính mẹ đã chỉ định. Trả về một danh sách trống nếu không tìm thấy Sự kiện chính.
Yêu cầu HTTP
GET https://analyticsadmin.googleapis.com/v1beta/{parent=properties/*}/keyEvents
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ên tài nguyên của thuộc tính mẹ. Ví dụ: "properties/123"
|
Tham số truy vấn
| Tham số |
pageSize |
integer
Số lượng tài nguyên tối đa cần trả về. Nếu bạn không chỉ định, hàm sẽ trả về tối đa 50 tài nguyên. Giá trị tối đa là 200; (giá trị cao hơn sẽ bị buộc đạt giá trị tối đa)
|
pageToken |
string
Mã thông báo trang, nhận được từ lệnh gọi keyEvents.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 keyEvents.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 RPC keyEvents.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 |
{
"keyEvents": [
{
object (KeyEvent)
}
],
"nextPageToken": string
} |
| Trường |
keyEvents[] |
object (KeyEvent)
Sự kiện chính được yêu cầu
|
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.readonlyhttps://www.googleapis.com/auth/analytics.edit
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\u003eRetrieves a list of Key Events, which are significant changes or actions within a Google Analytics property.\u003c/p\u003e\n"],["\u003cp\u003eAllows for filtering by parent property and pagination to manage large result sets.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific authorization scopes for access to data.\u003c/p\u003e\n"],["\u003cp\u003eProvides a structured JSON response containing Key Events and pagination details.\u003c/p\u003e\n"],["\u003cp\u003eIncludes links to relevant documentation and code samples for implementation.\u003c/p\u003e\n"]]],["This document details how to list Key Events via an HTTP GET request to `https://analyticsadmin.googleapis.com/v1beta/{parent=properties/*}/keyEvents`. It requires a `parent` path parameter specifying the property, and optional `pageSize` and `pageToken` query parameters for pagination. The request body must be empty. A successful response returns a JSON structure containing an array of `keyEvents` and a `nextPageToken` for further pagination. Authorization requires specific OAuth scopes.\n"],null,["# Method: properties.keyEvents.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.ListKeyEventsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReturns a list of Key Events in the specified parent property. Returns an empty list if no Key Events are found.\n\n### HTTP request\n\n`GET https://analyticsadmin.googleapis.com/v1beta/{parent=properties/*}/keyEvents`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|----------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The resource name of the parent property. Example: 'properties/123' |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200; (higher values will be coerced to the maximum) |\n| `pageToken` | `string` A page token, received from a previous `keyEvents.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `keyEvents.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\nResponse message for keyEvents.list RPC.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"keyEvents\": [ { object (/analytics/devguides/config/admin/v1/rest/v1beta/properties.keyEvents#KeyEvent) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------|\n| `keyEvents[]` | `object (`[KeyEvent](/analytics/devguides/config/admin/v1/rest/v1beta/properties.keyEvents#KeyEvent)`)` The requested Key Events |\n| `nextPageToken` | `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.edit`"]]
