Method: accounts.searchChangeHistoryEvents

Tìm kiếm tất cả các thay đổi đối với một tài khoản hoặc tài khoản con của tài khoản đó dựa trên bộ lọc được chỉ định.

Chỉ trả về tập hợp con gồm các thay đổi mà API hỗ trợ. Giao diện người dùng có thể trả về các thay đổi khác.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
account

string

Bắt buộc. Tài nguyên tài khoản để trả về tài nguyên nhật ký thay đổi. Định dạng: accounts/{account}

Ví dụ: accounts/100

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "property": string,
  "resourceType": [
    enum (ChangeHistoryResourceType)
  ],
  "action": [
    enum (ActionType)
  ],
  "actorEmail": [
    string
  ],
  "earliestChangeTime": string,
  "latestChangeTime": string,
  "pageSize": integer,
  "pageToken": string
}
Trường
property

string

Không bắt buộc. Tên tài nguyên cho một tài sản con. Nếu được đặt, chỉ trả về những thay đổi được thực hiện đối với tài sản này hoặc các tài nguyên con của tài sản. Định dạng: properties/{propertyId}

Ví dụ: properties/100
resourceType[]

enum (ChangeHistoryResourceType)

Không bắt buộc. Nếu được đặt, chỉ trả về các thay đổi nếu đó là cho một tài nguyên khớp với ít nhất một trong các loại này.
action[]

enum (ActionType)

Không bắt buộc. Nếu được đặt, chỉ trả về những thay đổi khớp với một hoặc nhiều loại hành động này.
actorEmail[]

string

Không bắt buộc. Nếu được đặt, chỉ trả về các thay đổi nếu những thay đổi đó do một người dùng trong danh sách này thực hiện.
earliestChangeTime

string (Timestamp format)

Không bắt buộc. Nếu được đặt, chỉ trả về những thay đổi được thực hiện sau thời gian này (bao gồm).

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
latestChangeTime

string (Timestamp format)

Không bắt buộc. Nếu được đặt, chỉ trả về những thay đổi được thực hiện trước thời gian này (bao gồm cả thời gian này).

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
pageSize

integer

Không bắt buộc. Số lượng tối đa các mục ChangeHistoryEvent cần trả về. Nếu không chỉ định, tối đa 50 mục sẽ được trả về. Giá trị tối đa là 200 (các giá trị cao hơn sẽ được ép buộc thành giá trị tối đa).

Xin lưu ý rằng dịch vụ có thể trả về một trang có ít mục hơn so với giá trị này (thậm chí có thể là 0) và vẫn có thể có các trang khác. Nếu muốn một số lượng mục cụ thể, bạn cần tiếp tục yêu cầu thêm các trang bằng cách sử dụng pageToken cho đến khi nhận được số lượng cần thiết.
pageToken

string

Không bắt buộc. Mã thông báo trang nhận được từ một lệnh gọi accounts.searchChangeHistoryEvents trước đó. Cung cấp thông tin này để truy xuất trang tiếp theo. Khi phân trang, tất cả các tham số khác được cung cấp cho accounts.searchChangeHistoryEvents phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

Nội dung phản hồi

Thông báo phản hồi cho RPC SearchAccounts.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "changeHistoryEvents": [
    {
      object (ChangeHistoryEvent)
    }
  ],
  "nextPageToken": string
}
Trường
changeHistoryEvents[]

object (ChangeHistoryEvent)

Kết quả mà người gọi có thể truy cập.
nextPageToken

string

Một mã thông báo có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo. Nếu bạn bỏ qua trường này, thì sẽ không có các trang tiếp theo.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/analytics.edit

ChangeHistoryResourceType

Các loại tài nguyên có thể trả về thay đổi từ nhật ký thay đổi.

