Method: customers.reports.findSaasUsageBrowsers

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

طلب HTTP

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

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

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

المعلمات
customer

string

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

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

المعلمات
app

string

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

integer

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

string

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

string

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

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

  • آلة
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
  • orgUnitId
orderBy

string

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

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

  • آلة
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime

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

نص الطلب

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

نص الاستجابة

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

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

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

object (SaasUsageBrowser)

قائمة بتقارير متصفّحات استخدام SaaS
nextPageToken

string

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

string (int64 format)

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

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

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

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

SaasUsageBrowser

تفاصيل متصفّح استخدام SaaS

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

string

النتائج فقط. اسم الجهاز
devicePermanentId

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

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