Method: accounts.searchChangeHistoryEvents

Durchsucht alle Änderungen an einem Konto oder dessen untergeordneten Konten mit den angegebenen Filtern.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
account

string

Erforderlich. Die Kontoressource, für die Änderungsverlaufsressourcen zurückgegeben werden sollen. Format: accounts/{account}. Beispiel: „accounts/100“

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

string

Optional. Ressourcenname für eine untergeordnete Property. Wenn festgelegt, werden nur Änderungen zurückgegeben, die an dieser Eigenschaft oder ihren untergeordneten Ressourcen vorgenommen wurden. Format: Properties/{propertyId} Beispiel: „properties/100“
resourceType[]

enum (ChangeHistoryResourceType)

Optional. Wenn festgelegt, werden Änderungen nur zurückgegeben, wenn sie sich auf eine Ressource beziehen, die mit mindestens einem dieser Typen übereinstimmt.
action[]

enum (ActionType)

Optional. Wenn festgelegt, werden nur Änderungen zurückgegeben, die mit mindestens einer dieser Aktionstypen übereinstimmen.
actorEmail[]

string

Optional. Wenn festgelegt, werden Änderungen nur zurückgegeben, wenn sie von einem Nutzer in dieser Liste vorgenommen wurden.
earliestChangeTime

string (Timestamp format)

Optional. Wenn festgelegt, werden nur Änderungen zurückgegeben, die nach diesem Zeitraum (einschließlich) vorgenommen wurden.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
latestChangeTime

string (Timestamp format)

Optional. Wenn festgelegt, werden nur Änderungen zurückgegeben, die vor diesem Zeitpunkt (einschließlich) vorgenommen wurden.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
pageSize

integer

Optional. Die maximale Anzahl von ChangeHistoryEvent-Elementen, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück, auch wenn weitere Seiten vorhanden sind. Wenn keine Vorgabe erfolgt, werden maximal 50 Artikel zurückgegeben. Der Maximalwert beträgt 200 (höhere Werte werden auf das Maximum erzwungen).
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen accounts.searchChangeHistoryEvents-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen. Beim Paginieren müssen alle anderen für accounts.searchChangeHistoryEvents bereitgestellten Parameter mit dem Aufruf übereinstimmen, über den das Seitentoken bereitgestellt wurde.

Antworttext

Antwortnachricht für SearchKonten-RPC.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "changeHistoryEvents": [
    {
      object (ChangeHistoryEvent)
    }
  ],
  "nextPageToken": string
}
Felder
changeHistoryEvents[]

object (ChangeHistoryEvent)

Ergebnisse, die für den Aufrufer zugänglich waren.
nextPageToken

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

ChangeHistoryResourceType

Ressourcentypen, deren Änderungen aus dem Änderungsverlauf zurückgegeben werden können.

Enums
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED Ressourcentyp unbekannt oder nicht angegeben.
ACCOUNT Kontoressource
PROPERTY Property-Ressource
GOOGLE_SIGNALS_SETTINGS GoogleSignalsSettings-Ressource
CONVERSION_EVENT ConversionEvent-Ressource
MEASUREMENT_PROTOCOL_SECRET MeasurementProtocolSecret-Ressource
CUSTOM_DIMENSION CustomDimension-Ressource
CUSTOM_METRIC CustomMetric-Ressource
DATA_RETENTION_SETTINGS DataRetentionSettings-Ressource
DATA_STREAM DataStream-Ressource
ATTRIBUTION_SETTINGS AttributionSettings-Ressource
EXPANDED_DATA_SET ExtendedDataSet-Ressource
CHANNEL_GROUP ChannelGroup-Ressource
ENHANCED_MEASUREMENT_SETTINGS EnhancedMeasurementSettings-Ressource
DATA_REDACTION_SETTINGS DataRedactionSettings-Ressource
SKADNETWORK_CONVERSION_VALUE_SCHEMA SKAdNetworkConversionValueSchema-Ressource
AUDIENCE Zielgruppenressource
EVENT_CREATE_RULE EventCreateRule-Ressource
CALCULATED_METRIC computedMetric-Ressource

ActionType

Aktionen, die eine Ressource ändern können.

Enums
ACTION_TYPE_UNSPECIFIED Aktionstyp unbekannt oder nicht angegeben.
CREATED Die Ressource wurde durch diese Änderung erstellt.
UPDATED Die Ressource wurde durch diese Änderung aktualisiert.
DELETED Die Ressource wurde mit dieser Änderung gelöscht.

ChangeHistoryEvent

Eine Reihe von Änderungen innerhalb eines Google Analytics-Kontos oder seiner untergeordneten Properties, die aus derselben Ursache hervorgerufen wurden. Häufige Ursachen sind Aktualisierungen auf der Google Analytics-Benutzeroberfläche, Änderungen durch den Kundensupport oder automatische Systemänderungen in Google Analytics.

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

string

ID dieses Änderungsverlaufs. Diese ID ist in Google Analytics eindeutig.
changeTime

string (Timestamp format)

Zeitpunkt der Änderung.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
actorType

enum (ActorType)

