Method: accounts.searchChangeHistoryEvents

Sucht anhand der angegebenen Filter nach allen Änderungen an einem Konto oder seinen untergeordneten Konten.

Gibt nur die Teilmenge der Änderungen zurück, die von der API unterstützt werden. Die Benutzeroberfläche kann zusätzliche Änderungen zurückgeben.

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 diese Option festgelegt ist, werden nur Änderungen an dieser Property oder ihren untergeordneten Ressourcen zurückgegeben. Format: properties/{propertyId}

Beispiel: properties/100
resourceType[]

enum (ChangeHistoryResourceType)

Optional. Wenn festgelegt, werden nur Änderungen für Ressourcen zurückgegeben, die mindestens einem dieser Typen entsprechen.
action[]

enum (ActionType)

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

string

Optional. Wenn diese Option festgelegt ist, werden nur Änderungen zurückgegeben, die von einem Nutzer in dieser Liste vorgenommen wurden.
earliestChangeTime

string (Timestamp format)

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

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
latestChangeTime

string (Timestamp format)

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

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
pageSize

integer

Optional. Die maximale Anzahl der zurückzugebenden ChangeHistoryEvent-Elemente. Falls nicht angegeben, werden maximal 50 Elemente zurückgegeben. Der Höchstwert ist 200. Höhere Werte werden implizit auf den Höchstwert umgewandelt.

Der Dienst gibt möglicherweise eine Seite mit weniger Elementen als in diesem Wert angegeben zurück (möglicherweise sogar null). Es kann aber trotzdem weitere Seiten geben. Wenn Sie eine bestimmte Anzahl von Elementen benötigen, müssen Sie weiterhin zusätzliche Seiten mit pageToken anfordern, bis Sie die erforderliche Anzahl erhalten.
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, der das Seitentoken bereitgestellt hat.

Antworttext

Antwortnachricht für den RPC „SearchAccounts“.

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

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

object (ChangeHistoryEvent)

Ergebnisse, auf die der Anrufer zugreifen konnte.
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

Arten von Ressourcen, deren Änderungen im Änderungsverlauf zurückgegeben werden können.

Enums
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED Der Ressourcentyp ist unbekannt oder nicht angegeben.
ACCOUNT Kontoressource
PROPERTY Property-Ressource
GOOGLE_SIGNALS_SETTINGS GoogleSignalsSettings-Ressource
CONVERSION_EVENT Ressource „ConversionEvent“
MEASUREMENT_PROTOCOL_SECRET MeasurementProtocolSecret-Ressource
CUSTOM_DIMENSION Ressource „CustomDimension“
CUSTOM_METRIC CustomMetric-Ressource
DATA_RETENTION_SETTINGS DataRetentionSettings-Ressource
DATA_STREAM DataStream-Ressource
ATTRIBUTION_SETTINGS AttributionSettings-Ressource
EXPANDED_DATA_SET ExpandedDataSet-Ressource
CHANNEL_GROUP ChannelGroup-Ressource
ENHANCED_MEASUREMENT_SETTINGS Ressource „EnhancedMeasurementSettings“
DATA_REDACTION_SETTINGS Ressource „DataRedactionSettings“
SKADNETWORK_CONVERSION_VALUE_SCHEMA Ressource „SKAdNetworkConversionValueSchema“
AUDIENCE Zielgruppenressource
EVENT_CREATE_RULE EventCreateRule-Ressource
KEY_EVENT KeyEvent-Ressource
CALCULATED_METRIC Ressource „CalculatedMetric“
REPORTING_DATA_ANNOTATION ReportingDataAnnotation-Ressource
SUBPROPERTY_SYNC_CONFIG SubpropertySyncConfig-Ressource
REPORTING_IDENTITY_SETTINGS ReportingIdentitySettings-Ressource

ActionType

Arten von Aktionen, die eine Ressource ändern können.

Enums
ACTION_TYPE_UNSPECIFIED Der Aktionstyp ist unbekannt oder nicht angegeben.
CREATED Ressource wurde in dieser Änderung erstellt.
UPDATED Die Ressource wurde bei dieser Änderung aktualisiert.
DELETED Die Ressource wurde bei dieser Änderung gelöscht.

ChangeHistoryEvent

Eine Reihe von Änderungen in einem Google Analytics-Konto oder den zugehörigen untergeordneten Properties, die auf dieselbe Ursache zurückzuführen sind. Häufige Ursachen sind Aktualisierungen in 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 Änderungsverlaufsereignisses. Diese ID ist in Google Analytics eindeutig.
changeTime

string (Timestamp format)

Zeitpunkt der Änderung.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
actorType

