Method: customers.reports.findSaasUsageProfiles

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

درخواست HTTP

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

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

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

پارامترها
customer

string

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

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

پارامترها
app

string

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

pageSize

integer

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

pageToken

string

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

filter

string

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

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

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

string

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

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

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

ترتیب پیش‌فرض صعودی است. برای تعیین ترتیب نزولی برای یک فیلد، "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

گزارش پروفایل استفاده از Saas

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

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