جرِّب خادم MCP لخدمة "إحصاءات Google". يمكنك تثبيت التطبيق من
GitHub والاطّلاع على
الإعلان لمعرفة المزيد من التفاصيل.
Method: properties.conversionEvents.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام ListKeyEvents بدلاً منها. تعرِض هذه الدالة قائمة بأحداث الإحالات الناجحة في الموقع الرئيسي المحدّد.
تعرِض قائمة فارغة في حال عدم العثور على أيّ أحداث إحالات ناجحة.
طلب HTTP
GET https://analyticsadmin.googleapis.com/v1beta/{parent=properties/*}/conversionEvents
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
parent |
string
مطلوب. اسم المورد للموقع الرئيسي مثال: 'properties/123'
|
مَعلمات طلب البحث
| المعلمات |
pageSize |
integer
الحد الأقصى لعدد الموارد التي سيتم عرضها إذا لم يتم تحديد عدد، سيتم عرض 50 موردًا كحد أقصى. الحد الأقصى للقيمة هو 200 (سيتم تحويل القيم الأعلى إلى الحد الأقصى)
|
pageToken |
string
رمز مميّز للصفحة، تم تلقّيه من مكالمة conversionEvents.list سابقة قدِّم هذا المرجع لاسترداد الصفحة اللاحقة. عند تقسيم الصفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى conversionEvents.list مع الطلب الذي قدّم الرمز المميّز للصفحة.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رسالة استجابة لاستدعاء الإجراء عن بُعد conversionEvents.list
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"conversionEvents": [
{
object (ConversionEvent)
}
],
"nextPageToken": string
} |
| الحقول |
conversionEvents[] |
object (ConversionEvent)
أحداث الإحالات الناجحة المطلوبة
|
nextPageToken |
string
رمز مميّز يمكن إرساله على شكل pageToken لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.
|
نطاقات التفويض
يتطلب أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/analytics.readonlyhttps://www.googleapis.com/auth/analytics.edit
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis page details how to retrieve a list of conversion events within a specified Google Analytics 4 property using the \u003ccode\u003econversionEvents.list\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires the \u003ccode\u003eparent\u003c/code\u003e property ID and accepts optional \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e parameters for pagination.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes an array of \u003ccode\u003econversionEvents\u003c/code\u003e objects and a \u003ccode\u003enextPageToken\u003c/code\u003e if additional pages are available.\u003c/p\u003e\n"],["\u003cp\u003eProper authorization with either \u003ccode\u003eanalytics.readonly\u003c/code\u003e or \u003ccode\u003eanalytics.edit\u003c/code\u003e scope is necessary to access this functionality.\u003c/p\u003e\n"]]],["This document details how to list conversion events using the `conversionEvents.list` method, now deprecated in favor of `ListKeyEvents`. The `GET` request to `https://analyticsadmin.googleapis.com/v1beta/{parent=properties/*}/conversionEvents` requires the parent property's resource name in the path. Query parameters include `pageSize` (max 200) and `pageToken` for pagination. The request body is empty. The response, if successful, contains an array of `conversionEvents` and a `nextPageToken` for retrieving further pages. It requires specific authorization scopes such as `analytics.readonly` or `analytics.edit`.\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/v1beta/{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/v1beta/properties.conversionEvents#ConversionEvent) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `conversionEvents[]` | `object (`[ConversionEvent](/analytics/devguides/config/admin/v1/rest/v1beta/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`"]]
