- HTTP 요청
- 경로 매개변수
- 쿼리 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- ApplicationName
- 활동
- ResourceDetails
- AppliedLabel
- FieldValue
- TextListValue
- SelectionValue
- SelectionListValue
- UserValue
- UserListValue
- 날짜
- 이유
- 사용해 보기
관리 콘솔 애플리케이션 또는 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 애플리케이션의 활동 보고서는 다양한 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 |
엔터프라이즈 그룹 활동 보고서는 다양한 엔터프라이즈 그룹 활동 이벤트에 관한 정보를 반환합니다. |
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 활동 이벤트에 관한 정보를 반환합니다. |
gemini_for_workspace |
Workspace용 Gemini 앱의 활동 보고서는 다양한 유형의 Gemini 활동 이벤트에 관한 정보를 반환합니다. |
활동
활동 리소스의 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[] |
매개변수 값 |
events[].resourceIds[] |
이벤트와 연결된 리소스 ID입니다. |
id |
각 활동 레코드의 고유 식별자입니다. |
id.time |
활동이 발생한 시간입니다. UNIX epoch 시간(초)입니다. |
id.uniqueQualifier |
여러 이벤트의 시간이 동일한 경우 고유한 한정자입니다. |
id.applicationName |
이벤트가 속한 애플리케이션 이름입니다. 가능한 값은 위의 |
id.customerId |
Google Workspace 계정의 고유 식별자입니다. |
actor |
작업을 실행하는 사용자입니다. |
actor.profileId |
행위자의 고유한 Google Workspace 프로필 ID입니다. 행위자가 Google Workspace 사용자가 아닌 경우 이 값이 없을 수 있으며, 자리표시자 ID 역할을 하는 105250506097979753968일 수도 있습니다. |
actor.email |
행위자의 기본 이메일 주소입니다. 행위자와 연결된 이메일 주소가 없는 경우 표시되지 않을 수 있습니다. |
actor.callerType |
작업 수행자 유형입니다. |
actor.key |
|
actor.applicationInfo |
활동의 행위자였던 애플리케이션의 세부정보입니다. |
actor.applicationInfo.oauthClientId |
작업을 실행하는 데 사용된 서드 파티 애플리케이션의 OAuth 클라이언트 ID입니다. |
actor.applicationInfo.applicationName |
작업을 실행하는 데 사용된 애플리케이션의 이름입니다. |
actor.applicationInfo.impersonation |
애플리케이션이 사용자를 명의 도용했는지 여부입니다. |
resourceDetails[] |
작업이 실행된 리소스에 관한 세부정보입니다. |
ResourceDetails
작업이 실행된 리소스에 관한 세부정보입니다.
JSON 표현 |
---|
{
"id": string,
"title": string,
"type": string,
"appliedLabels": [
{
object ( |
필드 | |
---|---|
id |
리소스의 식별자입니다. |
title |
리소스의 제목입니다. 예를 들어 Drive 문서의 경우 문서 제목이 됩니다. 이메일의 경우 제목입니다. |
type |
리소스 유형 - 문서, 이메일, 채팅 메시지 |
appliedLabels[] |
리소스에 적용된 라벨의 activities.list |
relation |
리소스와 이벤트의 관계를 정의합니다. |
AppliedLabel
리소스에 적용된 라벨의 세부정보입니다.
JSON 표현 |
---|
{ "id": string, "title": string, "fieldValues": [ { object ( |
필드 | |
---|---|
id |
라벨 식별자 - 전체 OnePlatform 리소스 이름이 아닌 라벨 ID만 포함됩니다. |
title |
라벨 제목 |
fieldValues[] |
라벨의 일부이며 사용자가 설정한 필드의 활동 목록입니다. 라벨에 사용자가 설정하지 않은 필드가 있는 경우 이 목록에 표시되지 않습니다. |
reason |
리소스에 라벨이 적용된 이유입니다. |
FieldValue
사용자가 특정 라벨에 설정한 필드 값의 세부정보입니다.
JSON 표현 |
---|
{ "id": string, "displayName": string, "type": string, "reason": { object ( |
필드 | |
---|---|
id |
필드 식별자 |
displayName |
필드의 표시 이름 |
type |
필드 유형 |
reason |
필드가 라벨에 적용된 이유입니다. |
통합 필드 value . value 필드에 저장된 값은 다음 중 하나일 수 있습니다. |
|
unsetValue |
필드가 설정되지 않은 경우 이 값은 true입니다. |
longTextValue |
긴 텍스트 값을 설정합니다. |
textValue |
텍스트 값을 설정합니다. |
textListValue |
텍스트 목록 값을 설정합니다. |
selectionValue |
드롭다운에서 단일 값을 선택하여 선택 값을 설정합니다. |
selectionListValue |
드롭다운에서 여러 값을 선택하여 선택 목록 값을 설정합니다. |
integerValue |
정수 값을 설정합니다. |
userValue |
단일 사용자를 선택하여 사용자 값을 설정합니다. |
userListValue |
여러 사용자를 선택하여 사용자 목록 값을 설정합니다. |
dateValue |
날짜 값을 설정합니다. |
TextListValue
텍스트 목록 값을 설정합니다.
JSON 표현 |
---|
{ "values": [ string ] } |
필드 | |
---|---|
values[] |
텍스트 값의 activities.list |
SelectionValue
드롭다운에서 단일 값을 선택하여 선택 값을 설정합니다.
JSON 표현 |
---|
{ "id": string, "displayName": string, "badged": boolean } |
필드 | |
---|---|
id |
선택의 식별자입니다. |
displayName |
선택 항목의 표시 이름입니다. |
badged |
선택사항에 배지가 있는지 여부입니다. |
SelectionListValue
드롭다운에서 여러 값을 선택하여 선택 목록 값을 설정합니다.
JSON 표현 |
---|
{
"values": [
{
object ( |
필드 | |
---|---|
values[] |
선택 항목의 activities.list |
UserValue
단일 사용자를 선택하여 사용자 값을 설정합니다.
JSON 표현 |
---|
{ "email": string } |
필드 | |
---|---|
email |
사용자의 이메일입니다. |
UserListValue
여러 사용자를 선택하여 사용자 목록 값을 설정합니다.
JSON 표현 |
---|
{
"values": [
{
object ( |
필드 | |
---|---|
values[] |
activities.list of users |
날짜
생일과 같은 전체 또는 부분 달력 날짜를 나타냅니다. 시간과 시간대는 아무 곳으로 지정되거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 다음 중 하나를 나타낼 수 있습니다.
- 연도, 월, 일 값이 0이 아닌 전체 날짜
- 월과 일, 연도는 0(예: 기념일)
- 연도만, 월과 일은 0
- 연도와 월, 일은 0(예: 신용카드 만료일)
관련 유형:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
JSON 표현 |
---|
{ "year": integer, "month": integer, "day": integer } |
필드 | |
---|---|
year |
날짜의 연도입니다. 1~9999 사이여야 하며, 연도 없이 날짜를 지정하려면 0이어야 합니다. |
month |
연도의 월입니다. 1~12 사이여야 하며, 월과 일 없이 연도를 지정하려면 0이어야 합니다. |
day |
월의 일입니다. 1~31 사이여야 하고 해당 연도 및 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않아 연도와 월을 지정하려면 0이어야 합니다. |
이유
라벨/필드가 적용된 이유입니다.
JSON 표현 |
---|
{ "reasonType": string } |
필드 | |
---|---|
reasonType |
사유 유형입니다. |