Method: customers.enterprise.securityInsights.queryUrlVisitsBreakdowns

تعرض هذه الطريقة ملخّصات لزيارات عناوين URL لمقياس معيّن وسمة تقسيم.

طلب HTTP

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/enterprise/securityInsights:queryUrlVisitsBreakdowns

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
customer

string

الحقل مطلوب. معرّف العميل بالتنسيق "customers/{customer_id}".

مَعلمات طلب البحث

المعلمات
pageSize

integer

اختياريّ. الحدّ الأقصى لعدد التقسيمات المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديدها، سيتم عرض 50 تقسيمًا على الأكثر. الحد الأقصى للقيمة هو 1000، وسيتم فرض القيمة 1000 على القيم الأعلى من 1000.
pageToken

string

اختياريّ. رمز مميز للصفحة تم تلقّيه من طلب securityInsights.queryUrlVisitsBreakdowns سابق. يجب تقديم هذا الرمز لاسترداد الصفحة التالية.

عند تقسيم النتائج إلى صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى securityInsights.queryUrlVisitsBreakdowns مع الطلب الذي قدّم رمز الصفحة المميّز.
filter

string

اختياريّ. الفلتر الذي سيتم تطبيقه على الطلب. للاطّلاع على البنية، يُرجى الرجوع إلى AIP-160. لا تتوفّر البيانات للأحداث التي مرّ عليها أكثر من 180 يومًا أو التي حدثت قبل أقل من 48 ساعة. إذا لم يتم تحديد event_time، ستنتهي النتائج قبل 48 ساعة.

الحقول المتاحة للفلترة: - user - event_domain - event_time

تتطلّب الفلترة حسب user أو event_domain ضبط السمة breakdown على القيمة المناسبة (على سبيل المثال، يجب ضبط breakdown = USER للفلترة حسب user).

عوامل التشغيل المتوافقة: - = لـ user وevent_domain ‫- <= مقابل event_time

حروف العطف المتاحة: - AND

مثلاً: user = "testuser" AND event_time <= "2024-01-02T00:00:00Z"
metric

enum (UrlVisitsMetric)

اختياريّ. المقياس الذي سيتم عرض تفاصيله. القيمة التلقائية هي URL_VISITS_METRIC_TOTAL_SUSPICIOUS_URL_VISITS.
breakdown

enum (UrlVisitsBreakdownDimension)

اختياريّ. السمة التي يتم تقسيم زيارات عناوين URL حسبها. القيمة التلقائية هي USER.
fixedTimeRange

enum (FixedTimeRange)

اختياريّ. النطاق الزمني الثابت الذي سيتم عرض تفاصيله. القيمة التلقائية هي FIXED_TIME_RANGE_FOUR_WEEKS. يتم استخدام نطاقات زمنية ثابتة للسماح بالحساب المسبق وتحسين مدد الاستجابة.

نص الطلب

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

نص الاستجابة

رسالة الردّ على securityInsights.queryUrlVisitsBreakdowns

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "urlVisitsBreakdowns": [
    {
      object (UrlVisitsBreakdown)
    }
  ],
  "nextPageToken": string
}
الحقول
urlVisitsBreakdowns[]

object (UrlVisitsBreakdown)

تفاصيل زيارات عناوين URL من الإحصاءات المحدّدة
nextPageToken

string

رمز مميز يمكن إرساله كـ pageToken لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

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

يجب توفير أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/chrome.management.securityinsights.readonly
  • https://www.googleapis.com/auth/chrome.management.securityinsights

UrlVisitsBreakdownDimension

السمة التي يتم تقسيم زيارات عناوين URL حسبها.

عمليات التعداد
URL_VISITS_BREAKDOWN_DIMENSION_UNSPECIFIED سمة التفاصيل غير محدّدة. القيمة التلقائية هي USER.
USER التقسيم حسب المستخدم
EVENT_DOMAIN التقسيم حسب نطاق الحدث

UrlVisitsBreakdown

ملخّص لزيارات عناوين URL لسمة تقسيم معيّنة

تمثيل JSON 
{
  "summary": {
    object (UrlVisitsSummary)
  },

  // Union field dimension can be only one of the following:
  "user": string,
  "eventDomain": string
  // End of list of possible types for union field dimension.
}
الحقول
summary

object (UrlVisitsSummary)

ملخّص لزيارات عناوين URL لسمة التقسيم
حقل الربط dimension السمة المستخدَمة في التقسيم يمكن أن يكون التعليق dimension إحدى القيم التالية فقط:
user

string

المستخدم الذي زار عنوان URL
eventDomain

string

نطاق الحدث لزيارات عناوين URL