Method: accounts.searchChangeHistoryEvents

指定されたフィルタセットで、アカウントまたはその子のすべての変更を検索します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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)

（省略可）設定されている場合、これらのタイプのうち少なくとも 1 つに一致するリソースの変更のみを返します。
action[]

enum (ActionType)

（省略可）設定すると、これらのアクションの 1 つ以上に一致する変更のみが返されます。
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 リソース
CUSTOM_DIMENSION CustomDimension リソース
CUSTOM_METRIC CustomMetric リソース
DATA_RETENTION_SETTINGS Data リテンション設定リソース
DATA_STREAM DataStream リソース
ATTRIBUTION_SETTINGS AttributionSettings リソース
EXPANDED_DATA_SET ExpandedDataSet リソース
CHANNEL_GROUP ChannelGroup リソース
ENHANCED_MEASUREMENT_SETTINGS EnhancedMeasurementSettings リソース
AUDIENCE オーディエンス リソース
EVENT_CREATE_RULE EventCreateRule リソース

ActionType

リソースを変更する可能性のあるアクションのタイプ。

列挙型
ACTION_TYPE_UNSPECIFIED アクション タイプが不明または指定されていません。
CREATED この変更でリソースが作成されました。
UPDATED この変更でリソースが更新されました。
DELETED この変更でリソースを削除しました。

ChangeHistory イベント

同じ原因によって発生した、Google アナリティクス アカウントまたはその子プロパティ内の一連の変更。一般的な原因は、Google アナリティクスの管理画面で行われた更新、カスタマー サポートからの変更、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 アカウントのメールアドレス。これは、actor フィールドが USER に設定されている場合は有効なメールアドレスであり、それ以外の場合は空です。削除した Google アカウントでエラーが発生します。
changesFiltered

boolean

true の場合、返された変更のリストはフィルタされ、このイベントで発生したすべての変更を表すわけではありません。
changes[]

object (ChangeHistoryChange)

SearchChangeHistoryEventsRequest で指定されたフィルタに一致する、変更履歴イベントで行われた変更のリスト。

アクターの種類

Google アナリティクス リソースを変更できるさまざまな行為者。

列挙型
ACTOR_TYPE_UNSPECIFIED 不明なアクタータイプ。
USER actorEmail で指定されたユーザーが行った変更。
SYSTEM Google アナリティクス システムによる変更。
SUPPORT Google アナリティクス サポートチームのスタッフが行った変更

変更履歴を変更

単一の Google アナリティクス リソースに対する変更の説明。

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)
  },
  "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)
  },
  "adsenseLink": {
    object (AdSenseLink)
  },
  "audience": {
    object (Audience)
  },
  "eventCreateRule": {
    object (EventCreateRule)
  }
  // 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 リソースのスナップショット。
audience

object (Audience)

変更履歴のオーディエンス リソースのスナップショット。
eventCreateRule

object (EventCreateRule)

変更履歴の EventCreateRule リソースのスナップショット。