Method: accounts.searchChangeHistoryEvents

依指定篩選器組合搜尋帳戶或其子項的所有變更。

HTTP 要求

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

這個網址使用 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 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
latestChangeTime

string (Timestamp format)

選用設定。如果設定此設定，則只會傳回這個時間之前所做的變更 (含)。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："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 資源
CUSTOM_DIMENSION 自訂維度資源
CUSTOM_METRIC 自訂指標資源
DATA_RETENTION_SETTINGS DatareservationSettings 資源
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 Analytics (分析) 帳戶或其子資源中的一組變更。常見的原因包括在 Google Analytics (分析) 使用者介面中更新、客戶支援服務異動，或是 Google Analytics (分析) 系統自動變更。

JSON 表示法 
{
  "id": string,
  "changeTime": string,
  "actorType": enum (ActorType),
  "userActorEmail": string,
  "changesFiltered": boolean,
  "changes": [
    {
      object (ChangeHistoryChange)
    }
  ]
}
欄位
id

string

此變更記錄事件的 ID。這個 ID 在 Google Analytics (分析) 中不會重複。
changeTime

string (Timestamp format)

變更時間。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："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 Analytics (分析) 資源進行變更的不同發動者。

列舉
ACTOR_TYPE_UNSPECIFIED 不明或未指定的演員類型。
USER 由 actorEmail 指定的使用者所進行的變更。
SYSTEM 由 Google Analytics (分析) 系統所做的變更。
SUPPORT Google Analytics (分析) 支援團隊成員所做的變更。

ChangeHistoryChange

單一 Google Analytics (分析) 資源的變更說明。

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)

變更記錄中的自訂維度資源數據匯報。
customMetric

object (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 資源快照。