Method: customers.reports.countInstalledApps

สร้างรายงานการติดตั้งแอป

คำขอ HTTP

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

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

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

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

string

ต้องระบุ รหัสลูกค้าหรือ "my_customer" เพื่อใช้ลูกค้าที่เชื่อมโยงกับบัญชีที่ส่งคำขอ

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

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

string

รหัสของหน่วยขององค์กร
pageSize

integer

จำนวนผลลัพธ์สูงสุดที่จะแสดง ค่าสูงสุดและค่าเริ่มต้นคือ 100
pageToken

string

โทเค็นเพื่อระบุหน้าของคำขอที่จะแสดงผล
filter

string

สตริงการค้นหาเพื่อกรองผลลัพธ์ ฟิลด์ที่คั่นด้วย AND ในไวยากรณ์ EBNF

หมายเหตุ: ตัวกรองนี้ไม่รองรับการดำเนินการ OR

ช่องตัวกรองที่รองรับ

  • app_name
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • latest_profile_active_date
  • permission_name
  • appId
  • manifest_versions
  • risk_score
orderBy

string

ฟิลด์ที่ใช้จัดลำดับผลลัพธ์

ฟิลด์ที่รองรับสำหรับการเรียงลำดับ

  • app_name
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • appId
  • manifest_versions
  • risk_score

เนื้อความของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

