Method: accounts.searchChangeHistoryEvents

Belirtilen filtre grubu göz önünde bulundurularak bir hesapta veya alt öğelerinde yapılan tüm değişikliklerde arama yapar.

Yalnızca API tarafından desteklenen değişikliklerin alt kümesini döndürür. Kullanıcı arayüzü ek değişiklikler döndürebilir.

HTTP isteği

POST https://analyticsadmin.googleapis.com/v1alpha/{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: accounts/{account}

Örnek: accounts/100

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri 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ı. Alt mülkün kaynak adı. Ayarlanırsa yalnızca bu mülkte veya alt kaynaklarında yapılan değişiklikler döndürülür. Biçim: properties/{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 kaynağa ait değişiklikler döndürülür.
action[]

enum (ActionType)

İsteğe bağlı. Ayarlanırsa yalnızca bu tür işlemlerden biri veya daha fazlasıyla eşleşen değişiklikler döndürülür.
actorEmail[]

string

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

string (Timestamp format)

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

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
latestChangeTime

string (Timestamp format)

İsteğe bağlı. Ayarlandığı takdirde yalnızca bu saatten önce yapılan değişiklikler (bu saat dahil) döndürülür.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
pageSize

integer

İsteğe bağlı. Döndürülecek maksimum ChangeHistoryEvent öğesi sayısı. Belirtilmemesi halinde en fazla 50 öğe döndürülür. Maksimum değer 200'dür (daha yüksek değerler maksimum değere zorlanır).

Hizmetin, bu değerin belirttiğinden daha az öğe içeren (hatta sıfır öğe içeren) bir sayfa döndürebileceğini ve ek sayfaların olabileceğini unutmayın. Belirli sayıda öğe istiyorsanız ihtiyacınız olan sayıya ulaşana kadar pageToken kullanarak ek sayfalar istemeye devam etmeniz gerekir.
pageToken

string

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

Yanıt gövdesi

SearchAccounts RPC'nin 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 kişinin erişebildiği sonuçlar.
nextPageToken

string

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

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 belirtilmemiş.
ACCOUNT Hesap kaynağı
PROPERTY Tesis kaynağı
GOOGLE_SIGNALS_SETTINGS GoogleSignalsSettings kaynağı
CONVERSION_EVENT ConversionEvent kaynağı
MEASUREMENT_PROTOCOL_SECRET MeasurementProtocolSecret kaynağı
CUSTOM_DIMENSION CustomDimension kaynağı
CUSTOM_METRIC CustomMetric kaynağı
DATA_RETENTION_SETTINGS DataRetentionSettings kaynağı
DATA_STREAM DataStream kaynağı
ATTRIBUTION_SETTINGS AttributionSettings kaynağı
EXPANDED_DATA_SET ExpandedDataSet kaynağı
CHANNEL_GROUP ChannelGroup kaynağı
ENHANCED_MEASUREMENT_SETTINGS EnhancedMeasurementSettings kaynağı
DATA_REDACTION_SETTINGS DataRedactionSettings kaynağı
SKADNETWORK_CONVERSION_VALUE_SCHEMA SKAdNetworkConversionValueSchema kaynağı
AUDIENCE Kitle kaynağı
EVENT_CREATE_RULE EventCreateRule kaynağı
KEY_EVENT KeyEvent kaynağı
CALCULATED_METRIC CalculatedMetric kaynağı
REPORTING_DATA_ANNOTATION ReportingDataAnnotation kaynağı
SUBPROPERTY_SYNC_CONFIG SubpropertySyncConfig kaynağı
REPORTING_IDENTITY_SETTINGS ReportingIdentitySettings kaynağı

ActionType

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

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

ChangeHistoryEvent

Bir Google Analytics hesabında veya alt mülklerinde aynı nedenden kaynaklanan bir dizi değişiklik. Genel nedenler arasında Google Analytics kullanıcı arayüzünde yapılan güncellemeler, müşteri desteğinden gelen değişiklikler veya otomatik Google Analytics sistem değişiklikleri yer alır.

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

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
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. Bu, aktör alanı USER olarak ayarlanmışsa geçerli bir e-posta adresi, aksi takdirde boş olur. Silinen Google Hesapları hataya neden olur.
changesFiltered

boolean

Doğruysa döndürülen değişiklikler listesi filtrelenmiştir 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ı türde aktörler.

Sıralamalar
ACTOR_TYPE_UNSPECIFIED Bilinmeyen veya belirtilmemiş aktör türü.
USER actorEmail içinde 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 çalışanları 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şle açıklanan kaynağın kaynak adı.
action

enum (ActionType)

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

object (ChangeHistoryResource)

Değişiklik yapılmadan önceki kaynak içerikleri. Bu kaynak bu değişiklikte oluşturulduysa bu alan eksik olur.
resourceAfterChange

object (ChangeHistoryResource)

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

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)
  },
  "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.
}
Alanlar

Birleştirme alanı resource.

resource yalnızca aşağıdakilerden 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ü.
googleSignalsSettings

object (GoogleSignalsSettings)

Değişiklik geçmişindeki bir GoogleSignalsSettings 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ü.
customDimension

object (CustomDimension)

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

object (CustomMetric)

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

object (DataRetentionSettings)

Değişiklik geçmişindeki bir 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ü.
attributionSettings

object (AttributionSettings)

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

object (ExpandedDataSet)

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

object (ChannelGroup)

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

object (EnhancedMeasurementSettings)

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

object (DataRedactionSettings)

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

object (SKAdNetworkConversionValueSchema)

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

object (Audience)

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

object (EventCreateRule)

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

object (KeyEvent)

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

object (CalculatedMetric)

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

object (ReportingDataAnnotation)

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

object (SubpropertySyncConfig)

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

object (ReportingIdentitySettings)

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