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 리소스
CALCULATED_METRIC CalculatedMetric 리소스

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)
  },
  "calculatedMetric": {
    object (CalculatedMetric)
  }
  // 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 리소스 스냅샷

calculatedMetric

object (CalculatedMetric)

변경 내역의 CalculatedMetric 리소스 스냅샷