- HTTP 要求
- 路徑參數
- 要求主體
- 回應主體
- 授權範圍
- ChangeHistoryResourceType
- ActionType
- ChangeHistoryEvent
- ActorType
- ChangeHistoryChange
- ChangeHistoryResource
- 試試看!
依指定篩選器組合搜尋帳戶或其子項的所有變更。
HTTP 要求
POST https://analyticsadmin.googleapis.com/v1alpha/{account=accounts/*}:searchChangeHistoryEvents
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
account |
必要欄位。要傳回變更記錄資源的帳戶資源。格式:accounts/{account} 範例:「accounts/100」 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{ "property": string, "resourceType": [ enum ( |
欄位 | |
---|---|
property |
選用設定。子項屬性的資源名稱。設定後,僅會傳回針對這項資源或其子項資源所做的變更。格式:properties/{propertyId} 範例:「properties/100」 |
resourceType[] |
選用設定。設定後,只有在資源符合至少其中一種型別時,才會傳回變更。 |
action[] |
選用設定。設定後,系統只會傳回與上述一或多種動作類型相符的變更。 |
actorEmail[] |
選用設定。設定後,只有當清單中的使用者做了變更時,系統才會傳回這些變更。 |
earliestChangeTime |
選用設定。如有設定,則僅傳回這個時間之後的變更 (含)。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
latestChangeTime |
選用設定。如果設定此設定,則只會傳回這個時間之前所做的變更 (含)。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
pageSize |
選用設定。要傳回的 ChangeHistoryEvent 項目數量上限。服務傳回的網頁可能會少於這個值,即使還有其他網頁也一樣。如未指定,最多將傳回 50 個項目。許可的最大值為 200 (上限值將強制轉換成最大值)。 |
pageToken |
選用設定。屬於接收自前一個 |
回應主體
SearchAccounts RPC 的回應訊息。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{
"changeHistoryEvents": [
{
object ( |
欄位 | |
---|---|
changeHistoryEvents[] |
呼叫者可存取的結果。 |
nextPageToken |
可做為 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/analytics.edit
ChangeHistoryResourceType
可從變更記錄傳回其變更的資源類型。
列舉 | |
---|---|
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED |
資源類型不明或未指定。 |
ACCOUNT |
帳戶資源 |
PROPERTY |
資源資源 |
FIREBASE_LINK |
FirebaseLink 資源 |
GOOGLE_ADS_LINK |
GoogleAdsLink 資源 |
GOOGLE_SIGNALS_SETTINGS |
GoogleSignalsSettings 資源 |
CONVERSION_EVENT |
ConversionEvent 資源 |
MEASUREMENT_PROTOCOL_SECRET |
MeasurementProtocolSecret 資源 |
CUSTOM_DIMENSION |
自訂維度資源 |
CUSTOM_METRIC |
自訂指標資源 |
DATA_RETENTION_SETTINGS |
DatareservationSettings 資源 |
DISPLAY_VIDEO_360_ADVERTISER_LINK |
DisplayVideo360AdvertiserLink 資源 |
DISPLAY_VIDEO_360_ADVERTISER_LINK_PROPOSAL |
DisplayVideo360AdvertiserLinkProposal 資源 |
SEARCH_ADS_360_LINK |
SearchAds360Link 資源 |
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 資源 |
ADSENSE_LINK |
AdSenseLink 資源 |
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 ( |
欄位 | |
---|---|
id |
此變更記錄事件的 ID。這個 ID 在 Google Analytics (分析) 中不會重複。 |
changeTime |
變更時間。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
actorType |
做出此變更的執行者類型。 |
userActorEmail |
進行變更的 Google 帳戶電子郵件地址。如果執行者欄位設為 USER,這個有效的電子郵件地址;如果不是,這會空白。已刪除的 Google 帳戶會導致錯誤。 |
changesFiltered |
若為 true,則傳回的變更清單會遭到篩除,不代表此事件中發生的所有變更。 |
changes[] |
根據 SearchChangeHistoryEventsRequest 指定的篩選器,在這個變更記錄事件中做出的變更清單。 |
ActorType
能對 Google Analytics (分析) 資源進行變更的不同發動者。
列舉 | |
---|---|
ACTOR_TYPE_UNSPECIFIED |
不明或未指定的演員類型。 |
USER |
由 actorEmail 指定的使用者所進行的變更。 |
SYSTEM |
由 Google Analytics (分析) 系統所做的變更。 |
SUPPORT |
Google Analytics (分析) 支援團隊成員所做的變更。 |
ChangeHistoryChange
單一 Google Analytics (分析) 資源的變更說明。
JSON 表示法 |
---|
{ "resource": string, "action": enum ( |
欄位 | |
---|---|
resource |
此項目說明其變更的資源資源名稱。 |
action |
變更這項資源的動作類型。 |
resourceBeforeChange |
變更前的資源內容。如果這項資源是在這項變更中建立,這個欄位將不會出現。 |
resourceAfterChange |
變更後的資源內容。如果這項資源在這項變更中遭到刪除,這個欄位就會遺漏。 |
ChangeHistoryResource
變更記錄異動結果前後的資源快照。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位
|
|
account |
變更記錄中的帳戶資源數據匯報。 |
property |
變更記錄中資源資源的數據匯報。 |
firebaseLink |
變更記錄中的 FirebaseLink 資源數據匯報。 |
googleAdsLink |
變更記錄中的 GoogleAdsLink 資源數據匯報。 |
googleSignalsSettings |
變更記錄中的 GoogleSignalsSettings 資源的數據匯報。 |
displayVideo360AdvertiserLink |
變更記錄中的 DisplayVideo360AdvertiserLink 資源數據匯報。 |
displayVideo360AdvertiserLinkProposal |
變更記錄中的 DisplayVideo360AdvertiserLinkProposal 資源的數據匯報。 |
conversionEvent |
變更記錄中的 ConversionEvent 資源數據匯報。 |
measurementProtocolSecret |
變更記錄中的 MeasurementProtocolSecret 資源快照。 |
customDimension |
變更記錄中的自訂維度資源數據匯報。 |
customMetric |
變更記錄中的自訂指標資源數據匯報。 |
dataRetentionSettings |
變更記錄中的資料保留設定資源的數據匯報。 |
searchAds360Link |
變更記錄中的 SearchAds360Link 資源數據匯報。 |
dataStream |
變更記錄中的 DataStream 資源數據匯報。 |
attributionSettings |
變更記錄中的 AttributionSettings 資源數據匯報。 |
expandedDataSet |
變更記錄中 ExpandedDataSet 資源的數據匯報。 |
channelGroup |
變更記錄中的 ChannelGroup 資源數據匯報。 |
bigqueryLink |
變更記錄中的 BigQuery 連結資源快照。 |
enhancedMeasurementSettings |
變更記錄中的 EnhancedMeasurementSettings 資源數據匯報。 |
dataRedactionSettings |
變更記錄中的 DataRedactionSettings 資源的數據匯報。 |
skadnetworkConversionValueSchema |
變更記錄中的 SKAdNetworkConversionValueSchema 資源快照。 |
adsenseLink |
變更記錄中的 AdSenseLink 資源數據匯報。 |
audience |
變更記錄中的目標對象資源數據匯報。 |
eventCreateRule |
變更記錄中的 EventCreateRule 資源的數據匯報。 |
calculatedMetric |
變更記錄中的 CalculatedMetric 資源快照。 |