تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Method: properties.runAccessReport

طلب HTTP
معلمات المسار
نص الطلب
- تمثيل JSON
نص الاستجابة
نطاقات التفويض
جرِّبه الآن

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

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

وتشمل سجلّات الوصول إلى البيانات هذه إعداد تقارير واجهة المستخدم في "إحصاءات Google 4" وأداة "الاستكشافات" في واجهة المستخدم في "إحصاءات Google 4" وواجهة برمجة التطبيقات للبيانات في "إحصاءات Google 4" ومنتجات أخرى مثل Firebase وAdmob التي يمكنها استرداد البيانات من "إحصاءات Google" من خلال ربط. ولا تتضمّن هذه السجلّات تغييرات ضبط الموقع، مثل إضافة مصدر بيانات أو تغيير المنطقة الزمنية للموقع. بالنسبة إلى سجلّ تغييرات الإعدادات، اطّلِع على searchChangeHistoryEvents.

طلب HTTP

POST https://analyticsadmin.googleapis.com/v1alpha/{entity=properties/*}:runAccessReport

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المعلّمات

المعلّمات
`entity`	`string` يتيح تقرير "الوصول إلى البيانات" إجراء الطلبات على مستوى الموقع أو الحساب. وإذا تم طلبها على مستوى الحساب، ستتضمّن "تقارير الوصول إلى البيانات" جميع أذونات الوصول لكل المواقع ضمن هذا الحساب. لتقديم طلب على مستوى الموقع، يجب أن يكون الكيان مثلاً "المواقع/123" إذا كان "123" هو رقم تعريف موقعك على "إحصاءات Google" 4. لتقديم طلب على مستوى الحساب، يجب أن يكون الكيان مثلاً "accounts/1234" إذا كان "1234" هو رقم تعريف حسابك على "إحصاءات Google 4".

entity

string

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

لتقديم طلب على مستوى الموقع، يجب أن يكون الكيان مثلاً "المواقع/123" إذا كان "123" هو رقم تعريف موقعك على "إحصاءات Google" 4. لتقديم طلب على مستوى الحساب، يجب أن يكون الكيان مثلاً "accounts/1234" إذا كان "1234" هو رقم تعريف حسابك على "إحصاءات Google 4".

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON

تمثيل JSON
{ "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 }

{
  "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
}

الحقول
`dimensions[]`	`object (AccessDimension)` السمات المطلوبة والمعروضة في الرد يُسمح بالطلبات حتى 9 سمات.
`metrics[]`	`object (AccessMetric)` المقاييس المطلوبة والمعروضة في الرد. يُسمح بالطلبات لما يصل إلى 10 مقاييس.
`dateRanges[]`	`object (AccessDateRange)` النطاقات الزمنية لسجلات الوصول للقراءة في حال طلب نطاقات زمنية متعددة، سيحتوي كل صف استجابة على فهرس نطاق زمني يستند إلى صفر. وفي حال تداخل نطاقين زمنيين، يتم تضمين سجلات الوصول للأيام المتداخلة في صفوف الاستجابة لكلا النطاقين الزمنيين. يُسمح بالطلبات لمدة تصل إلى نطاقَين زمنيَين.
`dimensionFilter`	`object (AccessFilterExpression)` تتيح لك فلاتر السمات إمكانية تقييد استجابة التقرير لقيم سمات معيّنة تتطابق مع الفلتر. على سبيل المثال، الفلترة حسب سجلّات الوصول لمستخدم واحد لمزيد من المعلومات، اطّلِع على أساسيات فلاتر السمات للحصول على أمثلة. لا يمكن استخدام المقاييس في هذا الفلتر.
`metricFilter`	`object (AccessFilterExpression)` تتيح لك فلاتر المقاييس حصر استجابة التقرير على قيم مقاييس محدّدة تتطابق مع الفلتر. يتم تطبيق فلاتر المقاييس بعد تجميع صفوف التقرير، على غرار شرط SQL. لا يمكن استخدام الأبعاد في هذا الفلتر.
`offset`	`string (int64 format)` عدد الصفوف في صف البدء. يتم احتساب الصف الأول على أنه الصف 0. إذا لم يتم تحديد الإزاحة، يتم التعامل معها على أنها 0. إذا كانت قيمة الإزاحة صفرًا، ستعرض هذه الطريقة الصفحة الأولى من النتائج التي تحتوي على إدخالات `limit`. لمزيد من المعلومات حول معلّمة التقسيم على صفحات، اطّلِع على تقسيم النتائج على عدّة صفحات.
`limit`	`string (int64 format)` عدد الصفوف المطلوب عرضها. وإذا لم يتم تحديدها، سيتم عرض 10,000 صف. تعرض واجهة برمجة التطبيقات 100,000 صف كحد أقصى لكل طلب، بغض النظر عن العدد الذي تطلبه. يجب أن تكون قيمة `limit` موجبة. قد تعرض واجهة برمجة التطبيقات عددًا أقل من الصفوف المطلوبة من `limit`، إذا لم يكن هناك عدد كبير من الصفوف المتبقية مثل `limit`. على سبيل المثال، هناك أقل من 300 قيمة محتملة للسمة "`country`"، لذلك عند إعداد التقارير عن `country` فقط، لا يمكنك الحصول على أكثر من 300 صف، حتى إذا ضبطت "`limit`" على قيمة أعلى. لمزيد من المعلومات حول معلّمة التقسيم على صفحات، اطّلِع على تقسيم النتائج على عدّة صفحات.
`timeZone`	`string` المنطقة الزمنية لهذا الطلب في حال تحديدها. وفي حال عدم تحديد المنطقة الزمنية، يتم استخدام المنطقة الزمنية للموقع. يتم استخدام المنطقة الزمنية للطلب لتفسير تاريخَي البدء والانتهاء للتقرير. ويتم تنسيقها كسلاسل من قاعدة بيانات المنطقة الزمنية IANA (https://www.iana.org/time-zones)، على سبيل المثال "America/New_York" أو "آسيا/طوكيو".
`orderBys[]`	`object (AccessOrderBy)` يحدّد كيفية ترتيب الصفوف في الاستجابة.
`returnEntityQuota`	`boolean` يعرض ما إذا كان سيتم عرض الحالة الحالية لحصة هذا الموقع على "إحصاءات Google". يتم عرض الحصة في AccessQuota. وبالنسبة إلى الطلبات على مستوى الحساب، يجب أن يكون هذا الحقل غير صحيح.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال RunAccessReportResponse.

نطاقات الأذونات

يتطلب ذلك أحد نطاقات OAuth التالية:

https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics.edit