Method: accounts.searchChangeHistoryEvents

지정된 필터 집합을 기준으로 계정 또는 하위 계정의 모든 변경사항을 검색합니다.

API에서 지원하는 변경사항의 하위 집합만 반환합니다. UI에서 추가 변경사항을 반환할 수 있습니다.

HTTP 요청

POST https://analyticsadmin.googleapis.com/v1alpha/{account=accounts/*}:searchChangeHistoryEvents

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

경로 매개변수

매개변수
account

string

필수입니다. 변경 내역 리소스를 반환할 계정 리소스입니다. 형식: accounts/{account}

예: accounts/100

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "property": string,
  "resourceType": [
    enum (ChangeHistoryResourceType)
  ],
  "action": [
    enum (ActionType)
  ],
  "actorEmail": [
    string
  ],
  "earliestChangeTime": string,
  "latestChangeTime": string,
  "pageSize": integer,
  "pageToken": string
}
필드
property

string

선택사항입니다. 하위 속성의 리소스 이름입니다. 설정된 경우 이 속성 또는 하위 리소스에 적용된 변경사항만 반환합니다. 형식: properties/{propertyId}

예: properties/100
resourceType[]

enum (ChangeHistoryResourceType)

선택사항입니다. 설정된 경우 이러한 유형 중 하나 이상과 일치하는 리소스의 변경사항만 반환합니다.
action[]

enum (ActionType)

선택사항입니다. 설정된 경우 이러한 유형의 작업 중 하나 이상과 일치하는 변경사항만 반환합니다.
actorEmail[]

string

선택사항입니다. 설정된 경우 이 목록의 사용자가 변경한 경우에만 변경사항을 반환합니다.
earliestChangeTime

string (Timestamp format)

선택사항입니다. 설정된 경우 이 시간 이후에 이루어진 변경사항만 반환합니다 (시간 포함).

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
latestChangeTime

string (Timestamp format)

선택사항입니다. 설정된 경우 이 시간 이전에 이루어진 변경사항만 반환합니다 (이 시간 포함).

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
pageSize

integer

선택사항입니다. 반환할 최대 ChangeHistoryEvent 항목 수입니다. 지정하지 않으면 최대 50개의 항목이 반환됩니다. 최댓값은 200입니다 (더 높은 값은 최댓값으로 변환됨).

서비스에서 이 값보다 적은 항목이 있는 페이지 (0개일 수도 있음)를 반환할 수 있으며 추가 페이지가 있을 수도 있습니다. 특정 개수의 항목을 원하는 경우 필요한 개수를 얻을 때까지 pageToken를 사용하여 추가 페이지를 계속 요청해야 합니다.
pageToken

string

선택사항입니다. 이전 accounts.searchChangeHistoryEvents 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지로 나누는 경우, accounts.searchChangeHistoryEvents에 제공하는 다른 모든 매개변수가 페이지 토큰을 제공한 호출과 일치해야 합니다.

응답 본문

SearchAccounts RPC의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "changeHistoryEvents": [
    {
      object (ChangeHistoryEvent)
    }
  ],
  "nextPageToken": string
}
필드
changeHistoryEvents[]

object (ChangeHistoryEvent)

호출자가 액세스할 수 있는 결과입니다.
nextPageToken

string

다음 페이지를 검색하기 위해 pageToken으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/analytics.edit

ChangeHistoryResourceType

변경 내역에서 변경사항이 반환될 수 있는 리소스 유형입니다.

열거형
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED 리소스 유형을 알 수 없거나 지정되지 않았습니다.
ACCOUNT 계정 리소스
PROPERTY 속성 리소스
GOOGLE_SIGNALS_SETTINGS GoogleSignalsSettings 리소스
CONVERSION_EVENT ConversionEvent 리소스
MEASUREMENT_PROTOCOL_SECRET MeasurementProtocolSecret 리소스
CUSTOM_DIMENSION CustomDimension 리소스
CUSTOM_METRIC CustomMetric 리소스
DATA_RETENTION_SETTINGS DataRetentionSettings 리소스
DATA_STREAM DataStream 리소스
ATTRIBUTION_SETTINGS AttributionSettings 리소스
EXPANDED_DATA_SET ExpandedDataSet 리소스
CHANNEL_GROUP ChannelGroup 리소스
ENHANCED_MEASUREMENT_SETTINGS EnhancedMeasurementSettings 리소스
DATA_REDACTION_SETTINGS DataRedactionSettings 리소스
SKADNETWORK_CONVERSION_VALUE_SCHEMA SKAdNetworkConversionValueSchema 리소스
AUDIENCE 잠재고객 리소스
EVENT_CREATE_RULE EventCreateRule 리소스
KEY_EVENT KeyEvent 리소스
CALCULATED_METRIC CalculatedMetric 리소스
REPORTING_DATA_ANNOTATION ReportingDataAnnotation 리소스
SUBPROPERTY_SYNC_CONFIG SubpropertySyncConfig 리소스
REPORTING_IDENTITY_SETTINGS ReportingIdentitySettings 리소스

