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 مع الطلب الذي وفّر الرمز المميّز للصفحة.

نص الطلب

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

نص الاستجابة

رسالة الاستجابة لـ keyEvent.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