- Yêu cầu HTTP
- Thông 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 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 |
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 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[] |
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[] |
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[] |
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 |
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ụ: |
latestChangeTime |
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ụ: |
pageSize |
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 |
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 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 ( |
Trường | |
---|---|
changeHistoryEvents[] |
Kết quả mà phương thức gọi có thể truy cập. |
nextPageToken |
Mã thông báo 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 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 |
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 Measurement ProtocolSecret |
DATA_RETENTION_SETTINGS |
Tài nguyên DataKeepSettings |
DISPLAY_VIDEO_360_ADVERTISER_LINK |
Tài nguyên DisplayVideo360AdvertiserLink |
DISPLAY_VIDEO_360_ADVERTISER_LINK_PROPOSAL |
Tài nguyên DisplayVideo360AdvertiserLinkProposal |
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 ( |
Trường | |
---|---|
id |
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 |
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ụ: |
actorType |
Loại thực thể đã 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 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 |
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[] |
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 ( |
Trường | |
---|---|
resource |
Tên tài nguyên của tài nguyên có thay đổi được mô tả trong mục này. |
action |
Loại tác vụ đã thay đổi tài nguyên này. |
resourceBeforeChange |
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 |
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 |
Trường | |
---|---|
Trường hợp hợp nhất
|
|
account |
Bản tổng quan nhanh về 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 |
Bản tổng quan nhanh về tài nguyên FirebaseLink trong nhật ký thay đổi. |
googleAdsLink |
Bản tổng quan nhanh về tài nguyên GoogleAdsLink trong nhật ký thay đổi. |
conversionEvent |
Ảnh chụp nhanh về tài nguyên ConversionEvent trong lịch sử thay đổi. |
measurementProtocolSecret |
Thông tin tổng quan nhanh về tài nguyên MeasurementProtocolSecret trong nhật ký thay đổi. |
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 |
Bản tổng quan nhanh về tài nguyên DataStream trong nhật ký thay đổi. |