- Yêu cầu HTTP
- Tham số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- ChangeHistoryResourceType
- ActionType
- ChangeHistoryEvent
- ActorType
- ChangeHistoryChange
- ChangeHistoryResource
- Hãy làm thử!
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 |
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 ( |
Trường | |
---|---|
property |
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[] |
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[] |
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[] |
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 |
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ụ: |
latestChangeTime |
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ụ: |
pageSize |
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 |
Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi |
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 ( |
Trường | |
---|---|
changeHistoryEvents[] |
Kết quả mà phương thức gọi có thể truy cập. |
nextPageToken |
Mã thông báo này có thể được gửi dưới dạng |
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 |
FIREBASE_LINK |
Tài nguyên FirebaseLink |
GOOGLE_ADS_LINK |
Tài nguyên GoogleAdsLink |
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 |
DISPLAY_VIDEO_360_ADVERTISER_LINK |
Tài nguyên DisplayVideo360AdvertiserLink |
DISPLAY_VIDEO_360_ADVERTISER_LINK_PROPOSAL |
Tài nguyên DisplayVideo360AdvertiserLinkĐề xuất |
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 ( |
Trường | |
---|---|
id |
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 |
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ụ: |
actorType |
Kiểu người thực hiện đã thực hiện thay đổi này. |
userActorEmail |
Đị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 |
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[] |
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 ( |
Trường | |
---|---|
resource |
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 |
Loại hành động đã làm thay đổi tài nguyên này. |
resourceBeforeChange |
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 |
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 |
Trường | |
---|---|
Trường hợp
|
|
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 |
Thông tin tổng quan nhanh về tài nguyên Tài sản trong nhật ký thay đổi. |
firebaseLink |
Ảnh chụp nhanh tài nguyên FirebaseLink trong nhật ký thay đổi. |
googleAdsLink |
Ảnh chụp nhanh tài nguyên GoogleAdsLink trong nhật ký thay đổi. |
conversionEvent |
Thông tin tổng quan nhanh về tài nguyên ConversionEvent trong nhật ký thay đổi. |
measurementProtocolSecret |
Tổng quan nhanh về tài nguyên MeasurementprotocolSecret trong nhật ký thay đổi. |
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 |
Thông tin tổng quan nhanh về tài nguyên DataStream trong nhật ký thay đổi. |