Method: customers.profiles.list

Listet Chrome-Browserprofile eines Kunden anhand der angegebenen Such- und Sortierkriterien auf.

HTTP-Anfrage

GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/profiles

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Format: customers/{customer_id}

Abfrageparameter

Parameter
pageSize

integer

Optional. Die maximale Anzahl der Profile, die zurückgegeben werden sollen. Die Standardseitengröße ist 100, wenn „pageSize“ nicht angegeben ist. Die maximal zulässige Seitengröße beträgt 200.
pageToken

string

Optional. Das Seitentoken, mit dem eine bestimmte Seite der Listenanfrage abgerufen wird.
filter

string

Optional. Der Filter, mit dem Profile gefiltert werden. Die folgenden Felder können im Filter verwendet werden:

  • profileId
  • displayName
  • userEmail
  • lastActivityTime
  • lastPolicySyncTime
  • lastStatusReportTime
  • firstEnrollmentTime
  • osPlatformType
  • osVersion
  • browserVersion
  • browserChannel
  • policyCount
  • extensionCount
  • identityProvider
  • affiliationState
  • osPlatformVersion
  • ouId

Mit jedem der oben genannten Felder kann ein Filter angegeben werden. Mit dem AND-Operator wird die Filterung nach mehreren Feldern unterstützt. Felder vom Typ „String“ und „Enum“ unterstützen die Operatoren „=“ und „!=“. Die Felder vom Typ „Ganzzahl“ und „Zeitstempel“ unterstützen die Operatoren „=“, „!=“, „<“, „>“, „<=“ und „>=“. Zeitstempel müssen im RFC-3339-Format vorliegen (z.B. 2012-04-21T11:30:00-04:00). Der Platzhalter „*“ kann mit einem Feldfilter vom Typ „String“ verwendet werden. Außerdem wird das Filtern von Stringliteralen unterstützt. Wenn Sie beispielsweise „ABC“ als Filter angeben, wird geprüft, ob eines der filterbaren Felder vom Typ „String“ „ABC“ enthält.

Die Organisationseinheitsnummer kann hier als Filterkriterium verwendet werden. Geben Sie dazu „ouId = ${your_org_unit_id}“ an. Hinweis: Es wird nur die Übereinstimmung mit einer einzelnen OU-ID unterstützt.
orderBy

string

Optional. Die Felder, mit denen die Sortierung der Ergebnisse festgelegt wird. Folgende Felder werden unterstützt:

  • profileId
  • displayName
  • userEmail
  • lastActivityTime
  • lastPolicySyncTime
  • lastStatusReportTime
  • firstEnrollmentTime
  • osPlatformType
  • osVersion
  • browserVersion
  • browserChannel
  • policyCount
  • extensionCount
  • identityProvider
  • affiliationState
  • osPlatformVersion

Standardmäßig erfolgt die Sortierung in aufsteigender Reihenfolge. Wenn Sie ein Feld absteigend sortieren möchten, fügen Sie dem Feldnamen das Suffix „desc“ hinzu. Die Standardsortierung ist die absteigende Reihenfolge von „lastStatusReportTime“.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort auf die Methode „profiles.list“.

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

JSON-Darstellung 
{
  "chromeBrowserProfiles": [
    {
      object (ChromeBrowserProfile)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
Felder
chromeBrowserProfiles[]

object (ChromeBrowserProfile)

Die zurückgegebene Liste der Profile.
nextPageToken

string

Das Paginierungstoken, mit dem die nächste Seite aufgelistet werden kann.
totalSize

string (int64 format)

Die Gesamtgröße entspricht einer geschätzten Anzahl der zurückgegebenen Ressourcen. Bei mehr als 10.000 Profilen kann keine Richtigkeit garantiert werden.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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