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.

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 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: 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 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ề 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).

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""2014-10-02T15:01:23.045123456Z".

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).

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

pageSize

integer

Không bắt buộc. Số lượng mục ChangeHistoryEvent 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 khác. 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).

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 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

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 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 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à 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. Mã này là duy nhất trên Google Analytics.

changeTime

string (Timestamp format)

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

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

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 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 tác nhân 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 Những 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 Nội dung thay đổi do nhân viên 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ó 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 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, 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 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)
  },
  "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)

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)

Thông tin tổng quan nhanh về 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.