Method: accounts.searchChangeHistoryEvents

在指定篩選器組合中,搜尋帳戶或子帳戶的所有變更。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
account

string

必要,要傳回變更記錄資源的帳戶資源。

要求主體

要求主體的資料會採用以下結構:

JSON 表示法
{
  "property": string,
  "resourceType": [
    enum (ChangeHistoryResourceType)
  ],
  "action": [
    enum (ActionType)
  ],
  "actorEmail": [
    string
  ],
  "earliestChangeTime": string,
  "latestChangeTime": string,
  "pageSize": integer,
  "pageToken": string
}
欄位
property

string

選用,子項資源的資源名稱。設定後,只會傳回對這項資源或其子項資源所做的變更。

resourceType[]

enum (ChangeHistoryResourceType)

選用,設定後,只有資源符合至少一種類型的資源時,才會傳回變更。

action[]

enum (ActionType)

選用,設定完成後,請只傳回與一或多種操作相符的變更。

actorEmail[]

string

選用,設定這項政策後,只有在這份清單中的使用者做出變更時,才能傳回變更。

earliestChangeTime

string (Timestamp format)

選用,設定之後,僅傳回在這個時間 (含) 之後所做的變更。

RFC3339 UTC 的「Zulu」格式時間戳記,單位為奈秒解析度,最多可達九位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

latestChangeTime

string (Timestamp format)

選用,如果設定這項政策,則只會傳回在此之前 (含首尾) 做出的變更。

RFC3339 UTC 的「Zulu」格式時間戳記,單位為奈秒解析度,最多可達九位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

pageSize

integer

選用,要傳回的 ChangeHistoryEvent 項目數量上限。即使仍有多頁,這項服務仍可能傳回比這個值更少的值。如未指定,最多傳回 50 個項目。最大值為 200 (系統會將較大的值強制調整為最大值)。

pageToken

string

選用,先前的 SearchChangeHistoryEvents 呼叫所接收的頁面權杖。提供這項資訊以擷取後續網頁。進行分頁時,提供給 SearchChangeHistoryEvents 的所有其他參數都必須與提供網頁憑證的呼叫相符。

回應主體

如果成功,回應主體即會包含具有以下結構的資料:

SearchAccounts RPC 的回應訊息。

JSON 表示法
{
  "changeHistoryEvents": [
    {
      object (ChangeHistoryEvent)
    }
  ],
  "nextPageToken": string
}
欄位
changeHistoryEvents[]

object (ChangeHistoryEvent)

呼叫端可存取的結果。

nextPageToken

string

pageToken 形式傳送的權杖來擷取下一頁。如果省略這個欄位,就不會有後續頁面。

授權範圍

需要下列 OAuth 範圍:

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

變更記錄資源類型

可能會從變更記錄傳回變更的資源類型。

列舉
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED 資源類型不明或未指定。
ACCOUNT 帳戶資源
PROPERTY 資源資源
GOOGLE_SIGNALS_SETTINGS GoogleSignalsSettings 資源
CONVERSION_EVENT ConversionEvent 資源
MEASUREMENT_PROTOCOL_SECRET Measurement ProtocolSecret 資源
DATA_RETENTION_SETTINGS DatatainSettings 資源
DATA_STREAM DataStream 資源
ATTRIBUTION_SETTINGS AttributionSettings 資源

動作類型

可能變更資源的動作類型。

列舉
ACTION_TYPE_UNSPECIFIED 動作類型不明或未指定。
CREATED 資源是在這項變更中建立的。
UPDATED 已更新此資源中的資源。
DELETED 資源已從這項變更中刪除。

變更記錄事件

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 UTC 的「Zulu」格式時間戳記,單位為奈秒解析度,最多可達九位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

actorType

enum (ActorType)

進行這項變更的執行者類型。

userActorEmail

string

進行變更的 Google 帳戶電子郵件地址。如果 actor 欄位設為 USER,則為有效的電子郵件地址。遭到刪除的 Google 帳戶會導致錯誤發生。

changesFiltered

boolean

如果為 true,系統會傳回傳回的變更清單,並不代表這個事件發生的所有變更。

changes[]

object (ChangeHistoryChange)

變更記錄清單,與 SearchChangeHistoryEventsRequest 中指定的篩選器所做的變更。

執行者類型

可變更 Google Analytics (分析) 資源的不同執行者。

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

變更記錄變更

單一 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)

變更完成後的資源內容。如果在這項變更中刪除這項資源,這個欄位將會遺失。

變更記錄資源

變更記錄中 (變更前後) 資源的快照。

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)

變更記錄中的 Measurement ProtocolSecret 資源數據匯報。

dataRetentionSettings

object (DataRetentionSettings)

變更記錄中的資料保留設定資源數據匯報。

dataStream

object (DataStream)

含有變更記錄中 DataStream 資源的快照。