Method: customers.enterprise.securityInsights.queryUrlVisitsBreakdowns

خلاصه‌ای از بازدیدهای URL را برای یک معیار و بُعد تفکیک‌شده‌ی مشخص برمی‌گرداند.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
customer

string

الزامی. شناسه مشتری با فرمت "customers/{customer_id}".

پارامترهای پرس و جو

پارامترها
pageSize

integer

اختیاری. حداکثر تعداد خرابی‌هایی که باید برگردانده شود. سرویس ممکن است کمتر از این مقدار را برگرداند. در صورت عدم تعیین، حداکثر ۵۰ خرابی برگردانده خواهد شد. حداکثر مقدار ۱۰۰۰ است؛ مقادیر بالاتر از ۱۰۰۰ به ۱۰۰۰ کاهش داده می‌شوند.

pageToken

string

اختیاری. یک توکن صفحه، که از فراخوانی قبلی securityInsights.queryUrlVisitsBreakdowns دریافت شده است. این را برای بازیابی صفحه بعدی ارائه دهید.

هنگام صفحه‌بندی، تمام پارامترهای دیگر ارائه شده به securityInsights.queryUrlVisitsBreakdowns باید با فراخوانی که توکن صفحه را ارائه داده است، مطابقت داشته باشند.

filter

string

Optional. The filter to apply to the request. For syntax, see AIP-160. Data is not available for events older than 180 days or more recent than 48 hours ago. If event_time is not specified, results will end 48 hours ago.

فیلدهای پشتیبانی شده برای فیلتر کردن: - user - event_domain - event_time

فیلتر کردن بر اساس user یا event_domain مستلزم آن است که بُعد تجزیه ( breakdown dimension) روی مقدار مربوطه تنظیم شود (مثلاً، برای فیلتر کردن بر اساس user باید breakdown = USER را تنظیم کنید).

عملگرهای پشتیبانی‌شده: - = برای user و event_domain . - <= برای event_time .

حروف ربط پشتیبانی شده: - AND

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

metric

enum ( UrlVisitsMetric )

Optional. The metric to return the breakdowns for. Defaults to 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 )

The URL visit breakdowns from the specified insight.

nextPageToken

string

یک توکن، که می‌تواند به عنوان pageToken برای بازیابی صفحه بعدی ارسال شود. اگر این فیلد حذف شود، صفحات بعدی وجود نخواهند داشت.

دامنه‌های مجوز

به یکی از حوزه‌های OAuth زیر نیاز دارد:

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

بازدیدهای آدرس (URL)

بُعدی برای تجزیه بازدیدهای URL بر اساس آن.

انوم‌ها
URL_VISITS_BREAKDOWN_DIMENSION_UNSPECIFIED ابعاد خرابی نامشخص. پیش‌فرض روی کاربر.
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 فیلد Union. بُعد برای تجزیه. dimension می‌تواند فقط یکی از موارد زیر باشد:
user

string

کاربری که از URL بازدید کرده است.

eventDomain

string

دامنه رویداد مربوط به بازدیدهای URL.