การตอบกลับที่มีรายละเอียดของแอปที่ติดตั้งที่ค้นหา

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "installedApps": [
    {
      object (InstalledApp)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
ช่อง
installedApps[]

object (InstalledApp)

รายการแอปที่ติดตั้งซึ่งตรงกับคำขอ
nextPageToken

string

โทเค็นเพื่อระบุหน้าถัดไปของคำขอ
totalSize

integer

จำนวนแอปที่ติดตั้งทั้งหมดซึ่งตรงกับคำขอ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

InstalledApp

อธิบาย Installed App

การแสดง JSON 
{
  "appId": string,
  "appType": enum (AppType),
  "browserDeviceCount": string,
  "osUserCount": string,
  "appInstallType": enum (AppInstallType),
  "disabled": boolean,
  "appSource": enum (AppSource),
  "displayName": string,
  "description": string,
  "homepageUri": string,
  "permissions": [
    string
  ],
  "riskAssessment": {
    object (RiskAssessmentData)
  }
}
ช่อง
appId

string

เอาต์พุตเท่านั้น ตัวระบุที่ไม่ซ้ำกันของแอป สำหรับแอปและส่วนขยาย Chrome รหัส 32 อักขระ (เช่น ehoadneljpdggcbbknedodolkkjodefl) สำหรับแอป Android ให้ใช้ชื่อแพ็กเกจ (เช่น com.evernote)
appType

enum (AppType)

เอาต์พุตเท่านั้น ประเภทของแอป
browserDeviceCount

string (int64 format)

เอาต์พุตเท่านั้น จำนวนอุปกรณ์เบราว์เซอร์ที่ติดตั้งแอปนี้
osUserCount

string (int64 format)

เอาต์พุตเท่านั้น จำนวนผู้ใช้ ChromeOS ที่ติดตั้งแอปนี้
appInstallType

enum (AppInstallType)

เอาต์พุตเท่านั้น วิธีการติดตั้งแอป
disabled

boolean

เอาต์พุตเท่านั้น แอปถูกปิดใช้หรือไม่
appSource

enum (AppSource)

เอาต์พุตเท่านั้น แหล่งที่มาของ Installed App
displayName

string

เอาต์พุตเท่านั้น ชื่อของแอปที่ติดตั้ง
description

string

เอาต์พุตเท่านั้น คำอธิบายของ Installed App
homepageUri

string

เอาต์พุตเท่านั้น URI หน้าแรกของแอปที่ติดตั้ง
permissions[]

string

เอาต์พุตเท่านั้น สิทธิ์ของแอปที่ติดตั้ง
riskAssessment

object (RiskAssessmentData)

เอาต์พุตเท่านั้น หากมี ข้อมูลการประเมินความเสี่ยงเกี่ยวกับส่วนขยายนี้

AppInstallType

วิธีการติดตั้งแอป หากอินสแตนซ์ทั้งหมดของ Installed App นี้ไม่ได้มีประเภทการติดตั้งเดียวกัน ประเภทการติดตั้งจะเป็น MULTIPLE

Enum
APP_INSTALL_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทการติดตั้งแอปพลิเคชัน
MULTIPLE ประเภทการติดตั้งแอปหลายประเภท
NORMAL ประเภทการติดตั้งแอปปกติ
ADMIN ประเภทการติดตั้งแอปของผู้ดูแลระบบ
DEVELOPMENT ประเภทการติดตั้งแอปเพื่อการพัฒนา
SIDELOAD ประเภทการติดตั้งแอปที่โหลดจากภายนอก
OTHER ประเภทการติดตั้งแอปอื่นๆ

AppSource

แหล่งที่มาของ Installed App

Enum
APP_SOURCE_UNSPECIFIED ไม่ได้ระบุแหล่งที่มาของแอปพลิเคชัน
CHROME_WEBSTORE โดยทั่วไปสำหรับส่วนขยายและแอป Chrome
PLAY_STORE แอป Play Store

RiskAssessmentData

ข้อมูลการประเมินความเสี่ยงเกี่ยวกับส่วนขยาย/แอป

การแสดง JSON 
{
  "entries": [
    {
      object (RiskAssessmentEntry)
    }
  ],
  "overallRiskLevel": enum (RiskLevel)
}
ช่อง
entries[]

object (RiskAssessmentEntry)

การประเมินความเสี่ยงแต่ละรายการ
overallRiskLevel

enum (RiskLevel)

ระดับความเสี่ยงโดยรวมที่ประเมินแล้วในรายการทั้งหมด ซึ่งจะเป็นระดับความเสี่ยงสูงสุดจากรายการทั้งหมด

RiskAssessmentEntry

รายการประเมินความเสี่ยง 1 รายการ

การแสดง JSON 
{
  "provider": enum (RiskAssessmentProvider),
  "riskAssessment": {
    object (RiskAssessment)
  },
  "riskLevel": enum (RiskLevel)
}
ช่อง
provider

enum (RiskAssessmentProvider)

เอาต์พุตเท่านั้น ผู้ให้บริการประเมินความเสี่ยงที่รายการนี้มาจาก
riskAssessment

object (RiskAssessment)

เอาต์พุตเท่านั้น รายละเอียดการประเมินความเสี่ยงของผู้ให้บริการ
riskLevel

enum (RiskLevel)

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

RiskAssessmentProvider

ผู้ให้บริการประเมินความเสี่ยง

Enum
RISK_ASSESSMENT_PROVIDER_UNSPECIFIED ค่าเริ่มต้นเมื่อไม่ได้ระบุผู้ให้บริการ
RISK_ASSESSMENT_PROVIDER_CRXCAVATOR CRXcavator
RISK_ASSESSMENT_PROVIDER_SPIN_AI Spin.Ai
RISK_ASSESSMENT_PROVIDER_LAYERX LayerX Security
RISK_ASSESSMENT_PROVIDER_SPIN_AI_V2 Spin.AI V2

RiskAssessment

การประเมินความเสี่ยงสำหรับส่วนขยาย Chrome

การแสดง JSON 
{
  "assessment": string,
  "detailsUrl": string,
  "version": string
}
ช่อง
assessment

string

การประเมินความเสี่ยงสำหรับส่วนขยาย ปัจจุบันค่านี้เป็นค่าตัวเลข และการตีความจะขึ้นอยู่กับผู้ให้บริการประเมินความเสี่ยงแต่ละราย
detailsUrl

string

URL ที่ผู้ใช้ไปยังได้เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับการประเมินความเสี่ยง
version

string

เวอร์ชันของส่วนขยายที่การประเมินนี้มีผล

RiskLevel

ระดับความเสี่ยงที่จัดกลุ่มสำหรับส่วนขยาย/แอป

Enum
RISK_LEVEL_UNSPECIFIED ไม่ได้ระบุระดับความเสี่ยง
RISK_LEVEL_LOW ส่วนขยายที่แสดงถึงความเสี่ยงต่ำ
RISK_LEVEL_MEDIUM ส่วนขยายที่แสดงถึงความเสี่ยงปานกลาง
RISK_LEVEL_HIGH ส่วนขยายที่มีความเสี่ยงสูง