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 dem Konto zugeordnet ist, von dem die Anfrage stammt.

Suchparameter

Parameter
orgUnitId

string

Die ID der Organisationseinheit.
pageSize

integer

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

string

Token zur Angabe der Seite der zurückzugebenden Anfrage.
filter

string

Abfragestring zum Filtern von Ergebnissen, durch 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 zum Sortieren der Ergebnisse.

Unterstützte Felder für „order by“:

  • 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 zur Angabe der nächsten Seite der Anfrage.
totalSize

integer

Die 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. Eindeutige Kennung der App. Bei Chrome-Apps und ‑Erweiterungen ist das die 32 Zeichen lange 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, die diese App installiert haben.
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. Homepage-URI der installierten App.
permissions[]

string

Nur Ausgabe. Berechtigungen der installierten App.
riskAssessment

object (RiskAssessmentData)

Nur Ausgabe. Falls verfügbar, die Daten zur Risikobewertung für diese Erweiterung.

AppInstallType

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

Enums
APP_INSTALL_TYPE_UNSPECIFIED Der Installationstyp der Anwendung wurde nicht angegeben.
MULTIPLE Mehrere App-Installationstypen
NORMAL Normaler App-Installationstyp.
ADMIN Vom Administrator installierter App-Typ.
DEVELOPMENT Installationstyp der Entwickler-App.
SIDELOAD Installationstyp der per Sideloading installierten App.
OTHER Anderer App-Installationstyp.

AppSource

Quelle der installierten App.

Enums
APP_SOURCE_UNSPECIFIED Die Anwendungsquelle wurde nicht angegeben.
CHROME_WEBSTORE Im Allgemeinen für Erweiterungen und Chrome-Apps.
PLAY_STORE Google 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. Das ist die höchste Risikostufe aller Einträge.

RiskAssessmentEntry

Ein Eintrag zur Risikobewertung.

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

enum (RiskAssessmentProvider)

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

object (RiskAssessment)

Nur Ausgabe. Die Details der Risikobewertung des Anbieters.
riskLevel

enum (RiskLevel)

Nur Ausgabe. Die in Kategorien eingeteilte 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
RISK_ASSESSMENT_PROVIDER_SPIN_AI_V2 Spin.AI V2.

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 für jeden Anbieter von Risikobewertungen spezifisch ist.
detailsUrl

string

Eine URL, die ein Nutzer aufrufen kann, um weitere Informationen zur Risikobewertung zu erhalten.
version

string

Die Version der Erweiterung, auf die sich diese Überprüfung bezieht.

RiskLevel

Die Risikostufe einer Erweiterung/App in Kategorien.

Enums
RISK_LEVEL_UNSPECIFIED Die Risikostufe ist nicht angegeben.
RISK_LEVEL_LOW Erweiterung, die ein geringes Risiko darstellt.
RISK_LEVEL_MEDIUM Erweiterung, die ein mittleres Risiko darstellt.
RISK_LEVEL_HIGH Erweiterung, die ein hohes Risiko darstellt.