Method: accounts.searchChangeHistoryEvents

Sucht nach allen Änderungen an einem Konto oder dessen untergeordneten Elementen mit den angegebenen Filtern.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
account

string

Erforderlich. Die Kontoressource, für die Ressourcen des Änderungsverlaufs zurückgegeben werden sollen.

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 an dieser Property oder ihren untergeordneten Ressourcen zurückgegeben.
resourceType[]

enum (ChangeHistoryResourceType)

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

enum (ActionType)

Optional. Falls festgelegt, werden nur Änderungen zurückgegeben, die mit mindestens einer dieser Aktionen ü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. Falls festgelegt, werden nur Änderungen zurückgegeben, die nach diesem Zeitraum (einschließlich) vorgenommen wurden.

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

string (Timestamp format)

Optional. Falls festgelegt, werden nur Änderungen zurückgegeben, die vor diesem Zeitpunkt vorgenommen wurden.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit einer Auflösung von Nanosekunden 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 es zusätzliche Seiten gibt. Wenn nicht angegeben, werden maximal 50 Elemente zurückgegeben. Der Höchstwert ist 200 (höhere Werte werden auf das Maximum erzwungen).
pageToken

string

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

Antworttext

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

Antwortnachricht für SearchAccounts-RPC.

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

ChangeResourceResourceType

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 Ressource GoogleSignalsSettings
CONVERSION_EVENT ConversionEvent-Ressource
MEASUREMENT_PROTOCOL_SECRET MeasurementProtocolSecret-Ressource
DATA_RETENTION_SETTINGS Ressource zur Datenaufbewahrung
DATA_STREAM DataStream-Ressource
ATTRIBUTION_SETTINGS AttributionSettings-Ressource
EXPANDED_DATA_SET ExpandedDataSet-Ressource
CHANNEL_GROUP ChannelGroup-Ressource

Aktionstyp

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

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

ÄnderungsverlaufEreignis

Eine Gruppe von Änderungen in einem Google Analytics-Konto oder einer untergeordneten Property, die aus demselben Grund resultieren Häufige Gründe sind Aktualisierungen auf der Google Analytics-Benutzeroberfläche, Änderungen durch den Kundensupport oder automatische Änderungen des Google Analytics-Systems.

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 einer Auflösung von Nanosekunden 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, das die Änderung vorgenommen hat Wenn das Feld für den Akteur auf NUTZER gesetzt ist, ist dies eine gültige E-Mail-Adresse. Ansonsten ist das Feld leer. Gelöschte Google-Konten führen zu einem Fehler.
changesFiltered

boolean

Wenn der Wert „true“ ist, wurde die Liste der zurückgegebenen Änderungen herausgefiltert und enthält nicht alle Änderungen, die in 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.

Akteurtyp

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

Enums
ACTOR_TYPE_UNSPECIFIED Unbekannter oder nicht angegebener Akteurtyp.
USER Änderungen des Nutzers, der in actorEmail angegeben ist.
SYSTEM Änderungen, die vom Google Analytics-System vorgenommen wurden
SUPPORT Vom Google Analytics-Supportteam vorgenommene Änderungen

Änderungsverlauf

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 durch diesen Eintrag beschrieben werden.
action

enum (ActionType)

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

object (ChangeHistoryResource)

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

object (ChangeHistoryResource)

Ressourceninhalte aus der Zeit nach der Änderung. Wenn diese Ressource in dieser Änderung gelöscht wurde, fehlt das Feld.

Ressource für Änderungsverlauf

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)
  },
  "conversionEvent": {
    object (ConversionEvent)
  },
  "measurementProtocolSecret": {
    object (MeasurementProtocolSecret)
  },
  "dataRetentionSettings": {
    object (DataRetentionSettings)
  },
  "dataStream": {
    object (DataStream)
  }
  // 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.
conversionEvent

object (ConversionEvent)

Ein Snapshot einer ConversionEvent-Ressource im Änderungsverlauf.
measurementProtocolSecret

object (MeasurementProtocolSecret)

Ein Snapshot einer MeasurementProtocolSecret-Ressource im Änderungsverlauf.
dataRetentionSettings

object (DataRetentionSettings)

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

object (DataStream)

Ein Snapshot einer DataStream-Ressource im Änderungsverlauf.