- 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
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 リソース |
DATA_RETENTION_SETTINGS |
Data リテンション設定リソース |
DISPLAY_VIDEO_360_ADVERTISER_LINK |
DisplayVideo360ProviderLink リソース |
DISPLAY_VIDEO_360_ADVERTISER_LINK_PROPOSAL |
DisplayVideo360ProviderLinkProposal リソース |
DATA_STREAM |
DataStream リソース |
ATTRIBUTION_SETTINGS |
AttributionSettings リソース |
ActionType
リソースを変更する可能性のあるアクションのタイプ。
列挙型 | |
---|---|
ACTION_TYPE_UNSPECIFIED |
アクション タイプが不明または指定されていません。 |
CREATED |
この変更でリソースが作成されました。 |
UPDATED |
この変更でリソースが更新されました。 |
DELETED |
この変更でリソースを削除しました。 |
ChangeHistory イベント
同じ原因によって発生した、Google アナリティクス アカウントまたはその子プロパティ内の一連の変更。一般的な原因は、Google アナリティクスの管理画面で行われた更新、カスタマー サポートからの変更、Google アナリティクスのシステムの自動変更などです。
JSON 表現 |
---|
{ "id": string, "changeTime": string, "actorType": enum ( |
フィールド | |
---|---|
id |
この変更履歴イベントの ID。この ID は Google アナリティクス全体で一意です。 |
changeTime |
変更が行われた時刻。 RFC3339 UTC「Zulu」形式のタイムスタンプ。ナノ秒の解像度で小数点以下 9 桁まで指定できます。例: |
actorType |
この変更を行ったアクターのタイプ。 |
userActorEmail |
変更を行った Google アカウントのメールアドレス。これは、actor フィールドが USER に設定されている場合は有効なメールアドレスであり、それ以外の場合は空です。削除した Google アカウントでエラーが発生します。 |
changesFiltered |
true の場合、返された変更のリストはフィルタされ、このイベントで発生したすべての変更を表すわけではありません。 |
changes[] |
SearchChangeHistoryEventsRequest で指定されたフィルタに一致する、変更履歴イベントで行われた変更のリスト。 |
アクターの種類
Google アナリティクス リソースを変更できるさまざまな行為者。
列挙型 | |
---|---|
ACTOR_TYPE_UNSPECIFIED |
不明なアクタータイプ。 |
USER |
actorEmail で指定されたユーザーが行った変更。 |
SYSTEM |
Google アナリティクス システムによる変更。 |
SUPPORT |
Google アナリティクス サポートチームのスタッフが行った変更 |
変更履歴を変更
単一の Google アナリティクス リソースに対する変更の説明。
JSON 表現 |
---|
{ "resource": string, "action": enum ( |
フィールド | |
---|---|
resource |
このエントリによって変更が記録されているリソースのリソース名。 |
action |
このリソースを変更したアクションのタイプ。 |
resourceBeforeChange |
変更前のリソースの内容。このリソースがこの変更で作成された場合、このフィールドは欠落します。 |
resourceAfterChange |
変更後のリソース コンテンツ。このリソースがこの変更によって削除された場合、このフィールドは表示されません。 |
変更履歴の履歴
変更履歴の変更前または変更後のリソースのスナップショット。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド
|
|
account |
変更履歴内のアカウント リソースのスナップショット。 |
property |
変更履歴のプロパティ リソースのスナップショット。 |
firebaseLink |
変更履歴内の FirebaseLink リソースのスナップショット。 |
googleAdsLink |
変更履歴における GoogleAdsLink リソースのスナップショット。 |
conversionEvent |
変更履歴での ConversionEvent リソースのスナップショット。 |
measurementProtocolSecret |
変更履歴内の MeasurementProtocolSecret リソース。 |
dataRetentionSettings |
変更履歴のデータ保持設定リソースのスナップショット。 |
dataStream |
変更履歴内の DataStream リソースのスナップショット。 |