RunAccessReportResponse

الردّ المخصّص لتقرير سجلّ الوصول إلى البيانات

تمثيل JSON
{
  "dimensionHeaders": [
    {
      object (AccessDimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (AccessMetricHeader)
    }
  ],
  "rows": [
    {
      object (AccessRow)
    }
  ],
  "rowCount": integer,
  "quota": {
    object (AccessQuota)
  }
}
الحقول
dimensionHeaders[]

object (AccessDimensionHeader)

عنوان أحد الأعمدة في التقرير الذي يتطابق مع سمة معيّنة. يتطابق عدد أبعاد الأبعاد وترتيب أبعادها مع السمات الموجودة في الصفوف.

metricHeaders[]

object (AccessMetricHeader)

عنوان عمود في التقرير يقابل مقياسًا معيّنًا. يتطابق عدد MetricHeaders وترتيبها MetricHeaders في المقاييس الموجودة في الصفوف.

rows[]

object (AccessRow)

صفوف مجموعات قيم السمات وقيم المقاييس في التقرير

rowCount

integer

إجمالي عدد الصفوف في نتيجة طلب البحث. وتكون rowCount مستقلة عن عدد الصفوف التي يتم عرضها في الاستجابة ومَعلمة الطلب limit ومَعلمة الطلب offset. على سبيل المثال، إذا عرض طلب بحث 175 صفًا ويتضمّن limit من 50 صفًا في طلب البيانات من واجهة برمجة التطبيقات، ستحتوي الاستجابة على rowCount من 175 صفًا ولكنّها 50 صفًا فقط.

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

quota

object (AccessQuota)

حالة الحصة لهذا الموقع على "إحصاءات Google"، بما في ذلك هذا الطلب. لا يعمل هذا الحقل مع الطلبات على مستوى الحساب.

AccessDimensionHeader

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

تمثيل JSON
{
  "dimensionName": string
}
الحقول
dimensionName

string

اسم السمة، على سبيل المثال "userEmail".

AccessMetricHeader

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

تمثيل JSON
{
  "metricName": string
}
الحقول
metricName

string

اسم المقياس، على سبيل المثال "accessCount"

AccessRow

الوصول إلى بيانات التقرير لكل صف

تمثيل JSON
{
  "dimensionValues": [
    {
      object (AccessDimensionValue)
    }
  ],
  "metricValues": [
    {
      object (AccessMetricValue)
    }
  ]
}
الحقول
dimensionValues[]

object (AccessDimensionValue)

قائمة قيم السمات وتكون هذه القيم بالترتيب نفسه المحدّد في الطلب.

metricValues[]

object (AccessMetricValue)

قائمة قيم المقاييس وتكون هذه القيم بالترتيب نفسه المحدّد في الطلب.

AccessDimensionValue

قيمة السمة.

تمثيل JSON
{
  "value": string
}
الحقول
value

string

قيمة السمة على سبيل المثال، قد تكون هذه القيمة "فرنسا" لبُعد "البلد".

AccessMetricValue

قيمة المقياس.

تمثيل JSON
{
  "value": string
}
الحقول
value

string

قيمة القياس. على سبيل المثال، قد تكون هذه القيمة "13".

AccessQuota

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

تمثيل JSON
{
  "tokensPerDay": {
    object (AccessQuotaStatus)
  },
  "tokensPerHour": {
    object (AccessQuotaStatus)
  },
  "concurrentRequests": {
    object (AccessQuotaStatus)
  },
  "serverErrorsPerProjectPerHour": {
    object (AccessQuotaStatus)
  },
  "tokensPerProjectPerHour": {
    object (AccessQuotaStatus)
  }
}
الحقول
tokensPerDay

object (AccessQuotaStatus)

يمكن للمواقع الإلكترونية استخدام 250,000 رمز مميّز في اليوم. تستهلك معظم الطلبات أقل من 10 رموز مميّزة.

tokensPerHour

object (AccessQuotaStatus)

يمكن للمواقع الإلكترونية استخدام 50,000 رمز مميّز في الساعة. يستهلك طلب واجهة برمجة التطبيقات عددًا واحدًا من الرموز المميّزة، ويتم خصم هذا الرقم من جميع الحصص بالساعة واليومية ولكل مشروع.

concurrentRequests

object (AccessQuotaStatus)

يمكن للمواقع أن تستخدم ما يصل إلى 50 طلبًا متزامنًا.

serverErrorsPerProjectPerHour

object (AccessQuotaStatus)

يمكن أن تتضمن المواقع وأزواج المشاريع على السحابة الإلكترونية ما يصل إلى 50 خطأً في الخادم في الساعة.

tokensPerProjectPerHour

object (AccessQuotaStatus)

يمكن للعقارات استخدام ما يصل إلى 25% من الرموز المميزة لكل مشروع في الساعة. وهذا المبلغ بالنسبة إلى مواقع "إحصاءات Google 360" يمكن أن يستخدم 12,500 رمز مميّز لكل مشروع في الساعة. يستهلك طلب واجهة برمجة التطبيقات عددًا واحدًا من الرموز المميّزة، ويتم خصم هذا الرقم من جميع الحصص بالساعة واليومية ولكل مشروع.

AccessQuotaStatus

الحالة الحالية لمجموعة حصص معيّنة.

تمثيل JSON
{
  "consumed": integer,
  "remaining": integer
}
الحقول
consumed

integer

الحصة التي يستهلكها هذا الطلب.

remaining

integer

الحصة المتبقية بعد هذا الطلب.