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, von dem die Anfrage gesendet wird.

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 zur Angabe der nächsten Seite der Anfrage.
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. Eindeutige ID der App. Bei Chrome-Apps und -Erweiterungen die ID aus 32 Zeichen (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 Anwendung 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 per Sideload übertragenen App.
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 der Risikobewertung des Anbieters.
riskLevel

enum (RiskLevel)

Das gruppierte Risikoniveau 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.

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, zu der Nutzer gelangen, um weitere Informationen zur Risikobewertung zu 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, die ein geringes Risiko darstellt.
RISK_LEVEL_MEDIUM Erweiterung, die ein mittleres Risiko darstellt
RISK_LEVEL_HIGH Erweiterung, die ein hohes Risiko darstellt