Method: customers.reports.findSaasUsageBrowsers

ค้นหารายงานการใช้งาน SaaS ของลูกค้าที่จัดกลุ่มตามเบราว์เซอร์โดยอิงตามเกณฑ์การค้นหาและการจัดเรียงที่ระบุ

คำขอ 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

ช่องที่รองรับ

  • machine
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
  • orgUnitId
orderBy

string

ไม่บังคับ นิพจน์การจัดเรียงเพื่อจัดเรียงรายงานเบราว์เซอร์ SaaS

ช่องที่รองรับ

  • machine
  • 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

แสดงผลเท่านั้น เวอร์ชันของระบบปฏิบัติการ