Method: customers.reports.countInstalledApps

Bericht zu App-Installationen erstellen

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customer

string

Erforderlich. Kundennummer oder „my_customer“, um den Kunden zu verwenden, der mit dem Konto verknüpft ist, über das die Anfrage erfolgt.

Abfrageparameter

Parameter
orgUnitId

string

Die ID der Organisationseinheit.
pageSize

integer

Maximale Anzahl der zurückzugebenden Ergebnisse. Höchst- und Standardwert ist 100.
pageToken

string

Token, mit dem die Seite der Anfrage angegeben wird, die zurückgegeben werden soll.
filter

string

Abfragestring zum Filtern von Ergebnissen, AND-getrennte Felder in EBNF-Syntax.

Hinweis: OR-Vorgänge werden in diesem Filter nicht unterstützt.

Unterstützte Filterfelder:

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

string

Feld, anhand dessen die Ergebnisse sortiert werden.

Unterstützte Felder für die Sortierung nach:

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

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort mit Details zu den abgefragten installierten Apps.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "installedApps": [
    {
      object (InstalledApp)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
Felder
installedApps[]

object (InstalledApp)

Liste der installierten Apps, die der Anfrage entsprechen.
nextPageToken

string

Token, mit dem die nächste Seite der Anfrage angegeben wird.
totalSize

integer

Gesamtzahl der installierten Apps, die der Anfrage entsprechen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

InstalledApp

Beschreibt eine installierte App.

JSON-Darstellung 
{
  "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)
  }
}
Felder
appId

string

Nur Ausgabe. Die eindeutige Kennung der App. Bei Chrome-Apps und ‑Erweiterungen ist das die 32-stellige ID (z.B. ehoadneljpdggcbbknedodolkkjodefl). Bei Android-Apps ist das der Paketname (z.B. com.evernote).
appType

enum (AppType)

Nur Ausgabe. Typ der App.
browserDeviceCount

string (int64 format)

Nur Ausgabe. Anzahl der Browsergeräte, auf denen diese App installiert ist.
osUserCount

string (int64 format)

Nur Ausgabe. Anzahl der ChromeOS-Nutzer, auf deren Geräten diese App installiert ist.
appInstallType

enum (AppInstallType)

Nur Ausgabe. Wie die App installiert wurde.
disabled

boolean

Nur Ausgabe. Gibt an, ob die App deaktiviert ist.
appSource

enum (AppSource)

Nur Ausgabe. Quelle der installierten App.
displayName

string

Nur Ausgabe. Name der installierten App.
description

string

Nur Ausgabe. Beschreibung der installierten App.
homepageUri

string

Nur Ausgabe. Die Startseiten-URI der installierten App.
permissions[]

string

Nur Ausgabe. Berechtigungen der installierten App.
riskAssessment

object (RiskAssessmentData)

Nur Ausgabe. Falls verfügbar, die Daten zur Risikobewertung dieser Erweiterung.

AppInstallType

Wie die App installiert wurde. Wenn nicht alle Instanzen dieser installierten App denselben Installationstyp haben, ist der Installationstyp MEHRERE.

Enums
APP_INSTALL_TYPE_UNSPECIFIED Der Installationstyp der Anwendung wurde nicht angegeben.
MULTIPLE Mehrere App-Installationstypen
NORMAL Normaler App-Installationstyp.
ADMIN Installationstyp der Administrator-App.
DEVELOPMENT Installationstyp der Entwicklungs-App.
SIDELOAD Installationstyp der App, die per Sideload installiert wurde.
OTHER Sonstige Art der App-Installation.

AppSource

Quelle der installierten App.

Enums
APP_SOURCE_UNSPECIFIED Anwendungsquelle nicht angegeben.
CHROME_WEBSTORE In der Regel für Erweiterungen und Chrome-Apps.
PLAY_STORE Play Store App

RiskAssessmentData

Daten zur Risikobewertung einer Erweiterung/App.

JSON-Darstellung 
{
  "entries": [
    {
      object (RiskAssessmentEntry)
    }
  ],
  "overallRiskLevel": enum (RiskLevel)
}
Felder
entries[]

object (RiskAssessmentEntry)

Individuelle Risikobewertungen
overallRiskLevel

enum (RiskLevel)

Das insgesamt bewertete Risikoniveau für alle Einträge. Dies ist das höchste Risikoniveau aller Einträge.

RiskAssessmentEntry

Ein Eintrag in der Risikobewertung.

JSON-Darstellung 
{
  "provider": enum (RiskAssessmentProvider),
  "riskAssessment": {
    object (RiskAssessment)
  },
  "riskLevel": enum (RiskLevel)
}
Felder
provider

enum (RiskAssessmentProvider)

Der Anbieter der Risikobewertung, von dem dieser Eintrag stammt.
riskAssessment

object (RiskAssessment)

Die Details zur Risikobewertung des Anbieters.
riskLevel

enum (RiskLevel)

Die Risikostufe für die Risikobewertung.

RiskAssessmentProvider

Anbieter von Risikobewertungen

Enums
RISK_ASSESSMENT_PROVIDER_UNSPECIFIED Standardwert, wenn kein Anbieter angegeben ist.
RISK_ASSESSMENT_PROVIDER_CRXCAVATOR CRXcavator.
RISK_ASSESSMENT_PROVIDER_SPIN_AI Spin.Ai.
RISK_ASSESSMENT_PROVIDER_LAYERX LayerX Security

RiskAssessment

Risikobewertung für eine Chrome-Erweiterung

JSON-Darstellung 
{
  "assessment": string,
  "detailsUrl": string,
  "version": string
}
Felder
assessment

string

Risikobewertung für die Erweiterung. Derzeit ist dies ein numerischer Wert, dessen Interpretation von Anbieter zu Anbieter variiert.
detailsUrl

string

Eine URL, unter der Nutzer weitere Informationen zur Risikobewertung erhalten.
version

string

Die Version der Erweiterung, auf die sich diese Bewertung bezieht.

RiskLevel

Risikostufe für eine Erweiterung/App.

Enums
RISK_LEVEL_UNSPECIFIED Risikostufe nicht angegeben.
RISK_LEVEL_LOW Erweiterung mit geringem Risiko
RISK_LEVEL_MEDIUM Erweiterung mit mittlerem Risiko
RISK_LEVEL_HIGH Erweiterung, die ein hohes Risiko darstellt