Method: accounts.searchChangeHistoryEvents

Menelusuri semua perubahan pada akun atau turunannya berdasarkan kumpulan filter yang ditentukan.

Permintaan HTTP

POST https://analyticsadmin.googleapis.com/v1alpha/{account=accounts/*}:searchChangeHistoryEvents

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
account

string

Wajib diisi. Resource akun yang akan ditampilkan resource histori perubahannya.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "property": string,
  "resourceType": [
    enum (ChangeHistoryResourceType)
  ],
  "action": [
    enum (ActionType)
  ],
  "actorEmail": [
    string
  ],
  "earliestChangeTime": string,
  "latestChangeTime": string,
  "pageSize": integer,
  "pageToken": string
}
Kolom
property

string

Opsional. Nama resource untuk properti turunan. Jika ditetapkan, hanya tampilkan perubahan yang dibuat pada properti ini atau resource turunannya.

resourceType[]

enum (ChangeHistoryResourceType)

Opsional. Jika ditetapkan, hanya tampilkan perubahan jika ditujukan untuk resource yang cocok dengan setidaknya salah satu jenis ini.

action[]

enum (ActionType)

Opsional. Jika ditetapkan, hanya tampilkan perubahan yang cocok dengan satu atau beberapa jenis tindakan ini.

actorEmail[]

string

Opsional. Jika ditetapkan, hanya tampilkan perubahan yang dibuat oleh pengguna dalam daftar ini.

earliestChangeTime

string (Timestamp format)

Opsional. Jika ditetapkan, hanya tampilkan perubahan yang dilakukan setelah jangka waktu tersebut (inklusif).

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

latestChangeTime

string (Timestamp format)

Opsional. Jika ditetapkan, hanya tampilkan perubahan yang dibuat sebelum waktu tersebut (inklusif).

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

pageSize

integer

Opsional. Jumlah maksimum item ChangeHistoryEvent yang akan ditampilkan. Layanan dapat menampilkan lebih sedikit dari nilai ini, meskipun ada halaman tambahan. Jika tidak ditentukan, maksimal 50 item akan ditampilkan. Nilai maksimum adalah 200 (nilai yang lebih tinggi akan dikonversi ke nilai maksimum).

pageToken

string

Opsional. Token halaman, diterima dari panggilan accounts.searchChangeHistoryEvents sebelumnya. Berikan ini untuk mengambil halaman berikutnya. Saat penomoran halaman, semua parameter lain yang diberikan ke accounts.searchChangeHistoryEvents harus cocok dengan panggilan yang memberikan token halaman.

Isi respons

Pesan respons untuk RPC SearchAccounts.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "changeHistoryEvents": [
    {
      object (ChangeHistoryEvent)
    }
  ],
  "nextPageToken": string
}
Kolom
changeHistoryEvents[]

object (ChangeHistoryEvent)

Hasil yang dapat diakses oleh pemanggil.

nextPageToken

string

Token, yang dapat dikirim sebagai pageToken untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak ada halaman berikutnya.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/analytics.edit

ChangeHistoryResourceType

Jenis resource yang perubahannya dapat ditampilkan dari histori perubahan.

Enumerasi
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED Jenis resource tidak diketahui atau tidak ditentukan.
ACCOUNT Resource akun
PROPERTY Resource properti
GOOGLE_SIGNALS_SETTINGS Resource GoogleSignalsSettings
CONVERSION_EVENT Resource ConversionEvent
MEASUREMENT_PROTOCOL_SECRET Resource MeasurementProtocolSecret
CUSTOM_DIMENSION Resource CustomDimension
CUSTOM_METRIC Resource CustomMetric
DATA_RETENTION_SETTINGS Resource DataRetentionSettings
DATA_STREAM Resource DataStream
ATTRIBUTION_SETTINGS Resource AttributionSettings
EXPANDED_DATA_SET Resource PerluasedDataSet
CHANNEL_GROUP Resource ChannelGroup
ENHANCED_MEASUREMENT_SETTINGS Resource EnhancedMeasurementSettings
AUDIENCE Resource audiens
EVENT_CREATE_RULE Resource EventCreateRule

JenisTindakan

Jenis tindakan yang dapat mengubah resource.

Enumerasi
ACTION_TYPE_UNSPECIFIED Jenis tindakan tidak diketahui atau tidak ditentukan.
CREATED Sumber daya dibuat dalam perubahan ini.
UPDATED Fasilitas telah diperbarui dalam perubahan ini.
DELETED Sumber daya telah dihapus dalam perubahan ini.

ChangeHistoryEvent

Kumpulan perubahan dalam akun Google Analytics atau properti turunannya yang dihasilkan dari penyebab yang sama. Penyebab umum adalah update yang dilakukan di UI Google Analytics, perubahan dari dukungan pelanggan, atau perubahan sistem Google Analytics otomatis.

Representasi JSON
{
  "id": string,
  "changeTime": string,
  "actorType": enum (ActorType),
  "userActorEmail": string,
  "changesFiltered": boolean,
  "changes": [
    {
      object (ChangeHistoryChange)
    }
  ]
}
Kolom
id

string

ID peristiwa histori perubahan ini. ID ini unik di Google Analytics.

changeTime

string (Timestamp format)

Waktu saat perubahan dilakukan.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

actorType

enum (ActorType)

Jenis aktor yang membuat perubahan ini.

userActorEmail

string

