Method: accounts.searchChangeHistoryEvents

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

Hanya menampilkan subkumpulan perubahan yang didukung oleh API. UI dapat menampilkan perubahan tambahan.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
account

string

Wajib. Resource akun yang histori perubahannya akan ditampilkan. Format: accounts/{account}

Contoh: accounts/100

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 disetel, hanya menampilkan perubahan yang dilakukan pada properti ini atau resource turunannya. Format: properties/{propertyId}

Contoh: properties/100
resourceType[]

enum (ChangeHistoryResourceType)

Opsional. Jika ditetapkan, hanya menampilkan perubahan jika perubahan tersebut ditujukan untuk resource yang cocok dengan setidaknya salah satu jenis ini.
action[]

enum (ActionType)

Opsional. Jika disetel, hanya menampilkan perubahan yang cocok dengan satu atau beberapa jenis tindakan ini.
actorEmail[]

string

Opsional. Jika disetel, hanya kembalikan perubahan jika dilakukan oleh pengguna dalam daftar ini.
earliestChangeTime

string (Timestamp format)

Opsional. Jika disetel, hanya menampilkan perubahan yang dilakukan setelah waktu ini (inklusif).

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
latestChangeTime

string (Timestamp format)

Opsional. Jika disetel, hanya menampilkan perubahan yang dilakukan sebelum waktu ini (inklusif).

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
pageSize

integer

Opsional. Jumlah maksimum item ChangeHistoryEvent yang akan ditampilkan. Jika tidak ditentukan, paling banyak 50 item akan ditampilkan. Nilai maksimum adalah 200 (nilai yang lebih tinggi akan dikonversi menjadi nilai maksimum).

Perhatikan bahwa layanan dapat menampilkan halaman dengan item yang lebih sedikit dari yang ditentukan oleh nilai ini (bahkan berpotensi nol), dan masih ada halaman tambahan. Jika Anda menginginkan jumlah item tertentu, Anda harus terus meminta halaman tambahan menggunakan pageToken hingga mendapatkan jumlah yang diperlukan.
pageToken

string

Opsional. Token halaman, diterima dari panggilan accounts.searchChangeHistoryEvents sebelumnya. Berikan ini untuk mengambil halaman selanjutnya. Saat melakukan penomoran halaman, semua parameter lain yang diberikan untuk accounts.searchChangeHistoryEvents harus sesuai dengan panggilan yang menyediakan 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 akan ada halaman berikutnya.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

ChangeHistoryResourceType

Jenis resource yang perubahannya dapat ditampilkan dari histori perubahan.

Enum
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 ExpandedDataSet
CHANNEL_GROUP Resource ChannelGroup
ENHANCED_MEASUREMENT_SETTINGS Resource EnhancedMeasurementSettings
DATA_REDACTION_SETTINGS Resource DataRedactionSettings
SKADNETWORK_CONVERSION_VALUE_SCHEMA Resource SKAdNetworkConversionValueSchema
AUDIENCE Resource audiens
EVENT_CREATE_RULE Resource EventCreateRule
KEY_EVENT Resource KeyEvent
CALCULATED_METRIC Resource CalculatedMetric
REPORTING_DATA_ANNOTATION Resource ReportingDataAnnotation
SUBPROPERTY_SYNC_CONFIG Resource SubpropertySyncConfig
REPORTING_IDENTITY_SETTINGS Resource ReportingIdentitySettings

ActionType

Jenis tindakan yang dapat mengubah resource.

Enum
ACTION_TYPE_UNSPECIFIED Jenis tindakan tidak diketahui atau tidak ditentukan.
CREATED Resource dibuat dalam perubahan ini.
UPDATED Resource diperbarui dalam perubahan ini.
DELETED Resource dihapus dalam perubahan ini.

ChangeHistoryEvent

Serangkaian perubahan dalam akun Google Analytics atau properti turunannya yang disebabkan oleh hal yang sama. Penyebab umumnya adalah pembaruan 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 seluruh Google Analytics.
changeTime

string (Timestamp format)

Waktu saat perubahan dilakukan.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
actorType

enum (ActorType)

Jenis aktor yang melakukan perubahan ini.
userActorEmail

string

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

boolean

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

object (ChangeHistoryChange)

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

ActorType

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

