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

위험 평가 항목 1개

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 보안

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 위험도가 높은 확장 프로그램