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

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

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

ช่องตัวกรองที่รองรับมีดังนี้

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

string

ช่องที่ใช้เรียงลำดับผลลัพธ์

รองรับลำดับตามช่อง:

  • app_name
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • appId

เนื้อหาของคำขอ

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

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

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

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

การแสดง 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
  ]
}
ช่อง
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)

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

displayName

string

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

description

string

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

homepageUri

string

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

permissions[]

string

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

AppInstallType

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

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

AppSource

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

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