Method: accounts.searchChangeHistoryEvents

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

HTTP 요청

POST https://analyticsadmin.googleapis.com/v1beta/{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)

선택사항입니다. 설정된 경우 이 시간 이후에 적용된 변경사항만 반환합니다 (타임스탬프 시점 포함).

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
latestChangeTime

string (Timestamp format)

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

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
pageSize

integer

선택사항입니다. 반환할 최대 ChangeHistoryEvent 항목 수입니다. 페이지가 더 있더라도 서비스에서 이 값보다 적은 값을 반환할 수 있습니다. 지정하지 않으면 최대 50개의 항목이 반환됩니다. 최댓값은 200입니다 (더 큰 값은 최댓값으로 강제 변환됩니다).
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 리소스
DATA_RETENTION_SETTINGS DataRetentionSettings 리소스
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 (ActorType),
  "userActorEmail": string,
  "changesFiltered": boolean,
  "changes": [
    {
      object (ChangeHistoryChange)
    }
  ]
}
필드
id

string

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

string (Timestamp format)

변경된 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
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)
  },
  "conversionEvent": {
    object (ConversionEvent)
  },
  "measurementProtocolSecret": {
    object (MeasurementProtocolSecret)
  },
  "dataRetentionSettings": {
    object (DataRetentionSettings)
  },
  "dataStream": {
    object (DataStream)
  }
  // End of list of possible types for union field resource.
}
필드

통합 필드 resource.

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

object (Account)

변경 내역의 계정 리소스 스냅샷
property

object (Property)

변경 내역의 속성 리소스 스냅샷
conversionEvent

object (ConversionEvent)

변경 내역의 ConversionEvent 리소스 스냅샷
measurementProtocolSecret

object (MeasurementProtocolSecret)

변경 내역의 MeasurementProtocolSecret 리소스 스냅샷
dataRetentionSettings

object (DataRetentionSettings)

변경 내역에 있는 데이터 보관 설정 리소스의 스냅샷입니다.
dataStream

object (DataStream)

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