Method: customers.profiles.list

Liste les profils du navigateur Chrome d'un client en fonction des critères de recherche et de tri indiqués.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Format: customers/{customer_id}

Paramètres de requête

Paramètres
pageSize

integer

Facultatif. Nombre maximal de profils à renvoyer. La taille de page par défaut est de 100 si la valeur pageSize n'est pas spécifiée, et la taille de page maximale autorisée est de 200.

pageToken

string

Facultatif. Jeton de page utilisé pour récupérer une page spécifique de la demande de fiche.

filter

string

Facultatif. Filtre utilisé pour filtrer les profils. Les champs suivants peuvent être utilisés dans le filtre:

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

Vous pouvez utiliser n'importe lequel des champs ci-dessus pour spécifier un filtre. Le filtrage par plusieurs champs est compatible avec l'opérateur AND. Les champs de type chaîne et les champs de type énumération acceptent les opérateurs "=" et "!=". Les champs de type entier et de type code temporel acceptent les opérateurs "=", "!=", "<", ">", "<=" et ">=". Les codes temporels requièrent une chaîne au format RFC 3339 (par exemple, 2012-04-21T11:30:00-04:00). Le caractère générique * peut être utilisé avec un filtre de champ de type chaîne. En outre, le filtrage par littéral de chaîne est également accepté. Par exemple, le filtre "ABC" est mappé à un filtre qui vérifie si l'un des champs de type de chaîne filtrable contient "ABC".

Vous pouvez utiliser le numéro d'unité organisationnelle comme critère de filtrage en spécifiant "ouId = ${your_org_unit_id}". Notez que seule la correspondance avec un seul ID d'unité organisationnelle est prise en charge.

orderBy

string

Facultatif. Champs utilisés pour spécifier l'ordre des résultats. Les champs pris en charge sont les suivants:

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

Par défaut, le tri est effectué par ordre croissant. Pour spécifier un ordre décroissant pour un champ, vous devez ajouter le suffixe "desc" au nom du champ. Par défaut, l'ordre est décroissant en fonction de lastStatusReportTime.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Réponse à la méthode profiles.list.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "chromeBrowserProfiles": [
    {
      object (ChromeBrowserProfile)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
Champs
chromeBrowserProfiles[]

object (ChromeBrowserProfile)

Liste des profils affichée.

nextPageToken

string

Jeton de pagination pouvant être utilisé pour répertorier la page suivante.

totalSize

string (int64 format)

La taille totale représente un nombre estimé de ressources renvoyées. L'exactitude des résultats n'est pas garantie au-delà de 10 000 fiches.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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