سرور MCP را برای Google Analytics امتحان کنید. از
GitHub نصب کنید و برای جزئیات بیشتر به
اطلاعیه مراجعه کنید.
Method: properties.conversionEvents.list
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
منسوخ شده: به جای آن از ListKeyEvents استفاده کنید. فهرستی از رویدادهای تبدیل را در ویژگی والد مشخص شده برمی گرداند.
اگر هیچ رویداد تبدیلی پیدا نشد، یک لیست خالی برمی گرداند.
درخواست HTTP
GET https://analyticsadmin.googleapis.com/v1alpha/{parent=properties/*}/conversionEvents
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
parent | string مورد نیاز. نام منبع ویژگی والد. مثال: 'properties/123' |
پارامترهای پرس و جو
| پارامترها |
|---|
pageSize | integer حداکثر تعداد منابع برای بازگشت. اگر نامشخص باشد، حداکثر 50 منبع برگردانده می شود. حداکثر مقدار 200 است. (مقادیر بالاتر تا حداکثر اجباری خواهد بود) |
pageToken | string یک نشانه صفحه، دریافت شده از تماس قبلی conversionEvents.list . این را برای بازیابی صفحه بعدی ارائه کنید. هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به conversionEvents.list باید با فراخوانی که نشانه صفحه را ارائه می کند مطابقت داشته باشد. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
پیام پاسخ برای conversionEvents.list RPC.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"conversionEvents": [
{
object (ConversionEvent)
}
],
"nextPageToken": string
} |
| فیلدها |
|---|
conversionEvents[] | object ( ConversionEvent ) رویدادهای تبدیل درخواستی |
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 و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eRetrieves a list of conversion events within a specified Google Analytics 4 property.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by parent property and pagination for large result sets.\u003c/p\u003e\n"],["\u003cp\u003eReturns event details including name, creation time, and custom event parameters.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific authorization scopes for data access.\u003c/p\u003e\n"],["\u003cp\u003eDeprecated and recommended to use \u003ccode\u003eListKeyEvents\u003c/code\u003e instead.\u003c/p\u003e\n"]]],["This document details the deprecated `conversionEvents.list` API endpoint, replaced by `ListKeyEvents`. It retrieves conversion events for a specified property via a `GET` request to the provided URL using gRPC Transcoding. The `parent` path parameter (e.g., 'properties/123') is required. Optional query parameters `pageSize` (max 200) and `pageToken` allow for pagination. The request body must be empty. The response, formatted in JSON, includes a list of conversion events and a `nextPageToken` for further pagination. Authorization requires either `analytics.readonly` or `analytics.edit` OAuth scopes.\n"],null,["# Method: properties.conversionEvents.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.ListConversionEventsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\n| This item is deprecated!\nDeprecated: Use `ListKeyEvents` instead. Returns a list of conversion events in the specified parent property.\n\nReturns an empty list if no conversion events are found.\n\n### HTTP request\n\n`GET https://analyticsadmin.googleapis.com/v1alpha/{parent=properties/*}/conversionEvents`\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 `conversionEvents.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `conversionEvents.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 conversionEvents.list RPC.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"conversionEvents\": [ { object (/analytics/devguides/config/admin/v1/rest/v1alpha/properties.conversionEvents#ConversionEvent) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `conversionEvents[]` | `object (`[ConversionEvent](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.conversionEvents#ConversionEvent)`)` The requested conversion 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`"]]
