Method: properties.conversionEvents.list
تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام ListKeyEvents
بدلاً منها. لعرض قائمة بأحداث الإحالات الناجحة في الموقع الرئيسي المحدّد.
تعرِض هذه الدالة قائمة فارغة في حال عدم العثور على أيّ أحداث إحالات ناجحة.
طلب HTTP
GET https://analyticsadmin.googleapis.com/v1alpha/{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.readonly
https://www.googleapis.com/auth/analytics.edit
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-01-14 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-01-14 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Retrieves a list of conversion events within a specified Google Analytics 4 property."],["Allows filtering by parent property and pagination for large result sets."],["Returns event details including name, creation time, and custom event parameters."],["Requires specific authorization scopes for data access."],["Deprecated and recommended to use `ListKeyEvents` instead."]]],["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"]]