관리 콘솔 애플리케이션 또는 Google Drive 애플리케이션과 같은 특정 고객 계정 및 애플리케이션의 활동 목록을 검색합니다. 자세한 내용은 관리자 및 Google Drive 활동 보고서 가이드를 참고하세요. 활동 보고서의 매개변수에 관한 자세한 내용은 활동 매개변수 참조 가이드를 참고하세요.
HTTP 요청
GET https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
userKey or all |
데이터를 필터링할 프로필 ID 또는 사용자 이메일을 나타냅니다. 모든 정보의 경우 |
applicationName |
이벤트를 가져올 애플리케이션 이름입니다. |
쿼리 매개변수
매개변수 | |
---|---|
actorIpAddress |
이벤트가 수행된 호스트의 인터넷 프로토콜 (IP) 주소입니다. 이는 보고되는 활동이 있는 사용자의 IP 주소를 사용하여 보고서 요약을 필터링하는 추가적인 방법입니다. 이 IP 주소는 사용자의 실제 위치를 반영하거나 반영하지 않을 수 있습니다. 예를 들어 IP 주소가 사용자의 프록시 서버 주소 또는 가상 사설망 (VPN) 주소일 수 있습니다. 이 매개변수는 IPv4와 IPv6 주소 버전을 모두 지원합니다. |
customerId |
데이터를 검색할 고객의 고유 ID입니다. |
endTime |
보고서에 표시되는 기간의 종료 시간을 설정합니다. 날짜는 RFC 3339 형식(예: 2010-10-28T10:26:35.000Z)입니다. 기본값은 API 요청의 대략적인 시간입니다. API 보고서에는 세 가지 기본 시간 개념이 있습니다.
endTime 이 지정되지 않은 경우 보고서는 startTime 에서 현재 시간 또는 startTime 이 지난 180일 이상 지난 경우 가장 최근 180일까지의 모든 활동을 반환합니다.
|
eventName |
API에서 쿼리하는 이벤트의 이름입니다. 각 |
filters |
이러한 이벤트 매개변수는 특정 다음 Drive 활동 예에서 반환된 목록은
참고: API는 동일한 매개변수의 여러 값을 허용하지 않습니다. API 요청에서 매개변수가 두 번 이상 제공되면 API는 해당 매개변수의 마지막 값만 허용합니다. 또한 API 요청에 잘못된 매개변수가 제공되면 API는 해당 매개변수를 무시하고 나머지 유효한 매개변수에 해당하는 응답을 반환합니다. 요청된 매개변수가 없으면 모든 매개변수가 반환됩니다. |
maxResults |
각 응답 페이지에 표시되는 활동 기록 수를 결정합니다. 예를 들어 요청이 |
orgUnitID |
보고할 조직 단위의 ID입니다. 지정된 조직 단위에 속한 사용자의 활동 기록만 표시됩니다. |
pageToken |
다음 페이지를 지정하는 토큰입니다. 여러 페이지가 있는 보고서는 응답에 |
startTime |
보고서에 표시되는 기간의 시작을 설정합니다. 날짜는 RFC 3339 형식(예: 2010-10-28T10:26:35.000Z)입니다. 보고서는 |
groupIdFilter |
사용자 활동이 필터링되는 쉼표로 구분된 그룹 ID (난독화)입니다. 즉, 응답에는 여기에 언급된 그룹 ID 중 하나 이상에 속하는 사용자의 활동만 포함됩니다. 형식: 'id:abc123,id:xyz456' |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
활동 모음의 JSON 템플릿
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"kind": string,
"etag": string,
"items": [
{
object ( |
입력란 | |
---|---|
kind |
API 리소스의 유형입니다. 활동 보고서의 경우 값은 |
etag |
리소스의 ETag입니다. |
items[] |
응답의 각 활동 기록 |
nextPageToken |
보고서의 후속 다음 페이지를 가져오는 토큰입니다. |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/admin.reports.audit.readonly
자세한 내용은 승인 가이드를 참조하세요.
ApplicationName
열거형 | |
---|---|
access_transparency |
Google Workspace 액세스 투명성 활동 보고서에는 다양한 유형의 액세스 투명성 활동 이벤트에 대한 정보가 반환됩니다. |
admin |
관리 콘솔 애플리케이션의 활동 보고서는 여러 유형의 관리자 활동 이벤트에 대한 계정 정보를 반환합니다. |
calendar |
Google Calendar 애플리케이션의 활동 보고서는 다양한 캘린더 활동 이벤트에 대한 정보를 반환합니다. |
chat |
Chat 활동 보고서에는 다양한 Chat 활동 이벤트에 대한 정보가 반환됩니다. |
drive |
Google Drive 애플리케이션의 활동 보고서는 다양한 Google Drive 활동 이벤트에 대한 정보를 반환합니다. Drive 활동 보고서는 Google Workspace Business 및 Enterprise 고객에게만 제공됩니다. |
gcp |
Google Cloud Platform 애플리케이션의 활동 보고서는 다양한 GCP 활동 이벤트에 대한 정보를 반환합니다. |
gplus |
Google+ 애플리케이션의 활동 보고서에는 다양한 Google+ 활동 이벤트에 대한 정보가 표시됩니다. |
groups |
Google 그룹스 애플리케이션의 활동 보고서는 다양한 그룹스 활동 이벤트에 대한 정보를 반환합니다. |
groups_enterprise |
Enterprise 그룹스 활동 보고서에는 다양한 엔터프라이즈 그룹 활동 이벤트에 관한 정보가 표시됩니다. |
jamboard |
Jamboard 활동 보고서에는 다양한 Jamboard 활동 이벤트에 관한 정보가 표시됩니다. |
login |
로그인 애플리케이션의 활동 보고서는 여러 유형의 로그인 활동 이벤트에 대한 계정 정보를 반환합니다. |
meet |
Meet 감사 활동 보고서에는 Meet 감사 활동 이벤트의 여러 유형에 관한 정보가 반환됩니다. |
mobile |
기기 감사 활동 보고서는 여러 유형의 기기 감사 활동 이벤트에 관한 정보를 반환합니다. |
rules |
규칙 활동 보고서는 다양한 유형의 규칙 활동 이벤트에 대한 정보를 반환합니다. |
saml |
SAML 활동 보고서는 다양한 유형의 SAML 활동 이벤트에 대한 정보를 반환합니다. |
token |
토큰 애플리케이션의 활동 보고서는 여러 유형의 토큰 활동 이벤트에 대한 계정 정보를 반환합니다. |
user_accounts |
사용자 계정 애플리케이션의 활동 보고서는 여러 유형의 사용자 계정 활동 이벤트에 대한 계정 정보를 반환합니다. |
context_aware_access |
컨텍스트 인식 액세스 활동 보고서는 컨텍스트 인식 액세스 규칙으로 인해 사용자의 액세스가 거부된 이벤트에 관한 정보를 반환합니다. |
chrome |
Chrome 활동 보고서에는 Chrome 브라우저 및 Chrome OS 이벤트에 관한 정보가 반환됩니다. |
data_studio |
데이터 스튜디오 활동 보고서는 다양한 유형의 데이터 스튜디오 활동 이벤트에 대한 정보를 반환합니다. |
keep |
Keep 애플리케이션의 활동 보고서에는 다양한 Google Keep 활동 이벤트에 관한 정보가 반환됩니다. Keep 활동 보고서는 Google Workspace Business 및 Enterprise 고객에게만 제공됩니다. |
vault |
Vault 활동 보고서에는 다양한 유형의 Vault 활동 이벤트에 대한 정보가 표시됩니다. |
활동
활동 리소스의 JSON 템플릿
JSON 표현 |
---|
{ "kind": string, "etag": string, "ownerDomain": string, "ipAddress": string, "events": [ { "type": string, "name": string, "parameters": [ { "messageValue": { "parameter": [ { object ( |
입력란 | |
---|---|
kind |
API 리소스의 유형입니다. 활동 보고서의 경우 값은 |
etag |
항목의 ETag입니다. |
ownerDomain |
보고서 이벤트의 영향을 받는 도메인입니다. 예: 관리 콘솔 도메인 또는 Drive 애플리케이션의 문서 소유자 |
ipAddress |
작업을 수행하는 사용자의 IP 주소입니다. Google Workspace에 로그인할 때 사용자의 인터넷 프로토콜 (IP) 주소로, 사용자의 실제 위치가 아닐 수도 있습니다. 예를 들어 IP 주소가 사용자의 프록시 서버 주소 또는 가상 사설망 (VPN) 주소일 수 있습니다. API는 IPv4와 IPv6를 지원합니다. |
events[] |
보고서의 활동 이벤트입니다. |
events[].type |
이벤트 유형입니다. 관리자가 변경하는 Google Workspace 서비스 또는 기능은 |
events[].name |
이벤트 이름입니다. API가 보고하는 활동의 구체적인 이름입니다. 또한 각
eventName 속성에 관한 자세한 내용은 위 applicationName 에서 다양한 애플리케이션의 이벤트 이름 목록을 참고하세요.
|
events[].parameters[] |
다양한 애플리케이션에 대한 매개변수 값 쌍입니다. |
events[].parameters[].messageValue |
이 매개변수와 연결된 중첩 매개변수 값 쌍입니다. 매개변수의 복합 값 유형은 매개변수 값 목록으로 반환됩니다. 예를 들어 주소 매개변수의 값이 |
events[].parameters[].messageValue.parameter[] |
매개변수 값 |
events[].parameters[].name |
매개변수의 이름입니다. |
events[].parameters[].value |
매개변수의 문자열 값입니다. |
events[].parameters[].multiValue[] |
매개변수의 문자열 값입니다. |
events[].parameters[].intValue |
매개변수의 정수 값입니다. |
events[].parameters[].multiIntValue[] |
매개변수의 정수 값입니다. |
events[].parameters[].boolValue |
매개변수의 부울 값입니다. |
events[].parameters[].multiMessageValue[] |
|
events[].parameters[].multiMessageValue[].parameter[] |
매개변수 값 |
id |
각 활동 기록의 고유 식별자입니다. |
id.time |
활동이 발생한 시간입니다. UNIX 에포크 시간(초 단위)입니다. |
id.uniqueQualifier |
여러 이벤트가 동시에 진행되는 경우 고유한 한정자입니다. |
id.applicationName |
이벤트가 속한 애플리케이션 이름입니다. 가능한 값은 위 |
id.customerId |
Google Workspace 계정의 고유 식별자입니다. |
actor |
액션을 수행하는 사용자입니다. |
actor.profileId |
작업 수행자의 고유한 Google Workspace 프로필 ID입니다. 작업 수행자가 Google Workspace 사용자가 아닌 경우 값이 누락되거나 자리표시자 ID 역할을 하는 숫자 105250506097979753968일 수 있습니다. |
actor.email |
작업 수행자의 기본 이메일 주소입니다. 작업 수행자와 연결된 이메일 주소가 없는 경우 없을 수 있습니다. |
actor.callerType |
배우 유형입니다. |
actor.key |
|