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: customer/{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, und 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. Im Filter können die folgenden Felder verwendet werden:

  • profileId
  • displayName
  • userEmail
  • lastActivityTime
  • lastPolicySyncTime
  • lastStatusReportTime
  • firstEnrollmentTime
  • osPlatformType
  • osVersion
  • browserVersion
  • browserChannel
  • policyCount
  • extensionCount
  • identityProvider
  • affiliationState
  • 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. Beispiel: „ABC“ als Filter wird einem Filter zugeordnet, der prü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 Reihenfolge der Ergebnisse festgelegt wird. Folgende Felder werden unterstützt:

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

Standardmäßig erfolgt die Sortierung in aufsteigender Reihenfolge. Um ein Feld absteigend zu sortieren, muss dem Feldnamen das Suffix „ desc“ hinzugefügt werden. 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 nicht garantiert werden, dass sie korrekt sind.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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