Method: customers.reports.findSaasUsage

يمكنك العثور على تقارير استخدام SaaS لأحد العملاء استنادًا إلى معايير البحث والترتيب المحدّدة.

طلب HTTP

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:findSaasUsage

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

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

المعلمات
customer

string

الحقل مطلوب. معرّف العميل المموّه الذي يسبقه "customers/C" أو "customers/my_customer"

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

المعلمات
pageSize

integer

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

string

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

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

string

اختياريّ. تعبير الفلتر لتضييق نطاق تقارير SaaS التي سيتم عرضها. عوامل التشغيل المتوافقة هي: =, !=, <, <=, >, >=, :. تتوافق عوامل التشغيل المنطقية AND وOR وNOT.

الحقول المتوافقة:

  • تطبيق
  • orgUnitId
  • firstNavigationTime
  • lastNavigationTime
  • category
  • مؤسسة
  • foundedYear
  • المقر الرئيسي
  • primaryDomain
  • النطاقات
  • encryptionProtocols
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

مثلاً: (firstNavigationTime < "2026-01-31T00:00:00Z" AND lastNavigationTime > "2026-01-01T00:00:00Z") AND visitsCount > 100
orderBy

string

اختياريّ. تعبير الترتيب حسب لترتيب تقارير SaaS

الحقول المتوافقة:

  • تطبيق
  • category
  • مؤسسة
  • foundedYear
  • المقر الرئيسي
  • primaryDomain
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

الترتيب التلقائي هو تصاعدي. لتحديد ترتيب تنازلي لحقل معيّن، أضِف " desc".

مثلاً: visitsCount desc

نص الطلب

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

نص الاستجابة

الردّ على طريقة reports.findSaasUsage

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

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

object (SaasUsageReport)

قائمة تقارير استخدام SaaS
nextPageToken

string

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

string (int64 format)

إجمالي عدد تقارير استخدام برامج كخدمة التي تتطابق مع الطلب.

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

يجب توفير نطاق OAuth التالي:

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

SaasUsageReport

تمثّل إدخالاً واحدًا في تقرير SaaS.

تمثيل JSON 
{
  "app": string,
  "orgUnitId": string,
  "category": string,
  "organization": string,
  "foundedYear": integer,
  "headquarters": string,
  "primaryDomain": string,
  "domains": [
    string
  ],
  "encryptionProtocols": [
    string
  ],
  "visitsCount": string,
  "distinctUsersCount": string,
  "distinctBrowsersCount": string,
  "contentTransferDetails": {
    object (ContentTransferDetails)
  },
  "firstNavigationTime": string,
  "lastNavigationTime": string
}
الحقول
app

string

النتائج فقط. اسم التطبيق.
orgUnitId

string

النتائج فقط. معرّف الوحدة التنظيمية
category

string

النتائج فقط. فئة التطبيق
organization

string

النتائج فقط. تمثّل هذه السمة المؤسسة التي تطوّر التطبيق.
foundedYear

integer

النتائج فقط. تمثّل هذه السمة السنة التي تأسست فيها المؤسسة.
headquarters

string

النتائج فقط. تمثّل هذه السمة الموقع الجغرافي للمقر الرئيسي للمؤسسة.
primaryDomain

string

النتائج فقط. النطاق الأساسي للتطبيق
domains[]

string

النتائج فقط. قائمة بالنطاقات والنطاقات الفرعية المرتبطة بالتطبيق
encryptionProtocols[]

string

النتائج فقط. قائمة ببروتوكولات التشفير المستخدَمة للوصول إلى التطبيق
visitsCount

string (int64 format)

النتائج فقط. إجمالي عدد الزيارات إلى التطبيق.
distinctUsersCount

string (int64 format)

النتائج فقط. عدد المستخدِمين المختلفين الذين زاروا التطبيق.
distinctBrowsersCount

string (int64 format)

النتائج فقط. عدد المتصفّحات المختلفة التي زارت التطبيق.
contentTransferDetails

object (ContentTransferDetails)

النتائج فقط. تقدّم هذه السمة معلومات عن أحداث نقل المحتوى، إذا كانت متاحة.
firstNavigationTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لوقت الانتقال إلى التطبيق لأول مرة

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
lastNavigationTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لآخر مرة تم فيها الانتقال إلى التطبيق

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".

ContentTransferDetails

تقدّم هذه السمة معلومات عن أحداث نقل المحتوى، إذا كانت متاحة.

تمثيل JSON 
{
  "contentTransferCount": string
}
الحقول
contentTransferCount

string (int64 format)

النتائج فقط. إجمالي عدد عمليات نقل المحتوى المرتبطة بالتطبيق