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)

تسمح لك فلاتر المقاييس بحصر استجابة التقرير في قيم مقاييس معيّنة تتطابق مع الفلتر. يتم تطبيق فلاتر المقاييس بعد تجميع صفوف التقرير، تمامًا مثل عبارة having في لغة الاستعلامات البنيوية (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

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

boolean

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