- HTTP 请求
- 路径参数
- 请求正文
- 响应正文
- 授权范围
- ChangeHistoryResourceType
- ActionType
- ChangeHistoryEvent
- ActorType
- ChangeHistoryChange
- ChangeHistoryResource
- 试试看!
根据指定的一组过滤条件,搜索对某个帐号或其子帐号的所有更改。
HTTP 请求
POST https://analyticsadmin.googleapis.com/v1beta/{account=accounts/*}:searchChangeHistoryEvents
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
account |
必需。要为其返回更改历史记录资源的帐号资源。格式:accounts/{account}。示例:“accounts/100” |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{ "property": string, "resourceType": [ enum ( |
字段 | |
---|---|
property |
可选。子属性的资源名称。如果设置此参数,则仅返回对此属性或其子资源所做的更改。格式:properties/{propertyId} 示例:“properties/100” |
resourceType[] |
可选。如果设置了此字段,则仅当更改针对与这些类型中的至少一个匹配的资源时才返回更改。 |
action[] |
可选。如果设置此参数,则仅返回与以上一种或多种操作匹配的更改。 |
actorEmail[] |
可选。如果设置了此字段,则仅当此列表中的用户所做的更改时,才返回更改。 |
earliestChangeTime |
可选。如果设置了此字段,则仅返回在此时间(含)之后所做的更改。 采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式的时间戳,采用纳秒级精度,最多包含九个小数位。示例: |
latestChangeTime |
可选。如果设置此参数,则仅返回在此时间(含)之前所做的更改。 采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式的时间戳,采用纳秒级精度,最多包含九个小数位。示例: |
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 保留 Settings 资源 |
DISPLAY_VIDEO_360_ADVERTISER_LINK |
DisplayVideo360AdvertiserLink 资源 |
DISPLAY_VIDEO_360_ADVERTISER_LINK_PROPOSAL |
DisplayVideo360AdvertiserLinkProposal 资源 |
DATA_STREAM |
DataStream 资源 |
ATTRIBUTION_SETTINGS |
AttributionSettings 资源 |
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 世界协调时间 (UTC)(即“祖鲁时”)格式的时间戳,采用纳秒级精度,最多包含九个小数位。示例: |
actorType |
执行此更改的操作者类型。 |
userActorEmail |
进行更改的 Google 帐号的电子邮件地址。如果 actor 字段设置为 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 资源的快照。 |
conversionEvent |
更改历史记录中 ConversionEvent 资源的快照。 |
measurementProtocolSecret |
更改历史记录中 MeasurementProtocolSecret 资源的快照。 |
dataRetentionSettings |
更改历史记录中数据保留设置资源的快照。 |
dataStream |
更改历史记录中 DataStream 资源的快照。 |