- HTTP 요청
- 경로 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- ChangeHistoryResourceType
- ActionType
- ChangeHistoryEvent
- ActorType
- ChangeHistoryChange
- ChangeHistoryResource
- 실습
지정된 필터 조합을 기준으로 계정 또는 하위 계정에 대한 모든 변경사항을 검색합니다.
HTTP 요청
POST https://analyticsadmin.googleapis.com/v1beta/{account=accounts/*}:searchChangeHistoryEvents
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
account |
필수 항목입니다. 변경 내역 리소스를 반환할 계정 리소스입니다. 형식: accounts/{account} 예: 'accounts/100' |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "property": string, "resourceType": [ enum ( |
입력란 | |
---|---|
property |
선택사항입니다. 하위 속성의 리소스 이름입니다. 설정하면 이 속성 또는 하위 리소스의 변경사항만 반환합니다. 형식: properties/{propertyId} 예: 'properties/100' |
resourceType[] |
선택사항입니다. 설정된 경우 이러한 유형 중 하나 이상과 일치하는 리소스에 대한 변경사항만 반환합니다. |
action[] |
선택사항입니다. 설정하면 이러한 작업 유형 중 하나 이상과 일치하는 변경사항만 반환합니다. |
actorEmail[] |
선택사항입니다. 설정하면 이 목록에 있는 사용자가 변경한 경우에만 변경사항을 반환합니다. |
earliestChangeTime |
선택사항입니다. 설정된 경우 이 시간 이후 변경된 사항만 반환합니다 (해당 시간 포함). RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
latestChangeTime |
선택사항입니다. 설정하면 이 시간 (해당 시간 포함) 이전에 변경된 내용만 반환합니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
pageSize |
선택사항입니다. 반환할 ChangeHistoryEvent 항목의 최대 개수입니다. 추가 페이지가 있어도 서비스에서 이 값보다 더 적은 값을 반환할 수 있습니다. 지정하지 않으면 최대 50개의 항목이 반환됩니다. 최댓값은 200입니다 (더 높은 값은 최댓값으로 강제 변환됩니다). |
pageToken |
선택사항입니다. 이전 |
응답 본문
SearchAccounts RPC의 응답 메시지입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"changeHistoryEvents": [
{
object ( |
입력란 | |
---|---|
changeHistoryEvents[] |
호출자가 액세스할 수 있었던 결과입니다. |
nextPageToken |
다음 페이지를 검색하기 위해 |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/analytics.edit
ChangeHistoryResourceType
변경 내역에서 변경사항을 반환할 수 있는 리소스 유형입니다.
열거형 | |
---|---|
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED |
리소스 유형을 알 수 없거나 지정되지 않았습니다. |
ACCOUNT |
계정 리소스 |
PROPERTY |
속성 리소스 |
FIREBASE_LINK |
FirebaseLink 리소스 |
GOOGLE_ADS_LINK |
GoogleAdsLink 리소스 |
GOOGLE_SIGNALS_SETTINGS |
GoogleSignalsSettings 리소스 |
CONVERSION_EVENT |
ConversionEvent 리소스 |
MEASUREMENT_PROTOCOL_SECRET |
MeasurementProtocolSecret 리소스 |
DATA_RETENTION_SETTINGS |
DataRetainSettings 리소스 |
DISPLAY_VIDEO_360_ADVERTISER_LINK |
DisplayVideo360AdvertiserLink 리소스 |
DISPLAY_VIDEO_360_ADVERTISER_LINK_PROPOSAL |
DisplayVideo360AdvertiserLinkSuggestion 리소스 |
DATA_STREAM |
DataStream 리소스 |
ATTRIBUTION_SETTINGS |
AttributionSettings 리소스 |
ActionType
리소스를 변경할 수 있는 작업 유형입니다.
열거형 | |
---|---|
ACTION_TYPE_UNSPECIFIED |
작업 유형을 알 수 없거나 지정되지 않았습니다. |
CREATED |
이 변경사항에서 리소스가 생성되었습니다. |
UPDATED |
이 변경사항에서 리소스가 업데이트되었습니다. |
DELETED |
이 변경사항에서 리소스가 삭제되었습니다. |
ChangeHistoryEvent
동일한 원인으로 인해 발생한 Google 애널리틱스 계정 또는 하위 속성 내의 변경사항 모음입니다. 일반적인 원인으로는 Google 애널리틱스 UI를 업데이트하거나 고객 지원팀에서 변경했거나 Google 애널리틱스 시스템이 자동으로 변경되었을 수 있습니다.
JSON 표현 |
---|
{ "id": string, "changeTime": string, "actorType": enum ( |
입력란 | |
---|---|
id |
이 변경 내역 이벤트의 ID입니다. 이 ID는 Google 애널리틱스 전체에서 고유합니다. |
changeTime |
변경이 이루어진 시간입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
actorType |
이렇게 변경한 작업 수행자의 유형입니다. |
userActorEmail |
변경을 수행한 Google 계정의 이메일 주소입니다. 행위자 필드가 사용자로 설정된 경우 유효한 이메일 주소이며 그렇지 않으면 비어 있습니다. 삭제된 Google 계정은 오류를 일으킵니다. |
changesFiltered |
true인 경우 반환된 변경사항 목록이 필터링되며, 이 이벤트에서 발생한 모든 변경사항을 나타내지는 않습니다. |
changes[] |
SearchChangeHistoryEventsRequest에 지정된 필터에 맞는 이 변경 내역 이벤트의 변경사항 목록입니다. |
ActorType
Google 애널리틱스 리소스를 변경할 수 있는 다양한 유형의 행위자
열거형 | |
---|---|
ACTOR_TYPE_UNSPECIFIED |
알 수 없거나 지정되지 않은 액터 유형입니다. |
USER |
actorEmail에 지정된 사용자가 변경한 사항 |
SYSTEM |
Google 애널리틱스 시스템에 의한 변경사항 |
SUPPORT |
Google 애널리틱스 지원팀 직원의 변경사항 |
ChangeHistoryChange
단일 Google 애널리틱스 리소스에 대한 변경사항에 대한 설명입니다.
JSON 표현 |
---|
{ "resource": string, "action": enum ( |
입력란 | |
---|---|
resource |
이 항목에서 변경사항을 설명하는 리소스의 리소스 이름입니다. |
action |
이 리소스를 변경한 작업 유형입니다. |
resourceBeforeChange |
변경 전의 리소스 콘텐츠입니다. 이번 변경사항으로 이 리소스를 만들었다면 이 필드가 누락됩니다. |
resourceAfterChange |
변경 후의 리소스 콘텐츠입니다. 변경사항으로 이 리소스가 삭제된 경우 이 필드가 누락됩니다. |
ChangeHistoryResource
변경 내역 변경의 결과 전후의 리소스 스냅샷입니다.
JSON 표현 |
---|
{ // Union field |
입력란 | |
---|---|
통합 필드
|
|
account |
변경 내역에 있는 계정 리소스의 개요입니다. |
property |
변경 내역에 있는 속성 리소스의 스냅샷입니다. |
firebaseLink |
변경 내역에 있는 FirebaseLink 리소스의 스냅샷입니다. |
googleAdsLink |
변경 내역에 있는 GoogleAdsLink 리소스의 개요입니다. |
conversionEvent |
변경 내역에 있는 ConversionEvent 리소스의 스냅샷입니다. |
measurementProtocolSecret |
변경 내역에 있는 MeasurementProtocolSecret 리소스의 스냅샷입니다. |
dataRetentionSettings |
변경 내역에 있는 데이터 보관 설정 리소스의 스냅샷입니다. |
dataStream |
변경 내역에 있는 DataStream 리소스의 스냅샷입니다. |