Method: users.watch

사용자 목록의 변경사항을 감시합니다.

HTTP 요청

POST https://admin.googleapis.com/admin/directory/v1/users/watch

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

쿼리 매개변수

매개변수
domain

string

도메인 이름입니다. 이 도메인의 사용자만 가져오려면 이 필드를 작성하세요. 다중 도메인에서 모든 사용자를 반환하려면 대신 고객 필드를 채우세요.'
customer

string

Google Workspace 계정의 변경할 수 없는 ID입니다. 다중 도메인의 경우 고객의 모든 사용자를 가져오려면 도메인 대신 이 필드를 입력하세요.
event

enum (EventType)

관찰할 이벤트입니다.
customFieldMask

string

쉼표로 구분된 스키마 이름 목록입니다. 이러한 스키마의 모든 필드가 가져옵니다. 이 값은 projection=custom인 경우에만 설정해야 합니다.
maxResults

integer

반환할 결과의 최대 수입니다.
orderBy

enum (OrderBy)

결과를 정렬하는 데 사용할 열
pageToken

string

목록에서 다음 페이지를 지정하는 토큰
projection

enum (Projection)

이 사용자에 대해 가져올 필드의 하위 집합입니다.
query

string

쿼리 문자열 검색 각각 필드, 연산자, 값을 포함하는 하나 이상의 검색 절을 포함합니다. 전체 문서는 사용자 검색을 참고하세요.
showDeleted

string

true로 설정하면 삭제된 사용자 목록을 가져옵니다. (기본값: false)
sortOrder

enum (SortOrder)

결과를 오름차순 또는 내림차순으로 반환할지 여부입니다.
viewType

enum (ViewType)

관리자 전용 또는 도메인 전체 공개 사용자 뷰를 가져올지 여부입니다. 자세한 내용은 관리자가 아닌 사용자로 사용자 가져오기를 참고하세요.

요청 본문

요청 본문에 SubscriptionChannel의 인스턴스가 포함됩니다.

응답 본문

성공한 경우 응답 본문에 SubscriptionChannel의 인스턴스가 포함됩니다.

승인 범위

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

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

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

EventType

정기 결제 이벤트 유형

열거형
ADD 사용자 생성 이벤트
DELETE 사용자 삭제됨 이벤트
MAKE_ADMIN 사용자 관리자 상태 변경 이벤트
UNDELETE 사용자 삭제 취소됨 이벤트
UPDATE 사용자 업데이트됨 이벤트

OrderBy

열거형
EMAIL 사용자의 기본 이메일입니다.
FAMILY_NAME 사용자의 성입니다.
GIVEN_NAME 사용자의 이름입니다.

투영

열거형
BASIC 사용자의 맞춤 필드를 포함하지 않습니다.
CUSTOM customFieldMask에 언급된 스키마의 맞춤 필드를 포함합니다.
FULL 이 사용자와 연결된 모든 필드를 포함합니다.

SortOrder

열거형
ASCENDING 오름차순
DESCENDING 내림차순

ViewType

열거형
admin_view 결과에는 관리자 전용 필드와 도메인 공개 필드가 모두 포함됩니다.
domain_public 결과에는 도메인의 다른 사용자에게 공개적으로 표시되는 사용자의 필드만 포함됩니다.