Method: accounts.searchChangeHistoryEvents

Belirtilen filtre grubuna göre bir hesapta veya hesabın alt öğelerinde yapılan tüm değişiklikleri arar.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
account

string

Zorunlu. Değişiklik geçmişi kaynaklarının döndürüleceği hesap kaynağı.

İstek içeriği

İstek gövdesi aşağıdaki yapıya sahip veriler içerir:

JSON gösterimi
{
  "property": string,
  "resourceType": [
    enum (ChangeHistoryResourceType)
  ],
  "action": [
    enum (ActionType)
  ],
  "actorEmail": [
    string
  ],
  "earliestChangeTime": string,
  "latestChangeTime": string,
  "pageSize": integer,
  "pageToken": string
}
Alanlar
property

string

İsteğe bağlı. Bir alt mülkün kaynak adı. Ayarlanırsa yalnızca bu mülkte veya alt kaynaklarında yapılan değişiklikleri döndürün.

resourceType[]

enum (ChangeHistoryResourceType)

İsteğe bağlı. Ayarlanırsa yalnızca bu türlerden en az biriyle eşleşen bir kaynak için değişiklik yapıldıysa döndürülür.

action[]

enum (ActionType)

İsteğe bağlı. Ayarlanırsa yalnızca bu tür işlemlerden bir veya daha fazlasıyla eşleşen değişiklikleri döndürün.

actorEmail[]

string

İsteğe bağlı. Ayarlanırsa yalnızca bu listedeki bir kullanıcı tarafından yapılan değişiklikleri döndürür.

earliestChangeTime

string (Timestamp format)

İsteğe bağlı. Ayarlanırsa yalnızca bu tarihten sonra yapılan değişiklikleri döndürür (dahil).

Nanosaniye çözünürlüğüne ve dokuz adede kadar kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

latestChangeTime

string (Timestamp format)

İsteğe bağlı. Ayarlanırsa yalnızca bu tarihten önce yapılan değişiklikleri döndürür (dahil).

Nanosaniye çözünürlüğüne ve dokuz adede kadar kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

pageSize

integer

İsteğe bağlı. Döndürülecek maksimum Değişiklik Geçmişi Etkinliği öğesi sayısı. Hizmet, ek sayfalar olsa bile bu değerden daha az değer döndürebilir. Belirtilmemesi halinde en fazla 50 öğe döndürülür. Maksimum değer 200'dür (yüksek değerler, maksimum değere zorlanır).

pageToken

string

İsteğe bağlı. Önceki bir accounts.searchChangeHistoryEvents çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bu değeri girin. Sayfalara ayırma işlemi sırasında accounts.searchChangeHistoryEvents'a sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

Yanıt gövdesi

Arama Hesapları TBG'si için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "changeHistoryEvents": [
    {
      object (ChangeHistoryEvent)
    }
  ],
  "nextPageToken": string
}
Alanlar
changeHistoryEvents[]

object (ChangeHistoryEvent)

Arayanın erişebildiği sonuçlar.

nextPageToken

string

Sonraki sayfayı almak için pageToken olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfalar bulunmaz.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

DeğişiklikGeçmişKaynakTürü

Değişiklikleri değişiklik geçmişinden döndürülebilecek kaynak türleri.

Sıralamalar
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED Kaynak türü bilinmiyor veya belirtilmedi.
ACCOUNT Hesap kaynağı
PROPERTY Mülk kaynağı
GOOGLE_SIGNALS_SETTINGS GoogleSignalsSettings kaynağı
CONVERSION_EVENT ConversionEvent kaynağı
MEASUREMENT_PROTOCOL_SECRET MeasurementProtocolSecret kaynağı
DATA_RETENTION_SETTINGS DataKeepSettings kaynağı
DATA_STREAM DataStream kaynağı
ATTRIBUTION_SETTINGS AttributionSettings kaynağı

İşlem Türü

Bir kaynağı değiştirebilecek işlem türleri.

Sıralamalar
ACTION_TYPE_UNSPECIFIED İşlem türü bilinmiyor veya belirtilmedi.
CREATED Bu değişiklikte kaynak oluşturuldu.
UPDATED Kaynak bu değişiklikte güncellendi.
DELETED Kaynak bu değişiklikten silindi.

DeğişiklikGeçmişEtkinliği

