Method: customers.profiles.list

Wyświetla listę profili przeglądarki Chrome klienta na podstawie podanych kryteriów wyszukiwania i sortowania.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagany. Format: customers/{customer_id}

Parametry zapytania

Parametry
pageSize

integer

Opcjonalnie: Maksymalna liczba zwracanych profili. Jeśli parametr pageSize nie jest określony, domyślny rozmiar strony to 100, a maksymalny dozwolony rozmiar strony to 200.
pageToken

string

Opcjonalnie: Token strony służący do pobierania konkretnej strony żądania informacji o produkcie.
filter

string

Opcjonalnie: Filtr używany do filtrowania profili. W filtrze możesz użyć tych pól:

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

Do określenia filtra możesz użyć dowolnego z tych pól, a filtrowanie według wielu pól jest obsługiwane za pomocą operatora I. Pola typu ciąg znaków i pola typu wyliczenie obsługują operatory „=” i „!=”. Pola typu liczba całkowita i typu sygnatura czasu obsługują operatory „=”, „!=”, „<”, „>”, „<=”, „>=” i „<>”. Sygnatury czasowe oczekują ciągu znaków w formacie RFC-3339 (np. 2012-04-21T11:30:00-04:00). Symbol wieloznaczny „*” można używać z polem filtra typu ciąg znaków. Obsługiwane jest też filtrowanie według literałów ciągu znaków, np. „ABC” jako filtr jest mapowane na filtr, który sprawdza, czy któreś z pol typu ciąg znaków do filtrowania zawiera „ABC”.

Numer jednostki organizacyjnej może być używany jako kryterium filtrowania. Aby to zrobić, wpisz „ouId = ${your_org_unit_id}”. Pamiętaj, że obsługiwane jest tylko dopasowywanie pojedynczego identyfikatora jednostki organizacyjnej.
orderBy

string

Opcjonalnie: Pola używane do określania kolejności wyników. Obsługiwane pola:

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

Domyślnie sortowanie odbywa się w kolejności rosnącej. Aby określić kolejność malejącą, do nazwy pola należy dodać sufiks „desc”. Domyślne sortowanie to malejąco według lastStatusReportTime.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na metodę profiles.list.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "chromeBrowserProfiles": [
    {
      object (ChromeBrowserProfile)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
Pola
chromeBrowserProfiles[]

object (ChromeBrowserProfile)

Lista zwróconych profili.
nextPageToken

string

Token strony, który można użyć do wyświetlenia następnej strony.
totalSize

string (int64 format)

Łączny rozmiar to szacowana liczba zwróconych zasobów. Nie ma gwarancji, że dane będą prawidłowe w przypadku ponad 10 tys. profili.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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