Enum
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED Không xác định hoặc không chỉ định loại tài nguyên.
ACCOUNT Tài nguyên tài khoản
PROPERTY Tài nguyên cơ sở lưu trú
GOOGLE_SIGNALS_SETTINGS Tài nguyên GoogleSignalsSettings
CONVERSION_EVENT Tài nguyên ConversionEvent
MEASUREMENT_PROTOCOL_SECRET Tài nguyên MeasurementProtocolSecret
CUSTOM_DIMENSION Tài nguyên CustomDimension
CUSTOM_METRIC Tài nguyên CustomMetric
DATA_RETENTION_SETTINGS Tài nguyên DataRetentionSettings
DATA_STREAM Tài nguyên DataStream
ATTRIBUTION_SETTINGS Tài nguyên AttributionSettings
EXPANDED_DATA_SET Tài nguyên ExpandedDataSet
CHANNEL_GROUP Tài nguyên ChannelGroup
ENHANCED_MEASUREMENT_SETTINGS Tài nguyên EnhancedMeasurementSettings
DATA_REDACTION_SETTINGS Tài nguyên DataRedactionSettings
SKADNETWORK_CONVERSION_VALUE_SCHEMA Tài nguyên SKAdNetworkConversionValueSchema
AUDIENCE Tài nguyên đối tượng
EVENT_CREATE_RULE Tài nguyên EventCreateRule
KEY_EVENT Tài nguyên KeyEvent
CALCULATED_METRIC Tài nguyên CalculatedMetric
REPORTING_DATA_ANNOTATION Tài nguyên ReportingDataAnnotation
SUBPROPERTY_SYNC_CONFIG Tài nguyên SubpropertySyncConfig
REPORTING_IDENTITY_SETTINGS Tài nguyên ReportingIdentitySettings

ActionType

Các loại hành động có thể thay đổi một tài nguyên.

Enum
ACTION_TYPE_UNSPECIFIED Loại hành động không xác định hoặc chưa được chỉ định.
CREATED Tài nguyên được tạo trong thay đổi này.
UPDATED Tài nguyên đã được cập nhật trong thay đổi này.
DELETED Tài nguyên đã bị xoá trong thay đổi này.

ChangeHistoryEvent

Một nhóm thay đổi trong tài khoản Google Analytics hoặc các tài sản con của tài khoản đó do cùng một nguyên nhân gây ra. Các nguyên nhân thường gặp là nội dung cập nhật được thực hiện trong giao diện người dùng Google Analytics, các thay đổi từ nhóm hỗ trợ khách hàng hoặc các thay đổi tự động của hệ thống Google Analytics.

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "changeTime": string,
  "actorType": enum (ActorType),
  "userActorEmail": string,
  "changesFiltered": boolean,
  "changes": [
    {
      object (ChangeHistoryChange)
    }
  ]
}
Trường
id

string

Mã của sự kiện trong nhật ký thay đổi này. Mã này là duy nhất trên Google Analytics.
changeTime

string (Timestamp format)

Thời gian thực hiện thay đổi.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
actorType

enum (ActorType)

Loại đối tượng đã thực hiện thay đổi này.
userActorEmail

string

Địa chỉ email của Tài khoản Google đã thực hiện thay đổi. Đây sẽ là một địa chỉ email hợp lệ nếu trường actor được đặt thành USER, nếu không thì sẽ trống. Tài khoản Google đã bị xoá sẽ gây ra lỗi.
changesFiltered

boolean

Nếu đúng, thì danh sách các thay đổi được trả về đã được lọc và không thể hiện tất cả các thay đổi đã xảy ra trong sự kiện này.
changes[]

object (ChangeHistoryChange)

Danh sách các thay đổi được thực hiện trong sự kiện nhật ký thay đổi này, phù hợp với các bộ lọc được chỉ định trong SearchChangeHistoryEventsRequest.

ActorType

Các loại đối tượng có thể thực hiện thay đổi đối với tài nguyên Google Analytics.

Enum
ACTOR_TYPE_UNSPECIFIED Loại đối tượng không xác định hoặc chưa chỉ định.
USER Những thay đổi do người dùng được chỉ định trong actorEmail thực hiện.
SYSTEM Các thay đổi do hệ thống Google Analytics thực hiện.
SUPPORT Những thay đổi do nhân viên của nhóm hỗ trợ Google Analytics thực hiện.

ChangeHistoryChange

Nội dung mô tả về một thay đổi đối với một tài nguyên duy nhất của Google Analytics.

Biểu diễn dưới dạng JSON 
{
  "resource": string,
  "action": enum (ActionType),
  "resourceBeforeChange": {
    object (ChangeHistoryResource)
  },
  "resourceAfterChange": {
    object (ChangeHistoryResource)
  }
}
Trường
resource

string

Tên tài nguyên của tài nguyên mà nội dung thay đổi được mô tả trong mục này.
action

enum (ActionType)

Loại thao tác đã thay đổi tài nguyên này.
resourceBeforeChange

object (ChangeHistoryResource)

Nội dung tài nguyên từ trước khi thay đổi. Nếu tài nguyên này được tạo trong thay đổi này, thì trường này sẽ bị thiếu.
resourceAfterChange

object (ChangeHistoryResource)

Nội dung tài nguyên từ sau khi thay đổi. Nếu tài nguyên này bị xoá trong thay đổi này, thì trường này sẽ bị thiếu.

