Method: customers.reports.findSaasUsage

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

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
customer

string

ต้องระบุ รหัสลูกค้าที่ปกปิดไว้ซึ่งมีคำนำหน้าเป็น "customers/C" หรือ "customers/my_customer"

พารามิเตอร์การค้นหา

พารามิเตอร์
pageSize

integer

ไม่บังคับ จำนวนรายงานสูงสุดที่จะแสดง บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ได้ระบุ ระบบจะแสดงรายงานไม่เกิน 100 รายการ ค่าสูงสุดคือ 200 และระบบจะบังคับให้ค่าที่สูงกว่า 200 เป็น 200
pageToken

string

ไม่บังคับ โทเค็นหน้าเว็บที่ได้รับจากการเรียก FindSaasUsageReports ครั้งก่อน ระบุโทเค็นนี้เพื่อดึงข้อมูลหน้าถัดไป

เมื่อแบ่งหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้กับ FindSaasUsageReports ต้องตรงกับการเรียกที่ให้โทเค็นหน้าเว็บ
filter

string

ไม่บังคับ นิพจน์ตัวกรองเพื่อจำกัดรายงาน SaaS ที่จะแสดง โอเปอเรเตอร์ที่รองรับ ได้แก่ =, !=, <, <=, >, >=, : และระบบรองรับโอเปอเรเตอร์ตรรกะ AND, OR และ NOT

ฟิลด์ที่รองรับ

  • แอป
  • orgUnitId
  • firstNavigationTime
  • lastNavigationTime
  • category
  • organization
  • foundedYear
  • headquarters
  • primaryDomain
  • domains
  • encryptionProtocols
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

ตัวอย่าง: (firstNavigationTime < "2026-01-31T00:00:00Z" AND lastNavigationTime > "2026-01-01T00:00:00Z") AND visitsCount > 100
orderBy

string

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

ฟิลด์ที่รองรับ

  • แอป
  • category
  • organization
  • foundedYear
  • headquarters
  • primaryDomain
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

ลำดับเริ่มต้นคือจากน้อยไปมาก หากต้องการระบุลำดับจากมากไปน้อยสำหรับฟิลด์ ให้ต่อท้ายด้วย " 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

SaasUsageReport

แสดงรายการรายงาน 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 เสมอ และใช้ตัวเลขเศษส่วน 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"

ContentTransferDetails

ให้ข้อมูลเกี่ยวกับเหตุการณ์การโอนเนื้อหา หากมี

การแสดง JSON 
{
  "contentTransferCount": string
}
ช่อง
contentTransferCount

string (int64 format)

เอาต์พุตเท่านั้น จำนวนการโอนเนื้อหาทั้งหมดที่เชื่อมโยงกับแอปพลิเคชัน