Method: accounts.searchChangeHistoryEvents

Tìm kiếm trong 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 đó dựa vào tập hợp các 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 của thuộc tính 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 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 chúng là dành cho tài nguyên phù hợ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 trong số này.

actorEmail[]

string

Không bắt buộc. Nếu được đặt, chỉ trả về các thay đổi nếu 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ề các thay đổi được thực hiện sau khoảng thời gian này (bao gồm).

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""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 điểm này (bao gồm).

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

pageSize

integer

Không bắt buộc. Số lượng tối đa các mục #{Event cần trả lại. Dịch vụ có thể trả về ít hơn giá trị này, ngay cả khi vẫn còn các trang khác. Nếu bạn không xác định, sẽ trả lại tối đa 50 mặt hàng. Giá trị tối đa là 200 (các giá trị cao hơn sẽ bị ép buộc lên 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 mã 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 trường này bị bỏ qua 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

Loại tài nguyên 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 tài khoản
PROPERTY Tài nguyên tài sản
GOOGLE_SIGNALS_SETTINGS Tài nguyên về GoogleSignalsSettings
CONVERSION_EVENT Tài nguyên ConversionEvent
MEASUREMENT_PROTOCOL_SECRET Tài nguyên Measurement ProtocolSecret
DATA_RETENTION_SETTINGS Tài nguyên DataKeepSettings
DATA_STREAM Tài nguyên DataStream
ATTRIBUTION_SETTINGS Tài nguyên AttributionSettings

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 nhóm các thay đổi trong một 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. Các nguyên nhân phổ biến là do nội dung cập nhật 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 theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

actorType

enum (ActorType)

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

ActorType

Các kiểu đố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 đối tượng 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 trong nhóm hỗ trợ Google Analytics thực hiện.

ChangeHistoryChange

Mô tả về 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ả trong mục này.

action

enum (ActionType)

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

resourceBeforeChange

object (ChangeHistoryResource)

Nội dung tài nguyên trước khi thực hiện 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, trường này sẽ bị thiếu.

ChangeHistoryResource

Ảnh chụp nhanh về một tài nguyên ở trước hoặc sau khi thay đổi trong lịch sử 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 kết hợp resource.

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

account

object (Account)

Ảnh chụp nhanh của 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)

Ảnh chụp nhanh về tài nguyên ConversionEvent trong lịch sử thay đổi.

measurementProtocolSecret

object (MeasurementProtocolSecret)

Ảnh chụp 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 của các 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.