enum (ActorType)

Der Typ des Akteurs, der diese Änderung vorgenommen hat.
userActorEmail

string

E-Mail-Adresse des Google-Kontos, mit dem die Änderung vorgenommen wurde. Dies ist eine gültige E-Mail-Adresse, wenn das Feld „Akteur“ auf „USER“ festgelegt ist, andernfalls ist es leer. Bei gelöschten Google-Konten tritt ein Fehler auf.
changesFiltered

boolean

Bei „wahr“ wurde die zurückgegebene Liste der Änderungen gefiltert und enthält nicht alle Änderungen, die bei diesem Ereignis aufgetreten sind.
changes[]

object (ChangeHistoryChange)

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

ActorType

Verschiedene Arten von Akteuren, die Änderungen an Google Analytics-Ressourcen vornehmen können.

Enums
ACTOR_TYPE_UNSPECIFIED Unbekannter oder nicht angegebener Akteurstyp.
USER Änderungen, die vom Nutzer mit der E‑Mail-Adresse „actorEmail“ vorgenommen wurden.
SYSTEM Änderungen, die vom 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 vor der Änderung. Wenn diese Ressource im Rahmen dieser Änderung erstellt wurde, fehlt dieses Feld.
resourceAfterChange

object (ChangeHistoryResource)

Ressourceninhalte nach der Änderung. Wenn diese Ressource bei dieser Änderung gelöscht wurde, fehlt dieses Feld.

ChangeHistoryResource

Ein Snapshot einer Ressource 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)
  },
  "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.
}
Felder

Union-Feld resource.

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

object (Account)

Ein Snapshot einer Kontoressource im Änderungsverlauf.
property

object (Property)

Ein Snapshot einer Property-Ressource im Änderungsverlauf.
googleSignalsSettings

object (GoogleSignalsSettings)

Ein Snapshot einer GoogleSignalsSettings-Ressource im Änderungsverlauf.
conversionEvent

object (ConversionEvent)

Ein Snapshot einer ConversionEvent-Ressource im Änderungsverlauf.
measurementProtocolSecret

object (MeasurementProtocolSecret)

Ein Snapshot einer MeasurementProtocolSecret-Ressource im Änderungsverlauf.
customDimension

object (CustomDimension)

Ein Snapshot einer CustomDimension-Ressource im Änderungsverlauf.
customMetric

object (CustomMetric)

Snapshot einer CustomMetric-Ressource im Änderungsverlauf.
dataRetentionSettings

object (DataRetentionSettings)

Ein Snapshot einer Ressource für Einstellungen zur Datenaufbewahrung im Änderungsverlauf.
dataStream

object (DataStream)

Ein Snapshot einer DataStream-Ressource im Änderungsverlauf.
attributionSettings

object (AttributionSettings)

Ein Snapshot der Ressource „AttributionSettings“ im Änderungsverlauf.
expandedDataSet

object (ExpandedDataSet)

Ein Snapshot einer ExpandedDataSet-Ressource im Änderungsverlauf.
channelGroup

object (ChannelGroup)

Ein Snapshot einer ChannelGroup-Ressource im Änderungsverlauf.
enhancedMeasurementSettings

object (EnhancedMeasurementSettings)

Ein Snapshot der Ressource „EnhancedMeasurementSettings“ im Änderungsverlauf.
dataRedactionSettings

object (DataRedactionSettings)

Ein Snapshot der DataRedactionSettings-Ressource im Änderungsverlauf.
skadnetworkConversionValueSchema

object (SKAdNetworkConversionValueSchema)

Snapshot der Ressource „SKAdNetworkConversionValueSchema“ im Änderungsverlauf.
audience

object (Audience)

Ein Snapshot einer Zielgruppenressource im Änderungsverlauf.
eventCreateRule

object (EventCreateRule)

Ein Snapshot einer EventCreateRule-Ressource im Änderungsverlauf.
keyEvent

object (KeyEvent)

Ein Snapshot einer KeyEvent-Ressource im Änderungsverlauf.
calculatedMetric

object (CalculatedMetric)

Ein Snapshot einer CalculatedMetric-Ressource im Änderungsverlauf.
reportingDataAnnotation

object (ReportingDataAnnotation)

Ein Snapshot einer ReportingDataAnnotation-Ressource im Änderungsverlauf.
subpropertySyncConfig

object (SubpropertySyncConfig)

Ein Snapshot einer SubpropertySyncConfig-Ressource im Änderungsverlauf.
reportingIdentitySettings

object (ReportingIdentitySettings)

Ein Snapshot einer ReportingIdentitySettings-Ressource im Änderungsverlauf.