Alamat email Akun Google yang melakukan perubahan. Ini akan menjadi alamat email yang valid jika kolom aktor disetel ke USER, dan kosong. Akun Google yang telah dihapus akan menyebabkan error.

changesFiltered

boolean

Jika benar, daftar perubahan yang ditampilkan difilter, dan tidak mewakili semua perubahan yang terjadi dalam peristiwa ini.

changes[]

object (ChangeHistoryChange)

Daftar perubahan yang dilakukan dalam peristiwa histori perubahan ini sesuai dengan filter yang ditentukan di SearchChangeHistoryEventsRequest.

Jenis Pelaku

Berbagai jenis aktor yang dapat membuat perubahan pada resource Google Analytics.

Enumerasi
ACTOR_TYPE_UNSPECIFIED Jenis aktor tidak diketahui atau tidak ditentukan.
USER Perubahan yang dibuat oleh pengguna yang ditentukan di actorEmail.
SYSTEM Perubahan yang dibuat oleh sistem Google Analytics.
SUPPORT Perubahan yang dibuat oleh staf tim dukungan Google Analytics.

PerubahanHistoriPerubahan

Deskripsi perubahan pada satu resource Google Analytics.

Representasi JSON
{
  "resource": string,
  "action": enum (ActionType),
  "resourceBeforeChange": {
    object (ChangeHistoryResource)
  },
  "resourceAfterChange": {
    object (ChangeHistoryResource)
  }
}
Kolom
resource

string

Nama resource dari resource yang perubahannya dijelaskan oleh entri ini.

action

enum (ActionType)

Jenis tindakan yang mengubah resource ini.

resourceBeforeChange

object (ChangeHistoryResource)

Konten referensi sebelum perubahan dibuat. Jika resource ini dibuat dalam perubahan ini, kolom ini tidak akan ada.

resourceAfterChange

object (ChangeHistoryResource)

Konten resource sejak perubahan dibuat. Jika resource ini dihapus dalam perubahan ini, kolom ini tidak akan ada.

Sumber DayaHistoriPerubahan

Ringkasan resource seperti sebelum atau setelah hasil perubahan dalam histori perubahan.

Representasi JSON
{

  // Union field resource can be only one of the following:
  "account": {
    object (Account)
  },
  "property": {
    object (Property)
  },
  "firebaseLink": {
    object (FirebaseLink)
  },
  "googleAdsLink": {
    object (GoogleAdsLink)
  },
  "googleSignalsSettings": {
    object (GoogleSignalsSettings)
  },
  "displayVideo360AdvertiserLink": {
    object (DisplayVideo360AdvertiserLink)
  },
  "displayVideo360AdvertiserLinkProposal": {
    object (DisplayVideo360AdvertiserLinkProposal)
  },
  "conversionEvent": {
    object (ConversionEvent)
  },
  "measurementProtocolSecret": {
    object (MeasurementProtocolSecret)
  },
  "customDimension": {
    object (CustomDimension)
  },
  "customMetric": {
    object (CustomMetric)
  },
  "dataRetentionSettings": {
    object (DataRetentionSettings)
  },
  "searchAds360Link": {
    object (SearchAds360Link)
  },
  "dataStream": {
    object (DataStream)
  },
  "attributionSettings": {
    object (AttributionSettings)
  },
  "expandedDataSet": {
    object (ExpandedDataSet)
  },
  "channelGroup": {
    object (ChannelGroup)
  },
  "bigqueryLink": {
    object (BigQueryLink)
  },
  "enhancedMeasurementSettings": {
    object (EnhancedMeasurementSettings)
  },
  "adsenseLink": {
    object (AdSenseLink)
  },
  "audience": {
    object (Audience)
  },
  "eventCreateRule": {
    object (EventCreateRule)
  }
  // End of list of possible types for union field resource.
}
Kolom

Kolom union resource.

resource hanya dapat berupa salah satu dari berikut:

account

object (Account)

Ringkasan resource Akun dalam histori perubahan.

property

object (Property)

Ringkasan resource Properti dalam histori perubahan.

googleSignalsSettings

object (GoogleSignalsSettings)

Ringkasan resource GoogleSignalsSettings di histori perubahan.

conversionEvent

object (ConversionEvent)

Ringkasan resource ConversionEvent dalam histori perubahan.

measurementProtocolSecret

object (MeasurementProtocolSecret)

Ringkasan resource MeasurementProtocolSecret di histori perubahan.

customDimension

object (CustomDimension)

Ringkasan resource CustomDimension dalam histori perubahan.

customMetric

object (CustomMetric)

Ringkasan resource CustomMetric dalam histori perubahan.

dataRetentionSettings

object (DataRetentionSettings)

Ringkasan resource setelan retensi data di histori perubahan.

dataStream

object (DataStream)

Ringkasan resource DataStream dalam histori perubahan.

attributionSettings

object (AttributionSettings)

Ringkasan resource AttributionSettings di histori perubahan.

expandedDataSet

object (ExpandedDataSet)

Ringkasan resource PerluasanDataSet di histori perubahan.

channelGroup

object (ChannelGroup)

Ringkasan resource ChannelGroup dalam histori perubahan.

enhancedMeasurementSettings

object (EnhancedMeasurementSettings)

Ringkasan resource EnhancedMeasurementSettings di histori perubahan.

audience

object (Audience)

Ringkasan resource Audiens dalam histori perubahan.

eventCreateRule

object (EventCreateRule)

Ringkasan resource EventCreateRule dalam histori perubahan.