Method: properties.keyEvents.list
הפונקציה מחזירה רשימה של אירועים מרכזיים בנכס ההורה שצוין. הפונקציה מחזירה רשימה ריקה אם לא נמצאו אירועי מפתח.
בקשת HTTP
GET https://analyticsadmin.googleapis.com/v1beta/{parent=properties/*}/keyEvents
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
פרמטרים |
parent |
string
חובה. שם המשאב של נכס ההורה. דוגמה: 'properties/123'
|
פרמטרים של שאילתה
פרמטרים |
pageSize |
integer
המספר המקסימלי של המשאבים להחזרה. אם לא צוין ערך, יוחזרו עד 50 משאבים. הערך המקסימלי הוא 200 (ערכים גבוהים יותר יומרו לערך המקסימלי)
|
pageToken |
string
אסימון דף, שהתקבל משיחה קודמת של keyEvents.list . יש לספק אותו כדי לאחזר את הדף הבא. כשמחלקים את הדפים, כל שאר הפרמטרים שסופקו ל-keyEvents.list חייבים להתאים לקריאה שסיפקה את אסימון הדף.
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
הודעת תגובה ל-RPC של keyEvents.list.
אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:
ייצוג ב-JSON |
{
"keyEvents": [
{
object (KeyEvent )
}
],
"nextPageToken": string
} |
שדות |
keyEvents[] |
object (KeyEvent )
האירועים המרכזיים המבוקשים
|
nextPageToken |
string
אסימון שאפשר לשלוח כ-pageToken כדי לאחזר את הדף הבא. אם השדה הזה לא יצוין, לא יהיו דפים נוספים.
|
היקפי הרשאה
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics.edit
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-01-14 (שעון UTC).
[null,null,["עדכון אחרון: 2025-01-14 (שעון UTC)."],[[["Retrieves a list of Key Events, which are significant changes or actions within a Google Analytics property."],["Allows for filtering by parent property and pagination to manage large result sets."],["Requires specific authorization scopes for access to data."],["Provides a structured JSON response containing Key Events and pagination details."],["Includes links to relevant documentation and code samples for implementation."]]],["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"]]