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"

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

  • ชื่อแอป
  • 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

อธิบายแอปที่ติดตั้ง

การแสดง 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) ชื่อแพ็กเกจ (เช่น com.evernote) สำหรับแอป Android
appType

enum (AppType)

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

string (int64 format)

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

string (int64 format)

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

enum (AppInstallType)

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

boolean

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

enum (AppSource)

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

string

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

string

เอาต์พุตเท่านั้น คำอธิบายแอปที่ติดตั้ง
homepageUri

string

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

string

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

object (RiskAssessmentData)

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

AppInstallType

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

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

AppSource

แหล่งที่มาของแอปที่ติดตั้ง

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

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

การแสดง 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

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 ส่วนขยายที่มีความเสี่ยงสูง