Method: customers.enterprise.securityInsights.queryContentTransfersBreakdowns

تعرض هذه السمة ملخّصات لعمليات نقل المحتوى لمقياس معيّن وبُعد تقسيم.

طلب HTTP

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

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

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

المعلمات
customer

string

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

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

المعلمات
pageSize

integer

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

pageToken

string

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

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

filter

string

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

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

تتطلّب الفلترة حسب user أو event_domain ضبط السمة breakdown على القيمة المناسبة (على سبيل المثال، يجب ضبط breakdown = USER للفلترة حسب 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)

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

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

ContentTransfersBreakdownDimension

السمة التي يتم تقسيم عمليات نقل المحتوى حسبها

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

ContentTransfersBreakdown

ملخّص لعمليات نقل المحتوى حسب سمة تقسيم معيّنة

تمثيل 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 السمة المستخدَمة في التقسيم يمكن أن يكون التعليق dimension إحدى القيم التالية فقط:
user

string

المستخدم الذي نقل المحتوى

eventDomain

string

نطاق الأحداث لعمليات نقل المحتوى

contentCategory

string

فئة المحتوى الذي يتم نقله