Method: properties.runAccessReport

{
  "dimensions": [
    {
      object (AccessDimension)
    }
  ],
  "metrics": [
    {
      object (AccessMetric)
    }
  ],
  "dateRanges": [
    {
      object (AccessDateRange)
    }
  ],
  "dimensionFilter": {
    object (AccessFilterExpression)
  },
  "metricFilter": {
    object (AccessFilterExpression)
  },
  "offset": string,
  "limit": string,
  "timeZone": string,
  "orderBys": [
    {
      object (AccessOrderBy)
    }
  ],
  "returnEntityQuota": boolean,
  "includeAllUsers": boolean,
  "expandGroups": boolean
}

object (AccessDimension)

السمات المطلوبة والمعروضة في الردّ يمكن إرسال الطلبات بما يصل إلى 9 سمات.

object (AccessMetric)

المقاييس المطلوبة والمعروضة في الردّ يُسمح للطلبات بما يصل إلى 10 مقاييس.

object (AccessDateRange)

النطاقات الزمنية لسجلّات الوصول المطلوب قراءتها. في حال طلب نطاقات زمنية متعددة، سيحتوي كل صف للاستجابة على فهرس نطاق زمني يستند إلى صفر. في حال تداخل نطاقَين زمنيَين، يتم تضمين سجلّات الوصول للأيام المتداخلة في صفوف الردّ لكلا النطاقَين الزمنيَين. يُسمح للطلبات بما يصل إلى نطاقين زمنيين.

object (AccessFilterExpression)

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

object (AccessFilterExpression)

تسمح لك فلاتر المقاييس بحصر ردّ التقرير على قيم مقاييس معيّنة تتطابق مع الفلتر. يتم تطبيق فلاتر المقاييس بعد تجميع صفوف التقرير، وهي تشبه عبارة SQL التي تحتوي على عبارة. لا يمكن استخدام السمات في هذا الفلتر.

string (int64 format)

عدد الصفوف في صف البداية. يتم احتساب الصف الأول على أنه الصف 0. إذا لم يتم تحديد الإزاحة، يتم التعامل معها على أنها 0. إذا كانت الإزاحة صفرًا، ستعرض هذه الطريقة أول صفحة من النتائج مع إدخالات limit.

لمزيد من المعلومات عن مَعلمة التقسيم على صفحات هذه، اطّلِع على تقسيم النتائج على عدّة صفحات.

string (int64 format)

عدد الصفوف المطلوب عرضها. وفي حال عدم تحديد قيمة، يتم عرض 10,000 صف. تعرض واجهة برمجة التطبيقات 100,000 صف كحد أقصى لكل طلب، بغض النظر عن العدد الذي تطلبه. يجب أن تكون قيمة الحقل "limit" موجبة.

قد تعرِض واجهة برمجة التطبيقات صفوفًا أقل من limit المطلوبة، إذا لم يكن هناك عدد صفوف متبقّية مثل limit. على سبيل المثال، هناك أقل من 300 قيمة محتملة للسمة country، لذلك عند إعداد التقارير عن country فقط، لا يمكنك الحصول على أكثر من 300 صف، حتى في حال ضبط limit على قيمة أعلى.

لمزيد من المعلومات عن مَعلمة التقسيم على صفحات هذه، اطّلِع على تقسيم النتائج على عدّة صفحات.

string

المنطقة الزمنية لهذا الطلب، إذا تم تحديدها. في حال عدم تحديدها، يتم استخدام المنطقة الزمنية للموقع. يتم استخدام المنطقة الزمنية للطلب لتفسير تاريخي البدء والانتهاء للتقرير.

ويتم تنسيقها كسلاسل من قاعدة بيانات المنطقة الزمنية التي وضعتها هيئة أرقام الإنترنت المخصصة (IANA) (https://www.iana.org/time-zones)، على سبيل المثال "America/New_York" أو "آسيا/طوكيو".

object (AccessOrderBy)

لتحديد كيفية ترتيب الصفوف في الاستجابة.

boolean

تبديل ما إذا كان سيتم عرض الحالة الحالية لحصة موقع "إحصاءات Google" هذا. يتم عرض الحصة في AccessQuota. بالنسبة إلى الطلبات على مستوى الحساب، يجب أن يكون هذا الحقل خطأ.

boolean

اختياريّ. تحدِّد ما إذا كان سيتم تضمين المستخدمين الذين لم يسبق لهم إجراء طلب بيانات من واجهة برمجة التطبيقات في الرد. إذا كانت الإجابة "صحيح"، يتم تضمين جميع المستخدِمين الذين لديهم إذن الوصول إلى الموقع أو الحساب المحدّدَين في الردّ، بغض النظر عمّا إذا كانوا قد أجروا طلب بيانات من واجهة برمجة التطبيقات أم لا. وفي حال اختيار القيمة "false"، لن يتم تضمين سوى المستخدمين الذين أجروا طلب بيانات من واجهة برمجة التطبيقات.

boolean

اختياريّ. يحدد ما إذا كان سيتم عرض المستخدمين داخل مجموعات المستخدمين. لا يعمل هذا الحقل إلا عند ضبط includeAllUsers على "صحيح". إذا كانت القيمة true، ستعرض جميع المستخدِمين الذين لديهم الإذن بالوصول إلى الموقع أو الحساب المحدّدَين. في حال اختيار القيمة "false"، سيتم عرض المستخدمين الذين لديهم إذن وصول مباشر فقط.