- HTTP 요청
- 경로 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- ChangeHistoryResourceType
- ActionType
- ChangeHistoryEvent
- ActorType
- ChangeHistoryChange
- ChangeHistoryResource
- 실습
지정된 필터 조합을 기준으로 계정 또는 하위 계정에 대한 모든 변경사항을 검색합니다.
HTTP 요청
POST https://analyticsadmin.googleapis.com/v1alpha/{account=accounts/*}:searchChangeHistoryEvents
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
account |
필수 항목입니다. 변경 내역 리소스를 반환할 계정 리소스입니다. 형식: accounts/{account} 예: |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "property": string, "resourceType": [ enum ( |
필드 | |
---|---|
property |
선택사항입니다. 하위 속성의 리소스 이름입니다. 설정된 경우 이 속성 또는 하위 리소스의 변경사항만 반환합니다. 형식: properties/{propertyId} 예: |
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 리소스 |
CUSTOM_DIMENSION |
맞춤 측정기준 리소스 |
CUSTOM_METRIC |
CustomMetric 리소스 |
DATA_RETENTION_SETTINGS |
DataRetainSettings 리소스 |
DISPLAY_VIDEO_360_ADVERTISER_LINK |
DisplayVideo360AdvertiserLink 리소스 |
DISPLAY_VIDEO_360_ADVERTISER_LINK_PROPOSAL |
DisplayVideo360AdvertiserLink제안서 리소스 |
SEARCH_ADS_360_LINK |
SearchAds360Link 리소스 |
DATA_STREAM |
DataStream 리소스 |
ATTRIBUTION_SETTINGS |
AttributionSettings 리소스 |
EXPANDED_DATA_SET |
ExtendedDataSet 리소스 |
CHANNEL_GROUP |
ChannelGroup 리소스 |
BIGQUERY_LINK |
BigQuery 링크 리소스 |
ENHANCED_MEASUREMENT_SETTINGS |
EnhancedMeasurementSettings 리소스 |
DATA_REDACTION_SETTINGS |
DataRedactionSettings 리소스 |
SKADNETWORK_CONVERSION_VALUE_SCHEMA |
SKAdNetworkConversionValueSchema 리소스 |
ADSENSE_LINK |
AdSenseLink 리소스 |
AUDIENCE |
잠재고객 리소스 |
EVENT_CREATE_RULE |
EventCreateRule 리소스 |
CALCULATED_METRIC |
CalculatedMetric 리소스 |
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 계정의 이메일 주소 액터 필드가 USER로 설정된 경우 유효한 이메일 주소이고, 그렇지 않은 경우 비어 있습니다. 삭제된 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 리소스의 스냅샷입니다. |
googleSignalsSettings |
변경 내역에 있는 GoogleSignalsSettings 리소스의 스냅샷입니다. |
displayVideo360AdvertiserLink |
변경 내역에 있는 DisplayVideo360AdvertiserLink 리소스의 스냅샷입니다. |
displayVideo360AdvertiserLinkProposal |
변경 내역에 있는 DisplayVideo360AdvertiserLinkSuggestion 리소스 개요. |
conversionEvent |
변경 내역에 있는 ConversionEvent 리소스의 스냅샷입니다. |
measurementProtocolSecret |
변경 내역에 있는 MeasurementProtocolSecret 리소스의 스냅샷입니다. |
customDimension |
변경 내역에 있는 CustomDimension 리소스의 스냅샷입니다. |
customMetric |
변경 내역에 있는 CustomMetric 리소스의 스냅샷입니다. |
dataRetentionSettings |
변경 내역에 있는 데이터 보관 설정 리소스의 스냅샷입니다. |
searchAds360Link |
변경 내역에 있는 SearchAds360Link 리소스의 스냅샷입니다. |
dataStream |
변경 내역에 있는 DataStream 리소스의 스냅샷입니다. |
attributionSettings |
변경 내역의 AttributionSettings 리소스 스냅샷 |
expandedDataSet |
변경 내역에 있는 ScaledDataSet 리소스의 스냅샷입니다. |
channelGroup |
변경 내역에 있는 ChannelGroup 리소스의 스냅샷입니다. |
bigqueryLink |
변경 내역에 있는 BigQuery 링크 리소스의 스냅샷입니다. |
enhancedMeasurementSettings |
변경 내역에 있는 EnhancedMeasurementSettings 리소스의 개요입니다. |
dataRedactionSettings |
변경 내역에 있는 DataRedactionSettings 리소스의 스냅샷입니다. |
skadnetworkConversionValueSchema |
변경 내역에 있는 SKAdNetworkConversionValueSchema 리소스의 스냅샷입니다. |
adsenseLink |
변경 내역에 있는 AdSenseLink 리소스의 스냅샷입니다. |
audience |
변경 내역에 있는 잠재고객 리소스의 스냅샷입니다. |
eventCreateRule |
변경 내역에 있는 EventCreateRule 리소스의 스냅샷입니다. |
calculatedMetric |
변경 내역에 있는 CalculatedMetric 리소스의 스냅샷입니다. |