Method: customers.v2.Users.list

사용자 목록을 가져옵니다.

  • 요청에서 필터를 지정해야 합니다. filter 매개변수가 없는 요청은 tooMany 오류를 반환합니다.
  • filter 매개변수는 userName의 동등성만 지원합니다(예: userName eq "user@domain.com").
  • 하위 문자열 일치 (co, sw, ew), 논리 연산자 (and, or), 복잡한 값 필터는 지원되지 않습니다.
  • 페이지 매김은 지원되지 않습니다.

HTTP 요청

GET https://cloudidentityscim.googleapis.com/v1/customers/{customerId}/v2/Users

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

경로 매개변수

매개변수
customerId

string

필수 입력란입니다. Cloud ID에서 고객의 고유 식별자입니다. 고객 ID는 문자 C로 시작하는 영숫자 문자열입니다(예: C01234abc). 고객 ID를 찾으려면 고객 ID 찾기를 참고하세요.

쿼리 파라미터

매개변수
filter

string

필터 파라미터입니다. 현재는 userName의 동등성만 지원합니다.

요청 본문

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

응답 본문

사용자 나열의 응답 메시지입니다.

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

JSON 표현 
{
  "schemas": [
    string
  ],
  "resources": [
    {
      object (User)
    }
  ],
  "totalResults": integer
}
필드
schemas[]

string

반환된 리소스의 스키마입니다.
resources[]

object (User)

요청된 리소스 목록입니다.
totalResults

integer

총 결과 수입니다.

승인 범위

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

  • https://www.googleapis.com/auth/admin.directory.user.readonly
  • https://www.googleapis.com/auth/admin.directory.user

자세한 내용은 승인 가이드를 참고하세요.