ActionType

리소스를 변경할 수 있는 작업 유형입니다.

열거형
ACTION_TYPE_UNSPECIFIED 작업 유형을 알 수 없거나 지정되지 않았습니다.
CREATED 이 변경사항에서 리소스가 생성되었습니다.
UPDATED 이 변경사항에서 리소스가 업데이트되었습니다.
DELETED 이 변경사항에서 리소스가 삭제되었습니다.

ChangeHistoryEvent

Google 애널리틱스 계정 또는 하위 속성에서 동일한 원인으로 인해 발생한 변경사항의 집합입니다. 일반적인 원인으로는 Google 애널리틱스 UI에서 이루어진 업데이트, 고객 지원팀의 변경사항, Google 애널리틱스 시스템의 자동 변경사항이 있습니다.

JSON 표현 
{
  "id": string,
  "changeTime": string,
  "actorType": enum (ActorType),
  "userActorEmail": string,
  "changesFiltered": boolean,
  "changes": [
    {
      object (ChangeHistoryChange)
    }
  ]
}
필드
id

string

이 변경 기록 이벤트의 ID입니다. 이 ID는 Google 애널리틱스에서 고유합니다.
changeTime

string (Timestamp format)

변경이 이루어진 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
actorType

enum (ActorType)

이 변경사항을 적용한 행위자의 유형입니다.
userActorEmail

string

변경을 적용한 Google 계정의 이메일 주소입니다. 작업 수행자 필드가 USER로 설정된 경우 올바른 이메일 주소이며, 그렇지 않은 경우 비어 있습니다. 삭제된 Google 계정은 오류를 일으킵니다.
changesFiltered

boolean

true인 경우 반환된 변경사항 목록이 필터링되었으며 이 이벤트에서 발생한 모든 변경사항을 나타내지 않습니다.
changes[]

object (ChangeHistoryChange)

SearchChangeHistoryEventsRequest에 지정된 필터에 맞는 이 변경 내역 이벤트에서 이루어진 변경사항 목록입니다.

ActorType

Google 애널리틱스 리소스를 변경할 수 있는 다양한 종류의 행위자입니다.

열거형
ACTOR_TYPE_UNSPECIFIED 알 수 없거나 지정되지 않은 행위자 유형입니다.
USER actorEmail에 지정된 사용자가 변경한 사항입니다.
SYSTEM Google 애널리틱스 시스템에서 변경한 사항입니다.
SUPPORT Google 애널리틱스 지원팀 직원이 변경한 사항입니다.

ChangeHistoryChange

단일 Google 애널리틱스 리소스의 변경사항에 대한 설명입니다.

JSON 표현 
{
  "resource": string,
  "action": enum (ActionType),
  "resourceBeforeChange": {
    object (ChangeHistoryResource)
  },
  "resourceAfterChange": {
    object (ChangeHistoryResource)
  }
}
필드
resource

string

이 항목에서 변경사항을 설명하는 리소스의 리소스 이름입니다.
action

enum (ActionType)

이 리소스를 변경한 작업의 유형입니다.
resourceBeforeChange

object (ChangeHistoryResource)

변경 전 리소스 콘텐츠입니다. 이 리소스가 이 변경사항에서 생성된 경우 이 필드가 누락됩니다.
resourceAfterChange

object (ChangeHistoryResource)

변경 후의 리소스 콘텐츠입니다. 이 리소스가 이 변경사항에서 삭제된 경우 이 필드가 누락됩니다.

ChangeHistoryResource

변경 내역의 변경 결과 전후의 리소스 스냅샷입니다.

