- HTTP リクエスト
- パスパラメータ
- リクエストの本文
- レスポンスの本文
- 承認スコープ
- ChangeHistoryResourceType
- アクション タイプ
- ChangeHistoryEvent
- アクタータイプ
- ChangeHistoryChange
- ChangeHistoryResource
- 試してみる
指定したフィルタセットでアカウントまたは子に対する変更をすべて検索します。
HTTP リクエスト
POST https://analyticsadmin.googleapis.com/v1beta/{account=accounts/*}:searchChangeHistoryEvents
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
account |
必須。変更履歴リソースを返すアカウント リソース。 |
リクエスト本文
リクエストの本文には次の構造のデータが含まれます。
JSON 表現 |
---|
{ "property": string, "resourceType": [ enum ( |
フィールド | |
---|---|
property |
(省略可)子プロパティのリソース名。設定されている場合、このプロパティまたは子リソースに対する変更のみが返されます。 |
resourceType[] |
(省略可)設定すると、これらのタイプのうち少なくとも 1 つに一致するリソースに対してのみ変更が返されます。 |
action[] |
(省略可)設定した場合、これらの 1 つ以上の操作に一致する変更のみが返されます。 |
actorEmail[] |
(省略可)設定されている場合、このリストのユーザーが行った変更のみを返します。 |
earliestChangeTime |
(省略可)設定すると、この時間以降に行われた変更のみが返されます。 RFC3339 UTC「Zulu」形式のタイムスタンプ。解像度はナノ秒で、小数点以下 9 桁まで指定できます。(例: |
latestChangeTime |
(省略可)設定すると、この時間より前に行われた変更のみが返されます。 RFC3339 UTC「Zulu」形式のタイムスタンプ。解像度はナノ秒で、小数点以下 9 桁まで指定できます。(例: |
pageSize |
(省略可)返される ChangeHistoryEvent アイテムの最大数。追加のページがある場合でも、サービスがこの値より小さい値を返すことがあります。指定しない場合は、最大 50 個のアイテムが返されます。最大値は 200 です(値が大きいほど最大値に強制変換されます)。 |
pageToken |
(省略可)前回の |
レスポンスの本文
成功すると、レスポンスの本文に次の構造のデータが含まれます。
SearchAccounts RPC のレスポンス メッセージ。
JSON 表現 |
---|
{
"changeHistoryEvents": [
{
object ( |
フィールド | |
---|---|
changeHistoryEvents[] |
呼び出し元がアクセスできる結果。 |
nextPageToken |
次のページを取得するために |
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/analytics.edit
変更履歴のリソースタイプ
変更履歴から変更が返される可能性があるリソースのタイプ。
列挙型 | |
---|---|
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 リソース |
DATA_RETENTION_SETTINGS |
Data リテール設定リソース |
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 リソース |
ActionType
リソースを変更する可能性のあるアクションのタイプ。
列挙型 | |
---|---|
ACTION_TYPE_UNSPECIFIED |
アクション タイプが不明または指定されていません。 |
CREATED |
この変更でリソースが作成されました。 |
UPDATED |
この変更でリソースが更新されました。 |
DELETED |
この変更でリソースが削除されました。 |
ChangeHistoryEvent
同じ原因による、Google アナリティクス アカウントまたは子プロパティ内の一連の変更。一般的な原因は、Google アナリティクスの UI の更新、カスタマー サポートの変更、Google アナリティクスの自動システム変更などです。
JSON 表現 |
---|
{ "id": string, "changeTime": string, "actorType": enum ( |
フィールド | |
---|---|
id |
この変更履歴イベントの ID。この ID は Google アナリティクス全体で一意です。 |
changeTime |
変更が加えられた時刻。 RFC3339 UTC「Zulu」形式のタイムスタンプ。解像度はナノ秒で、小数点以下 9 桁まで指定できます。(例: |
actorType |
この変更を行ったアクターのタイプ。 |
userActorEmail |
変更を行った Google アカウントのメールアドレス。アクター フィールドが USER に設定されている場合は有効なメールアドレスになり、それ以外の場合は空になります。削除された Google アカウントでエラーが発生します。 |
changesFiltered |
true の場合、返された変更のリストはフィルタされ、このイベントで発生したすべての変更を表すわけではありません。 |
changes[] |
SearchChangeHistoryEventsRequest で指定されたフィルタに一致する、変更履歴イベントで行われた変更のリスト。 |
アクタータイプ
Google アナリティクスのリソースを変更するアクターは多様です。
列挙型 | |
---|---|
ACTOR_TYPE_UNSPECIFIED |
アクタータイプが不明または指定されていません。 |
USER |
actorEmail で指定されたユーザーが行った変更。 |
SYSTEM |
Google アナリティクス システムによる変更。 |
SUPPORT |
Google アナリティクス サポートチームのスタッフによって行われた変更。 |
変更履歴を変更
1 つの Google アナリティクス リソースに対する変更の説明。
JSON 表現 |
---|
{ "resource": string, "action": enum ( |
フィールド | |
---|---|
resource |
このエントリで変更を記述するリソースのリソース名。 |
action |
このリソースが変更されたアクションのタイプ。 |
resourceBeforeChange |
変更前のリソースの内容。このリソースがこの変更で作成された場合、このフィールドは欠落します。 |
resourceAfterChange |
変更後のリソース コンテンツ。このリソースがこの変更で削除された場合、このフィールドはなくなります。 |
変更履歴リソース
変更履歴の変更前または変更後のリソースのスナップショット。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド
|
|
account |
変更履歴内のアカウント リソースのスナップショット。 |
property |
変更履歴内の Property リソースのスナップショット。 |
firebaseLink |
変更履歴内の FirebaseLink リソースのスナップショット。 |
googleAdsLink |
変更履歴内の GoogleAdsLink リソースのスナップショット。 |
conversionEvent |
変更履歴内の ConversionEvent リソースのスナップショット。 |
measurementProtocolSecret |
変更履歴内の MeasurementProtocolSecret リソースのスナップショット。 |
dataRetentionSettings |
変更履歴のデータ保持設定リソースのスナップショット。 |
dataStream |
変更履歴内の DataStream リソースのスナップショット。 |