Method: customers.reports.findSaasUsageBrowsers

گزارش‌های استفاده از SaaS یک مشتری را که بر اساس مرورگرها و بر اساس معیارهای جستجو و مرتب‌سازی داده شده، گروه‌بندی شده‌اند، پیدا کنید.

درخواست HTTP

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

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

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

پارامترها
customer

string

الزامی. شناسه مشتری مبهم‌سازی شده با پیشوند «customers/C» یا «customers/my_customer».

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

پارامترها
app

string

الزامی. نام برنامه SaaS (مثلاً ChatGPT ، Gemini ).

pageSize

integer

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

pageToken

string

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

filter

string

اختیاری. عبارت فیلتر برای محدود کردن گزارش‌های مرورگر SaaS برای بازگشت. عملگرهای پشتیبانی‌شده عبارتند از: =، !=، <، <=، >، >=، :. عملگرهای منطقی AND، OR و NOT پشتیبانی می‌شوند.

فیلدهای پشتیبانی شده:

  • دستگاه
  • پلتفرم os
  • اولین زمان ناوبری
  • آخرین زمان ناوبری
  • شناسه واحد سازمانی
orderBy

string

اختیاری. ترتیب بر اساس عبارت برای مرتب‌سازی گزارش‌های مرورگر SaaS.

فیلدهای پشتیبانی شده:

  • دستگاه
  • پلتفرم os
  • اولین زمان ناوبری
  • آخرین زمان ناوبری

ترتیب پیش‌فرض صعودی است. برای تعیین ترتیب نزولی برای یک فیلد، "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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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

فقط خروجی. نسخه سیستم عامل.