Bir Google Analytics hesabı veya alt mülkleri içinde aynı nedenden kaynaklanan bir dizi değişiklik. Sık karşılaşılan nedenler arasında Google Analytics kullanıcı arayüzünde yapılan güncellemeler, müşteri desteğinden yapılan değişiklikler veya otomatik Google Analytics sistem değişiklikleri olabilir.

JSON gösterimi
{
  "id": string,
  "changeTime": string,
  "actorType": enum (ActorType),
  "userActorEmail": string,
  "changesFiltered": boolean,
  "changes": [
    {
      object (ChangeHistoryChange)
    }
  ]
}
Alanlar
id

string

Bu değişiklik geçmişi etkinliğinin kimliği. Bu kimlik Google Analytics'te benzersizdir.

changeTime

string (Timestamp format)

Değişikliğin yapıldığı zaman.

Nanosaniye çözünürlüğüne ve dokuz adede kadar kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

actorType

enum (ActorType)

Bu değişikliği yapan aktörün türü.

userActorEmail

string

Değişikliği yapan Google hesabının e-posta adresi. İşlemi gerçekleştiren alan USER olarak ayarlandıysa geçerli bir e-posta adresi, aksi takdirde boş olacaktır. Silinen Google hesapları bir hataya neden olabilir.

changesFiltered

boolean

True (doğru) değerine ayarlanırsa döndürülen değişiklikler listesi filtrelenir ve bu etkinlikte gerçekleşen tüm değişiklikleri temsil etmez.

changes[]

object (ChangeHistoryChange)

Bu değişiklik geçmişi etkinliğinde yapılan ve SearchChangeHistoryEventsRequest uygulamasında belirtilen filtrelere uyan değişikliklerin listesi.

İşlemi Gerçekleştiren Kullanıcının Türü

Google Analytics kaynaklarında değişiklik yapabilen farklı aktör türleri.

Sıralamalar
ACTOR_TYPE_UNSPECIFIED Bilinmeyen veya belirtilmemiş aktör türü.
USER ActorEmail'de belirtilen kullanıcı tarafından yapılan değişiklikler.
SYSTEM Google Analytics sistemi tarafından yapılan değişiklikler.
SUPPORT Google Analytics Destek Ekibi tarafından yapılan değişiklikler.

DeğişiklikGeçmişi Değişikliği

Tek bir Google Analytics kaynağında yapılan değişikliğin açıklaması.

JSON gösterimi
{
  "resource": string,
  "action": enum (ActionType),
  "resourceBeforeChange": {
    object (ChangeHistoryResource)
  },
  "resourceAfterChange": {
    object (ChangeHistoryResource)
  }
}
Alanlar
resource

string

Değişiklikleri bu girişte açıklanan kaynağın kaynak adı.

action

enum (ActionType)

Bu kaynağı değiştiren işlemin türü.

resourceBeforeChange

object (ChangeHistoryResource)

Değişiklik yapılmadan önceki kaynak içerikleri. Söz konusu kaynak bu değişiklikle oluşturulmuşsa bu alan eksik olur.

resourceAfterChange

object (ChangeHistoryResource)

Değişiklik yapıldıktan sonraki kaynak içerikleri. Bu kaynak bu değişiklikten silindiyse bu alan eksik olur.

DeğişiklikGeçmişKaynak

Değişiklik geçmişinde yapılan bir değişikliğin sonucundan önceki veya sonraki kaynağın anlık görüntüsü.

JSON gösterimi
{

  // 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.
}
Alanlar

Birlik alanı resource.

resource aşağıdakilerden yalnızca biri olabilir:

account

object (Account)

Değişiklik geçmişindeki bir Hesap kaynağının anlık görüntüsü.

property

object (Property)

Değişiklik geçmişindeki bir Mülk kaynağının anlık görüntüsü.

conversionEvent

object (ConversionEvent)

Değişiklik geçmişindeki bir ConversionEvent kaynağının anlık görüntüsü.

measurementProtocolSecret

object (MeasurementProtocolSecret)

Değişiklik geçmişindeki bir MeasurementProtocolSecret kaynağının anlık görüntüsü.

dataRetentionSettings

object (DataRetentionSettings)

Değişiklik geçmişindeki veri saklama ayarları kaynağının anlık görüntüsü.

dataStream

object (DataStream)

Değişiklik geçmişindeki bir DataStream kaynağının anlık görüntüsü.