Enum
ACTOR_TYPE_UNSPECIFIED Jenis aktor tidak diketahui atau tidak ditentukan.
USER Perubahan yang dilakukan oleh pengguna yang ditentukan dalam actorEmail.
SYSTEM Perubahan yang dilakukan oleh sistem Google Analytics.
SUPPORT Perubahan yang dilakukan oleh staf tim dukungan Google Analytics.

ChangeHistoryChange

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)

Isi resource dari sebelum perubahan dilakukan. Jika resource ini dibuat dalam perubahan ini, kolom ini tidak akan ada.
resourceAfterChange

object (ChangeHistoryResource)

Isi resource dari setelah perubahan dilakukan. Jika resource ini dihapus dalam perubahan ini, kolom ini tidak akan ada.

ChangeHistoryResource

Snapshot 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)
  },
  "dataRedactionSettings": {
    object (DataRedactionSettings)
  },
  "skadnetworkConversionValueSchema": {
    object (SKAdNetworkConversionValueSchema)
  },
  "adsenseLink": {
    object (AdSenseLink)
  },
  "audience": {
    object (Audience)
  },
  "eventCreateRule": {
    object (EventCreateRule)
  },
  "keyEvent": {
    object (KeyEvent)
  },
  "calculatedMetric": {
    object (CalculatedMetric)
  },
  "reportingDataAnnotation": {
    object (ReportingDataAnnotation)
  },
  "subpropertySyncConfig": {
    object (SubpropertySyncConfig)
  },
  "reportingIdentitySettings": {
    object (ReportingIdentitySettings)
  }
  // End of list of possible types for union field resource.
}
Kolom

Kolom union resource.

resource hanya dapat berupa salah satu dari hal berikut:
account

object (Account)

Snapshot resource Akun di histori perubahan.
property

object (Property)

Snapshot resource Properti dalam histori perubahan.
googleSignalsSettings

object (GoogleSignalsSettings)

Snapshot resource GoogleSignalsSettings dalam histori perubahan.
conversionEvent

object (ConversionEvent)

Ringkasan resource ConversionEvent dalam histori perubahan.
measurementProtocolSecret

object (MeasurementProtocolSecret)

Snapshot resource MeasurementProtocolSecret dalam histori perubahan.
customDimension

object (CustomDimension)

Snapshot resource CustomDimension dalam histori perubahan.
customMetric

object (CustomMetric)

Snapshot resource CustomMetric dalam histori perubahan.
dataRetentionSettings

object (DataRetentionSettings)

Snapshot resource setelan retensi data dalam histori perubahan.
dataStream

object (DataStream)

Snapshot resource DataStream dalam histori perubahan.
attributionSettings

object (AttributionSettings)

Snapshot resource AttributionSettings dalam histori perubahan.
expandedDataSet

object (ExpandedDataSet)

Snapshot resource ExpandedDataSet dalam histori perubahan.
channelGroup

object (ChannelGroup)

Snapshot resource ChannelGroup dalam histori perubahan.
enhancedMeasurementSettings

object (EnhancedMeasurementSettings)

Snapshot resource EnhancedMeasurementSettings dalam histori perubahan.
dataRedactionSettings

object (DataRedactionSettings)

Snapshot resource DataRedactionSettings dalam histori perubahan.
skadnetworkConversionValueSchema

object (SKAdNetworkConversionValueSchema)

Snapshot resource SKAdNetworkConversionValueSchema di histori perubahan.
audience

object (Audience)

Snapshot resource Audiens dalam histori perubahan.
eventCreateRule

object (EventCreateRule)

Snapshot resource EventCreateRule dalam histori perubahan.
keyEvent

object (KeyEvent)

Snapshot resource KeyEvent dalam histori perubahan.
calculatedMetric

object (CalculatedMetric)

Snapshot resource CalculatedMetric dalam histori perubahan.
reportingDataAnnotation

object (ReportingDataAnnotation)

Ringkasan resource ReportingDataAnnotation dalam histori perubahan.
subpropertySyncConfig

object (SubpropertySyncConfig)

Snapshot resource SubpropertySyncConfig dalam histori perubahan.
reportingIdentitySettings

object (ReportingIdentitySettings)

Ringkasan resource ReportingIdentitySettings dalam histori perubahan.