ChangeHistoryResource

Ảnh chụp nhanh về một tài nguyên như trước hoặc sau kết quả của một thay đổi trong nhật ký thay đổi.

Biểu diễn dưới dạng 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)
  },
  "dataRedactionSettings": {
    object (DataRedactionSettings)
  },
  "skadnetworkConversionValueSchema": {
    object (SKAdNetworkConversionValueSchema)
  },
  "adsenseLink": {
    object (AdSenseLink)
  },
  "audience": {
    object (Audience)
  },
  "eventCreateRule": {
    object (EventCreateRule)
  },
  "keyEvent": {
    object (KeyEvent)
  },
  "calculatedMetric": {
    object (CalculatedMetric)
  },
  "reportingDataAnnotation": {
    object (ReportingDataAnnotation)
  },
  "subpropertySyncConfig": {
    object (SubpropertySyncConfig)
  },
  "reportingIdentitySettings": {
    object (ReportingIdentitySettings)
  }
  // End of list of possible types for union field resource.
}
Trường

Trường nhóm resource.

resource chỉ có thể là một trong những trạng thái sau:
account

object (Account)

Ảnh chụp nhanh của một tài nguyên Tài khoản trong nhật ký thay đổi.
property

object (Property)

Ảnh chụp nhanh về một tài nguyên Tài sản trong nhật ký thay đổi.
googleSignalsSettings

object (GoogleSignalsSettings)

Ảnh chụp nhanh về một tài nguyên GoogleSignalsSettings trong nhật ký thay đổi.
conversionEvent

object (ConversionEvent)

Ảnh chụp nhanh về tài nguyên ConversionEvent trong nhật ký thay đổi.
measurementProtocolSecret

object (MeasurementProtocolSecret)

Ảnh chụp nhanh về tài nguyên MeasurementProtocolSecret trong nhật ký thay đổi.
customDimension

object (CustomDimension)

Ảnh chụp nhanh về tài nguyên CustomDimension trong nhật ký thay đổi.
customMetric

object (CustomMetric)

Ảnh chụp nhanh về tài nguyên CustomMetric trong nhật ký thay đổi.
dataRetentionSettings

object (DataRetentionSettings)

Ảnh chụp nhanh của một tài nguyên chế độ cài đặt giữ lại dữ liệu trong nhật ký thay đổi.
dataStream

object (DataStream)

Ảnh chụp nhanh về một tài nguyên DataStream trong nhật ký thay đổi.
attributionSettings

object (AttributionSettings)

Ảnh chụp nhanh tài nguyên AttributionSettings trong nhật ký thay đổi.
expandedDataSet

object (ExpandedDataSet)

Ảnh chụp nhanh về tài nguyên ExpandedDataSet trong nhật ký thay đổi.
channelGroup

object (ChannelGroup)

Ảnh chụp nhanh về tài nguyên ChannelGroup trong nhật ký thay đổi.
enhancedMeasurementSettings

object (EnhancedMeasurementSettings)

Ảnh chụp nhanh tài nguyên EnhancedMeasurementSettings trong nhật ký thay đổi.
dataRedactionSettings

object (DataRedactionSettings)

Ảnh chụp nhanh tài nguyên DataRedactionSettings trong nhật ký thay đổi.
skadnetworkConversionValueSchema

object (SKAdNetworkConversionValueSchema)

Ảnh chụp nhanh tài nguyên SKAdNetworkConversionValueSchema trong nhật ký thay đổi.
audience

object (Audience)

Ảnh chụp nhanh về một tài nguyên Đối tượng trong nhật ký thay đổi.
eventCreateRule

object (EventCreateRule)

Ảnh chụp nhanh về tài nguyên EventCreateRule trong nhật ký thay đổi.
keyEvent

object (KeyEvent)

Ảnh chụp nhanh tài nguyên KeyEvent trong nhật ký thay đổi.
calculatedMetric

object (CalculatedMetric)

Ảnh chụp nhanh về tài nguyên CalculatedMetric trong nhật ký thay đổi.
reportingDataAnnotation

object (ReportingDataAnnotation)

Ảnh chụp nhanh về tài nguyên ReportingDataAnnotation trong nhật ký thay đổi.
subpropertySyncConfig

object (SubpropertySyncConfig)

Ảnh chụp nhanh về tài nguyên SubpropertySyncConfig trong nhật ký thay đổi.
reportingIdentitySettings

object (ReportingIdentitySettings)

Ảnh chụp nhanh về tài nguyên ReportingIdentitySettings trong nhật ký thay đổi.