Der Akteur, der diese Änderung vorgenommen hat.
userActorEmail

string

E-Mail-Adresse des Google-Kontos, über das die Änderung vorgenommen wurde Falls das Feld „actor“ auf USER gesetzt ist, ist dies eine gültige E-Mail-Adresse. Andernfalls ist das Feld leer. Bei gelöschten Google-Konten tritt ein Fehler auf.
changesFiltered

boolean

Bei „true“ wurde die Liste der zurückgegebenen Änderungen gefiltert und enthält nicht alle Änderungen, die bei diesem Ereignis vorgenommen wurden.
changes[]

object (ChangeHistoryChange)

Eine Liste der Änderungen, die in diesem Änderungsverlaufsereignis vorgenommen wurden und den Filtern entsprechen, die in „SearchChangeHistoryEventsRequest“ angegeben sind.

ActorType

Unterschiedliche Akteure, die Änderungen an Google Analytics-Ressourcen vornehmen können.

Enums
ACTOR_TYPE_UNSPECIFIED Unbekannter oder nicht angegebener Akteurtyp.
USER Änderungen, die von dem in actorEmail angegebenen Nutzer vorgenommen wurden
SYSTEM Änderungen, die durch das Google Analytics-System vorgenommen wurden
SUPPORT Änderungen, die von Mitarbeitern des Google Analytics-Supportteams vorgenommen wurden

ChangeHistoryChange

Eine Beschreibung einer Änderung an einer einzelnen Google Analytics-Ressource.

JSON-Darstellung 
{
  "resource": string,
  "action": enum (ActionType),
  "resourceBeforeChange": {
    object (ChangeHistoryResource)
  },
  "resourceAfterChange": {
    object (ChangeHistoryResource)
  }
}
Felder
resource

string

Ressourcenname der Ressource, deren Änderungen in diesem Eintrag beschrieben werden.
action

enum (ActionType)

Die Art der Aktion, durch die diese Ressource geändert wurde.
resourceBeforeChange

object (ChangeHistoryResource)

Ressourceninhalte aus der Zeit vor der Änderung. Wenn diese Ressource durch diese Änderung erstellt wurde, fehlt dieses Feld.
resourceAfterChange

object (ChangeHistoryResource)

Ressourceninhalte aus der Zeit nach der Änderung. Wenn diese Ressource durch diese Änderung gelöscht wurde, fehlt dieses Feld.

ChangeHistoryResource

Ein Snapshot einer Ressource wie vor oder nach dem Ergebnis einer Änderung im Änderungsverlauf.

JSON-Darstellung 
{

  // 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)
  },
  "calculatedMetric": {
    object (CalculatedMetric)
  }
  // End of list of possible types for union field resource.
}
Felder

Union-Feld resource.

Für resource ist nur einer der folgenden Werte zulässig:
account

object (Account)

Eine Übersicht einer Kontoressource im Änderungsverlauf.
property

object (Property)

Snapshot einer Property-Ressource im Änderungsverlauf
googleSignalsSettings

object (GoogleSignalsSettings)

Übersicht einer GoogleSignalsSettings-Ressource im Änderungsverlauf
conversionEvent

object (ConversionEvent)

Eine Übersicht einer ConversionEvent-Ressource im Änderungsverlauf.
measurementProtocolSecret

object (MeasurementProtocolSecret)

Ein Snapshot einer MeasurementProtocolSecret-Ressource im Änderungsverlauf.
customDimension

object (CustomDimension)

Snapshot einer CustomDimension-Ressource im Änderungsverlauf
customMetric

object (CustomMetric)

Ein Snapshot einer CustomMetric-Ressource im Änderungsverlauf.
dataRetentionSettings

object (DataRetentionSettings)

Übersicht einer Ressource für Einstellungen zur Datenaufbewahrung im Änderungsverlauf.
dataStream

object (DataStream)

Ein Snapshot einer DataStream-Ressource im Änderungsverlauf.
attributionSettings

object (AttributionSettings)

Übersicht der AttributionSettings-Ressource im Änderungsverlauf
expandedDataSet

object (ExpandedDataSet)

Übersicht einer ExtendedDataSet-Ressource im Änderungsverlauf
channelGroup

object (ChannelGroup)

Snapshot einer ChannelGroup-Ressource im Änderungsverlauf.
enhancedMeasurementSettings

object (EnhancedMeasurementSettings)

Übersicht über die Ressource „EnhancedMeasurementSettings“ im Änderungsverlauf.
dataRedactionSettings

object (DataRedactionSettings)

Ein Snapshot der Ressource „DataRedactionSettings“ im Änderungsverlauf.
skadnetworkConversionValueSchema

object (SKAdNetworkConversionValueSchema)

Ein Snapshot der Ressource „SKAdNetworkConversionValueSchema“ im Änderungsverlauf.
audience

object (Audience)

Eine Übersicht einer Zielgruppe im Änderungsverlauf.
eventCreateRule

object (EventCreateRule)

Ein Snapshot einer EventCreateRule-Ressource im Änderungsverlauf.
calculatedMetric

object (CalculatedMetric)

Snapshot einer computedMetric-Ressource im Änderungsverlauf.