Method: customers.enterprise.securityInsights.queryContentTransfersBreakdowns

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

درخواست HTTP

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

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

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

پارامترها
customer

string

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

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

پارامترها
pageSize

integer

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

pageToken

string

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

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

filter

string

اختیاری. فیلتری که برای درخواست اعمال می‌شود. برای نحوه‌ی نمایش، به AIP-160 مراجعه کنید. داده‌ها برای رویدادهای قدیمی‌تر از ۱۸۰ روز یا جدیدتر از ۴۸ ساعت پیش در دسترس نیستند. اگر event_time مشخص نشده باشد، نتایج ۴۸ ساعت پیش به پایان می‌رسند.

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

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

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

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

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

metric

enum ( ContentTransfersMetric )

اختیاری. معیاری که جزئیات را برای آن برمی‌گرداند. مقدار پیش‌فرض CONTENT_TRANSFERS_METRIC_TOTAL_TRANSFERS است.

breakdown

enum ( ContentTransfersBreakdownDimension )

اختیاری. بُعدی که انتقال محتوا بر اساس آن تفکیک می‌شود. پیش‌فرض روی کاربر.

fixedTimeRange

enum ( FixedTimeRange )

اختیاری. محدوده زمانی ثابت برای بازگرداندن جزئیات. پیش‌فرض FIXED_TIME_RANGE_FOUR_WEEKS. محدوده‌های زمانی ثابت برای امکان پیش‌محاسبات و بهینه‌سازی زمان پاسخ استفاده می‌شوند.

درخواست بدنه

بدنه درخواست باید خالی باشد.

بدنه پاسخ

پیام پاسخ برای securityInsights.queryContentTransfersBreakdowns.

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "contentTransfersBreakdowns": [
    {
      object (ContentTransfersBreakdown)
    }
  ],
  "nextPageToken": string
}
فیلدها
contentTransfersBreakdowns[]

object ( ContentTransfersBreakdown )

تجزیه و تحلیل انتقال محتوا از بینش مشخص شده.

nextPageToken

string

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

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

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

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

ابعاد تفکیکی انتقال محتوا

بُعدی که محتوا را بر اساس آن تجزیه و تحلیل می‌کنیم.

انوم‌ها
CONTENT_TRANSFERS_BREAKDOWN_DIMENSION_UNSPECIFIED ابعاد خرابی نامشخص. پیش‌فرض روی کاربر.
USER تفکیک بر اساس کاربر.
EVENT_DOMAIN تفکیک بر اساس دامنه رویداد.
CONTENT_CATEGORY تفکیک بر اساس دسته‌بندی محتوا.

تجزیه و تحلیل انتقال محتوا

یک محتوا، خلاصه‌ای را برای یک بعد تفکیک‌شده‌ی مشخص منتقل می‌کند.

نمایش JSON 
{
  "summary": {
    object (ContentTransfersSummary)
  },

  // Union field dimension can be only one of the following:
  "user": string,
  "eventDomain": string,
  "contentCategory": string
  // End of list of possible types for union field dimension.
}
فیلدها
summary

object ( ContentTransfersSummary )

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

dimension فیلد Union. بُعد برای تجزیه. dimension می‌تواند فقط یکی از موارد زیر باشد:
user

string

کاربری که محتوا را منتقل کرده است.

eventDomain

string

دامنه رویداد محتوا منتقل می‌شود.

contentCategory

string

دسته بندی محتوای انتقال محتوا.