Method: properties.keyEvents.list

تعرِض هذه الدالة قائمة بالأحداث الرئيسية في السمة الرئيسية المحدّدة. تعرِض هذه الدالة قائمة فارغة في حال عدم العثور على أيّ أحداث رئيسية.

طلب HTTP

GET https://analyticsadmin.googleapis.com/v1beta/{parent=properties/*}/keyEvents

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
parent

string

مطلوب. اسم المورد للموقع الرئيسي مثال: ‎'properties/123'

مَعلمات طلب البحث

المعلمات
pageSize

integer

الحد الأقصى لعدد الموارد التي سيتم عرضها إذا لم يتم تحديد عدد، سيتم عرض 50 موردًا بحد أقصى. الحد الأقصى للقيمة هو 200 (سيتم تحويل القيم الأعلى إلى الحد الأقصى)
pageToken

string

رمز مميّز للصفحة، تم تلقّيه من مكالمة keyEvents.list سابقة قدِّم هذا المرجع لاسترداد الصفحة اللاحقة. عند تقسيم الصفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى keyEvents.list مع الطلب الذي قدّم الرمز المميّز للصفحة.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

رسالة الاستجابة لاستدعاء إجراء عن بُعد 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