Method: customers.reports.findSaasUsageProfiles

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

คำขอ HTTP

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

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

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

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

string

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

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

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

string

ต้องระบุ ชื่อแอปพลิเคชัน SaaS (เช่น ChatGPT, Gemini)
pageSize

integer

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

string

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

string

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

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

  • อีเมล
  • orgUnitId
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
orderBy

string

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

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

  • อีเมล
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime

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

SaasUsageProfileReport

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

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