Method: accounts.searchChangeHistoryEvents

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

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

Tham 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ề các thay đổi được thực hiện cho thuộc tính này hoặc các tài nguyên con của thuộc tính. Định dạng: thuộc tính/{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 đó dành cho 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ề các thay đổi phù hợ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 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ề các thay đổi được thực hiện sau thời gian này (bao gồm).

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
latestChangeTime

string (Timestamp format)

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

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
pageSize

integer

Không bắt buộc. Số lượng mục InsertEvent tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này, ngay cả khi có các trang bổ sung. Nếu bạn không chỉ định, tối đa 50 mặt hàng sẽ bị trả lại. 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).
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 URL 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à phương thức gọi có thể truy cập.
nextPageToken

string

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

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 mà các thay đổi có thể được trả về từ lịch sử thay đổi.

Enum
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED Loại tài nguyên không xác định hoặc chưa được chỉ định.
ACCOUNT Tài nguyên của tài khoản
PROPERTY Tài nguyên về tài sản
GOOGLE_SIGNALS_SETTINGS Tài nguyên GoogleSignalsSettings
CONVERSION_EVENT Tài nguyên ConversionEvent
MEASUREMENT_PROTOCOL_SECRET Tài nguyên MeasurementProtocolSecret
DATA_RETENTION_SETTINGS Tài nguyên Chế độ giữ lại dữ liệu
DATA_STREAM Tài nguyên DataStream
ATTRIBUTION_SETTINGS Tài nguyên Cài đặt phân bổ

ActionType

Các loại thao tác 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 tập hợp các 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. Nguyên nhân thường gặp là do cập nhật được thực hiện trong giao diện người dùng Google Analytics, các thay đổi từ dịch vụ 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 nhật ký thay đổi này. Đây là mã nhận dạng duy nhất trên Google Analytics.
changeTime

string (Timestamp format)

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

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
actorType

enum (ActorType)

Kiểu người thực hiện đã 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 là USER và để trống nếu không. Nhữ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 lịch sử thay đổi này phù hợp với các bộ lọc được chỉ định trong SearchEventsRequest.

ActorType

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

Enum
ACTOR_TYPE_UNSPECIFIED Loại diễn viên không xác định hoặc không xác định.
USER Các 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 Các thay đổi do nhân viên nhóm hỗ trợ Google Analytics thực hiện.

ChangeHistoryChange

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ó các thay đổi được mô tả bằng mục nhập này.
action

enum (ActionType)

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

object (ChangeHistoryResource)

Nội dung tài nguyên trước khi có 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 thực hiện 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

Thông tin tổng quan nhanh về một tài nguyên như trước hoặc sau khi xảy ra 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 resource.

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

object (Account)

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

object (Property)

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

object (ConversionEvent)

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

object (MeasurementProtocolSecret)

Tổng quan nhanh về tài nguyên MeasurementprotocolSecret trong nhật ký thay đổi.
dataRetentionSettings

object (DataRetentionSettings)

Thông tin 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)

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