Method: accounts.searchChangeHistoryEvents

Tìm kiếm thông qua tất cả thay đổi đối với một tài khoản hoặc các tài khoản con của tài khoản đó theo bộ lọc đã chỉ định.

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

Yêu cầu HTTP

POST https://analyticsadmin.googleapis.com/v1beta/{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 thuộc tính 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 tài nguyên con của tài sản này. Đị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 các thay đổi đó là dành 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 do 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 điểm này (bao gồm cả thời điểm này).

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác "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 điểm này (bao gồm cả thời điểm này).

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác "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 mục ChangeHistoryEvent tối đa cần trả về. Nếu không chỉ định, hệ thống sẽ trả về tối đa 50 mục. Giá trị tối đa là 200 (các giá trị cao hơn sẽ được ép 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 giá trị này chỉ định (thậm chí có thể là 0) và vẫn có thể có các trang khác. Nếu muốn có một số lượng mặt hàng cụ thể, bạn cần tiếp tục yêu cầu các trang bổ sung bằng pageToken cho đến khi có đượ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ừ lệnh gọi accounts.searchChangeHistoryEvents trước đó. Cung cấp giá trị 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 SearchAccounts RPC.

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à phương thức gọi có thể truy cập.
nextPageToken

string

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ó 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 Loại tài nguyên không xác định hoặc không được chỉ định.
ACCOUNT Tài nguyên tài khoản
PROPERTY Tài nguyên thuộc tính
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

ActionType

Các loại hành động có thể thay đổi 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 đó, xuất phát từ cùng một nguyên nhân. Các nguyên nhân phổ biến là nội dung cập nhật trong giao diện người dùng Google Analytics, thay đổi do nhóm hỗ trợ khách hàng thực hiện hoặc thay đổi tự động trong 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 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 Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác "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 thực thể đã 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à địa chỉ email hợp lệ nếu trường diễn viên được đặt thành USER (NGƯỜI DÙNG) và trống nếu không. Tài khoản Google đã bị xoá sẽ gây ra lỗi.
changesFiltered

boolean

Nếu đúng, thì danh sách thay đổi được trả về đã được lọc và không đại diện cho tất 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ể thay đổ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 Thay đổi do người dùng thực hiện được chỉ định trong actorEmail.
SYSTEM Các thay đổi do hệ thống Google Analytics thực hiện.
SUPPORT Các thay đổi do nhân viên 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 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 có thay đổi được mô tả trong mục này.
action

enum (ActionType)

Loại hành động đã thay đổi tài nguyên này.
resourceBeforeChange

object (ChangeHistoryResource)

Nội dung tài nguyên 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 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

Bản tổng quan nhanh về một tài nguyên trước hoặc sau khi 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)
  },
  "conversionEvent": {
    object (ConversionEvent)
  },
  "measurementProtocolSecret": {
    object (MeasurementProtocolSecret)
  },
  "dataRetentionSettings": {
    object (DataRetentionSettings)
  },
  "dataStream": {
    object (DataStream)
  }
  // End of list of possible types for union field resource.
}
Trường

Trường hợp hợp nhất resource.

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

object (Account)

Bản tổng quan nhanh về tài nguyên Tài khoản trong nhật ký thay đổi.
property

object (Property)

Bản tổng quan nhanh về tài nguyên Tài sản trong nhật ký thay đổi.
conversionEvent

object (ConversionEvent)

Bản tổng quan nhanh về tài nguyên ConversionEvent trong nhật ký thay đổi.
measurementProtocolSecret

object (MeasurementProtocolSecret)

Ảnh chụp nhanh của tài nguyên MeasurementProtocolSecret trong nhật ký thay đổi.
dataRetentionSettings

object (DataRetentionSettings)

Bản tổng quan nhanh về tài nguyên chế độ cài đặt giữ lại dữ liệu trong nhật ký thay đổi.
dataStream

object (DataStream)

Bản tổng quan nhanh về tài nguyên DataStream trong nhật ký thay đổi.