Method: customers.reports.countInstalledApps

앱 설치 보고서를 생성합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
customer

string

필수 항목입니다. 요청을 수행하는 계정과 연결된 고객을 사용하려면 고객 ID 또는 'my_customer'을 사용합니다.

쿼리 매개변수

매개변수
orgUnitId

string

조직 단위의 ID입니다.
pageSize

integer

반환할 결과의 최대 수입니다. 최댓값과 기본값은 100입니다.
pageToken

string

반환할 요청 페이지를 지정하는 토큰입니다.
filter

string

결과를 필터링하는 쿼리 문자열로, EBNF 구문에서 AND로 구분된 필드입니다.

참고: 이 필터에서는 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

설치된 앱을 설명합니다.

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자 ID (예: 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

출력 전용입니다. 설치된 앱의 권한입니다.
riskAssessment

object (RiskAssessmentData)

출력 전용입니다. 사용 가능한 경우 이 확장 프로그램에 관한 위험 평가 데이터입니다.

AppInstallType

앱이 설치된 방식입니다. 이 설치된 앱의 일부 인스턴스에 설치 유형이 동일하지 않으면 설치 유형은 MULTIPLE입니다.

열거형
APP_INSTALL_TYPE_UNSPECIFIED 애플리케이션 설치 유형이 지정되지 않았습니다.
MULTIPLE 여러 앱 설치 유형
NORMAL 일반 앱 설치 유형입니다.
ADMIN 관리자 앱 설치 유형입니다.
DEVELOPMENT 개발 앱 설치 유형입니다.
SIDELOAD 사이드로드된 앱 설치 유형입니다.
OTHER 기타 앱 설치 유형입니다.

AppSource

설치된 앱의 소스입니다.

열거형
APP_SOURCE_UNSPECIFIED 애플리케이션 소스가 지정되지 않았습니다.
CHROME_WEBSTORE 일반적으로 확장 프로그램 및 Chrome 앱에 해당합니다.
PLAY_STORE Play 스토어 앱

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

위험 평가 제공업체입니다.

열거형
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

확장 프로그램/앱의 버킷팅된 위험 수준입니다.

열거형
RISK_LEVEL_UNSPECIFIED 위험 수준이 지정되지 않았습니다.
RISK_LEVEL_LOW 위험이 낮은 확장 프로그램입니다.
RISK_LEVEL_MEDIUM 중간 위험을 나타내는 확장 프로그램입니다.
RISK_LEVEL_HIGH 위험도가 높은 확장 프로그램