سرور MCP را برای Google Analytics امتحان کنید. از
GitHub نصب کنید و برای جزئیات بیشتر به
اطلاعیه مراجعه کنید.
Method: properties.keyEvents.list
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
لیستی از رویدادهای کلیدی (Key Events) را در ویژگی والد مشخص شده برمیگرداند. در صورت عدم یافتن رویدادهای کلیدی، لیست خالی را برمیگرداند.
درخواست HTTP
GET https://analyticsadmin.googleapis.com/v1alpha/{parent=properties/*}/keyEvents
این URL از سینتکس Transcoding در gRPC استفاده میکند.
پارامترهای مسیر
| پارامترها |
|---|
parent | string الزامی. نام منبعِ ویژگیِ والد. مثال: 'properties/123' |
پارامترهای پرس و جو
| پارامترها |
|---|
pageSize | integer اختیاری. حداکثر تعداد منابعی که باید برگردانده شوند. اگر مشخص نشود، حداکثر ۵۰ منبع برگردانده خواهد شد. حداکثر مقدار ۲۰۰ است؛ (مقادیر بالاتر به حداکثر مقدار خود محدود میشوند) |
pageToken | string اختیاری. یک توکن صفحه، که از فراخوانی قبلی keyEvents.list دریافت شده است. این را برای بازیابی صفحه بعدی ارائه دهید. هنگام صفحهبندی، تمام پارامترهای دیگر ارائه شده به keyEvents.list باید با فراخوانی که توکن صفحه را ارائه داده است، مطابقت داشته باشند. |
درخواست بدنه
بدنه درخواست باید خالی باشد.
بدنه پاسخ
پیام پاسخ برای keyEvents.list RPC.
در صورت موفقیت، بدنه پاسخ شامل دادههایی با ساختار زیر است:
| نمایش 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 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2026-04-14 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2026-04-14 بهوقت ساعت هماهنگ جهانی."],[],["This document details how to retrieve a list of Key Events associated with a specific property. A `GET` request to the provided URL, including the property's ID in the `parent` path parameter, is used. Optional `pageSize` and `pageToken` query parameters facilitate pagination. The request body must be empty. The response, formatted as JSON, contains an array of `keyEvents` and an optional `nextPageToken` for subsequent pages. It requires specific OAuth authorization scopes.\n"]]