JSON 표현 
{

  // Union field resource can be only one of the following:
  "account": {
    object (Account)
  },
  "property": {
    object (Property)
  },
  "firebaseLink": {
    object (FirebaseLink)
  },
  "googleAdsLink": {
    object (GoogleAdsLink)
  },
  "googleSignalsSettings": {
    object (GoogleSignalsSettings)
  },
  "displayVideo360AdvertiserLink": {
    object (DisplayVideo360AdvertiserLink)
  },
  "displayVideo360AdvertiserLinkProposal": {
    object (DisplayVideo360AdvertiserLinkProposal)
  },
  "conversionEvent": {
    object (ConversionEvent)
  },
  "measurementProtocolSecret": {
    object (MeasurementProtocolSecret)
  },
  "customDimension": {
    object (CustomDimension)
  },
  "customMetric": {
    object (CustomMetric)
  },
  "dataRetentionSettings": {
    object (DataRetentionSettings)
  },
  "searchAds360Link": {
    object (SearchAds360Link)
  },
  "dataStream": {
    object (DataStream)
  },
  "attributionSettings": {
    object (AttributionSettings)
  },
  "expandedDataSet": {
    object (ExpandedDataSet)
  },
  "channelGroup": {
    object (ChannelGroup)
  },
  "bigqueryLink": {
    object (BigQueryLink)
  },
  "enhancedMeasurementSettings": {
    object (EnhancedMeasurementSettings)
  },
  "dataRedactionSettings": {
    object (DataRedactionSettings)
  },
  "skadnetworkConversionValueSchema": {
    object (SKAdNetworkConversionValueSchema)
  },
  "adsenseLink": {
    object (AdSenseLink)
  },
  "audience": {
    object (Audience)
  },
  "eventCreateRule": {
    object (EventCreateRule)
  },
  "keyEvent": {
    object (KeyEvent)
  },
  "calculatedMetric": {
    object (CalculatedMetric)
  },
  "reportingDataAnnotation": {
    object (ReportingDataAnnotation)
  },
  "subpropertySyncConfig": {
    object (SubpropertySyncConfig)
  },
  "reportingIdentitySettings": {
    object (ReportingIdentitySettings)
  }
  // End of list of possible types for union field resource.
}
필드

통합 필드 resource.

resource는 다음 중 하나여야 합니다.
account

object (Account)

변경 내역에 있는 계정 리소스의 스냅샷입니다.
property

object (Property)

변경 내역의 속성 리소스 스냅샷입니다.
googleSignalsSettings

object (GoogleSignalsSettings)

변경 내역의 GoogleSignalsSettings 리소스 스냅샷입니다.
conversionEvent

object (ConversionEvent)

변경 내역의 ConversionEvent 리소스 스냅샷입니다.
measurementProtocolSecret

object (MeasurementProtocolSecret)

변경 내역에 있는 MeasurementProtocolSecret 리소스의 스냅샷입니다.
customDimension

object (CustomDimension)

변경 내역의 CustomDimension 리소스 스냅샷입니다.
customMetric

object (CustomMetric)

변경 내역의 CustomMetric 리소스 스냅샷입니다.
dataRetentionSettings

object (DataRetentionSettings)

변경 기록의 데이터 보관 설정 리소스 스냅샷입니다.
dataStream

object (DataStream)

변경 내역에 있는 DataStream 리소스의 스냅샷입니다.
attributionSettings

object (AttributionSettings)

변경 내역의 AttributionSettings 리소스 스냅샷입니다.
expandedDataSet

object (ExpandedDataSet)

변경 내역에 있는 ExpandedDataSet 리소스의 스냅샷입니다.
channelGroup

object (ChannelGroup)

변경 내역의 ChannelGroup 리소스 스냅샷입니다.
enhancedMeasurementSettings

object (EnhancedMeasurementSettings)

변경 내역의 EnhancedMeasurementSettings 리소스 스냅샷입니다.
dataRedactionSettings

object (DataRedactionSettings)

변경 내역의 DataRedactionSettings 리소스 스냅샷입니다.
skadnetworkConversionValueSchema

object (SKAdNetworkConversionValueSchema)

변경 내역의 SKAdNetworkConversionValueSchema 리소스 스냅샷입니다.
audience

object (Audience)

변경 내역의 잠재고객 리소스 스냅샷입니다.
eventCreateRule

object (EventCreateRule)

변경 내역의 EventCreateRule 리소스 스냅샷입니다.
keyEvent

object (KeyEvent)

변경 내역의 KeyEvent 리소스 스냅샷입니다.
calculatedMetric

object (CalculatedMetric)

변경 내역에 있는 CalculatedMetric 리소스의 스냅샷입니다.
reportingDataAnnotation

object (ReportingDataAnnotation)

변경 내역의 ReportingDataAnnotation 리소스 스냅샷입니다.
subpropertySyncConfig

object (SubpropertySyncConfig)

변경 내역의 SubpropertySyncConfig 리소스 스냅샷
reportingIdentitySettings

object (ReportingIdentitySettings)

변경 내역의 ReportingIdentitySettings 리소스 스냅샷입니다.