Method: customers.reports.findSaasUsage

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

درخواست HTTP

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

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

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

پارامترها
customer

string

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

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

پارامترها
pageSize

integer

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

pageToken

string

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

هنگام صفحه‌بندی، تمام پارامترهای دیگر ارائه شده به FindSaasUsageReports باید با فراخوانی که توکن صفحه را ارائه داده است، مطابقت داشته باشند.

filter

string

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

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

  • برنامه
  • شناسه واحد سازمانی
  • اولین زمان ناوبری
  • آخرین زمان ناوبری
  • دسته
  • سازمان
  • سال تأسیس
  • دفتر مرکزی
  • دامنه اصلی
  • دامنه‌ها
  • پروتکل‌های رمزگذاری
  • تعداد بازدیدها
  • تعداد کاربران متمایز
  • تعداد مرورگرهای متمایز
  • تعداد انتقال محتوا

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

orderBy

string

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

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

  • برنامه
  • دسته
  • سازمان
  • سال تأسیس
  • دفتر مرکزی
  • دامنه اصلی
  • تعداد بازدیدها
  • تعداد کاربران متمایز
  • تعداد مرورگرهای متمایز
  • تعداد انتقال محتوا

ترتیب پیش‌فرض صعودی است. برای تعیین ترتیب نزولی برای یک فیلد، "desc" را اضافه کنید.

مثال: visitsCount desc

درخواست بدنه

بدنه درخواست باید خالی باشد.

بدنه پاسخ

پاسخ به متد reports.findSaasUsage .

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "saasReports": [
    {
      object (SaasUsageReport)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
فیلدها
saasReports[]

object ( SaasUsageReport )

فهرست گزارش‌های استفاده از SaaS.

nextPageToken

string

یک توکن، که می‌تواند به عنوان pageToken برای بازیابی صفحه بعدی ارسال شود. اگر این فیلد حذف شود، صفحات بعدی وجود نخواهند داشت.

totalSize

string ( int64 format)

تعداد کل گزارش‌های استفاده از SaaS که با درخواست مطابقت دارند.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

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

گزارش استفاده از Saas

نشان دهنده یک ورودی گزارش 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-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" .

جزئیات انتقال محتوا

در صورت وجود، اطلاعاتی در مورد رویدادهای انتقال محتوا ارائه می‌دهد.

نمایش JSON 
{
  "contentTransferCount": string
}
فیلدها
contentTransferCount

string ( int64 format)

فقط خروجی. تعداد کل انتقال‌های محتوا مرتبط با برنامه.