Method: customers.profiles.list

지정된 검색 및 정렬 기준에 따라 고객의 Chrome 브라우저 프로필을 표시합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
parent

string

필수입니다. 형식: customers/{customer_id}

쿼리 매개변수

매개변수
pageSize

integer

선택사항입니다. 반환할 최대 프로필 수입니다. pageSize를 지정하지 않으면 기본 페이지 크기는 100이고 허용되는 최대 페이지 크기는 200입니다.
pageToken

string

선택사항입니다. 등록정보 요청의 특정 페이지를 검색하는 데 사용되는 페이지 토큰입니다.
filter

string

선택사항입니다. 프로필을 필터링하는 데 사용되는 필터입니다. 필터에서 사용할 수 있는 필드는 다음과 같습니다.

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

위의 필드 중 하나를 사용하여 필터를 지정할 수 있으며, AND 연산자를 사용하여 여러 필드로 필터링할 수 있습니다. 문자열 유형 필드와 enum 유형 필드는 '=' 및 '!=' 연산자를 지원합니다. 정수 유형 및 타임스탬프 유형 필드는 '=', '!=', '<', '>', '<=', '>=' 연산자를 지원합니다. 타임스탬프는 RFC-3339 형식의 문자열 (예: 2012-04-21T11:30:00-04:00)을 예상합니다. 와일드 카드 '*'는 문자열 유형 필드 필터와 함께 사용할 수 있습니다. 또한 문자열 리터럴 필터링도 지원됩니다. 예를 들어 필터로 'ABC'는 필터링 가능한 문자열 유형 필드에 'ABC'가 포함되어 있는지 확인하는 필터에 매핑됩니다.

여기에서 'ouId = ${your_org_unit_id}'를 지정하여 조직 단위 번호를 필터링 기준으로 사용할 수 있습니다. 단일 OU ID 일치만 지원됩니다.
orderBy

string

선택사항입니다. 결과의 순서를 지정하는 데 사용되는 필드입니다. 지원되는 필드는 다음과 같습니다.

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

기본적으로 정렬은 오름차순으로 이루어집니다. 필드에서 내림차순으로 지정하려면 필드 이름에 ' desc'라는 접미사를 추가해야 합니다. 기본 정렬 순서는 lastStatusReportTime의 내림차순입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

profiles.list 메서드에 대한 응답입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "chromeBrowserProfiles": [
    {
      object (ChromeBrowserProfile)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
필드
chromeBrowserProfiles[]

object (ChromeBrowserProfile)

반환된 프로필 목록입니다.
nextPageToken

string

다음 페이지를 표시하는 데 사용할 수 있는 페이지로 나누기 토큰입니다.
totalSize

string (int64 format)

총 크기는 반환된 예상 리소스 수를 나타냅니다. 프로필이 10,000개를 초과하면 정확성이 보장되지 않습니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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