Method: customers.reports.findSaasUsageProfiles

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

طلب HTTP

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

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

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

المعلمات
customer

string

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

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

المعلمات
app

string

الحقل مطلوب. اسم تطبيق SaaS (مثل ChatGPT أو Gemini)
pageSize

integer

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

string

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

string

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

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

  • البريد الإلكتروني
  • orgUnitId
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
orderBy

string

اختياريّ. تعبير الترتيب حسب لترتيب تقارير ملفات SaaS الشخصية

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

  • البريد الإلكتروني
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime

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

نص الطلب

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

نص الاستجابة

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

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

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

object (SaasUsageProfileReport)

قائمة بتقارير ملفات تعريف استخدام SaaS
nextPageToken

string

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

string (int64 format)

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

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

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

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

SaasUsageProfileReport

تمثّل هذه السمة إدخال تقرير SaaS واحدًا مجمّعًا حسب الملف الشخصي.

تمثيل JSON 
{
  "email": string,
  "profilePermanentId": string,
  "firstNavigationTime": string,
  "lastNavigationTime": string,
  "orgUnitId": string,
  "osPlatform": enum (DeviceSystem),
  "osVersion": string
}
الحقول
email

string

النتائج فقط. البريد الإلكتروني للمستخدم
profilePermanentId

string

النتائج فقط. المعرّف الدائم للملف الشخصي.
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".
orgUnitId

string

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

enum (DeviceSystem)

النتائج فقط. النظام الأساسي لنظام التشغيل
osVersion

string

النتائج فقط. إصدار نظام التشغيل