Method: accounts.searchChangeHistoryEvents

Belirtilen filtre grubu kullanılarak bir hesapta veya alt öğelerinde yapılan tüm değişikliklerde arama yapar.

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ğı. Biçim: hesaplar/{hesap} Örnek: "accounts/100"

İstek içeriği

İsteğin 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ür. Biçim: mülkler/{propertyId} Örnek: "properties/100"

resourceType[]

enum (ChangeHistoryResourceType)

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

action[]

enum (ActionType)

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

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 şu tarihten sonra yapılan değişiklikleri döndürür (bu süre dahil).

Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, 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 şu tarihten önce yapılan değişiklikleri döndürür (bu tarihten önce de (dahil).

Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, 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 ChangeHistoryEvent öğesi sayısı. Hizmet, ek sayfalar olsa bile bu değerden daha düşük sonuç döndürebilir. Bu değer belirtilmediğinde en fazla 50 öğe iade edilir. Maksimum değer 200'dür (yüksek değerler maksimum değere zorlanır).

pageToken

string

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

Yanıt gövdesi

SearchAccounts RPC için yanıt iletisi.

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şebileceği sonuçlar.

nextPageToken

string

Sonraki sayfayı almak için pageToken olarak gönderilebilecek bir jeton. Bu alan atlanırsa sonraki sayfa yoktur.

Yetkilendirme kapsamları

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

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

ChangeHistoryResourceType

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 VeriSaklama Ayarları kaynağı
DATA_STREAM DataStream kaynağı
ATTRIBUTION_SETTINGS AttributionSettings kaynağı

ActionType

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

Sıralamalar
ACTION_TYPE_UNSPECIFIED İşlem türü bilinmiyor veya belirtilmedi.
CREATED Kaynak, bu değişiklikle oluşturuldu.
UPDATED Kaynak, bu değişiklikle güncellendi.
DELETED Kaynak, bu değişiklik sonucunda silindi.

ChangeHistoryEvent

Google Analytics hesabında veya alt mülklerinde meydana gelen ve aynı nedenle yapılan değişiklikler grubu. Bunun nedeni genellikle Google Analytics kullanıcı arayüzünde yapılan güncellemeler, müşteri desteğinde yapılan değişiklikler veya Google Analytics'teki otomatik sistem değişiklikleridir.

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 genelinde benzersizdir.

changeTime

string (Timestamp format)

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

Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, 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 kullanıcının türü.

userActorEmail

string

Değişikliği yapan Google hesabının e-posta adresi. İşlemi gerçekleştiren alanı USER olarak ayarlanmışsa bu geçerli bir e-posta adresi olur, aksi takdirde boş bırakılır. Silinen Google hesapları hataya neden olur.

changesFiltered

boolean

Doğru ise, 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'te belirtilen filtrelere uyan değişikliklerin listesi.

ActorType

Google Analytics kaynaklarında değişiklik yapabilen farklı kullanıcı türleri.

Sıralamalar
ACTOR_TYPE_UNSPECIFIED Bilinmeyen veya belirtilmemiş aktör türü.
USER actorEmail öğesinde 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 personeli tarafından yapılan değişiklikler.

ChangeHistoryChange

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ş tarafından 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şiklik sonucunda oluşturulduysa bu alan eksik olacaktır.

resourceAfterChange

object (ChangeHistoryResource)

Değişiklik yapıldıktan sonraki kaynak içerikleri. Söz konusu kaynak bu değişiklik sonucunda silindiyse bu alan eksik olacaktır.

ChangeHistoryResource

Bir kaynağın, değişiklik geçmişindeki bir değişikliğin sonucundan önceki veya sonraki 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

Birleştirme alanı resource.

resource şunlardan 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ü.