- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- ChangeHistoryResourceType
- ActionType
- ChangeHistoryEvent
- ActorType
- ChangeHistoryChange
- ChangeHistoryResource
- Testen!
Durchsucht alle Änderungen an einem Konto oder dessen untergeordneten Konten 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 |
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 ( |
Felder | |
---|---|
property |
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[] |
Optional. Wenn festgelegt, werden Änderungen nur zurückgegeben, wenn sie sich auf eine Ressource beziehen, die mit mindestens einem dieser Typen übereinstimmt. |
action[] |
Optional. Wenn festgelegt, werden nur Änderungen zurückgegeben, die mit mindestens einer dieser Aktionstypen übereinstimmen. |
actorEmail[] |
Optional. Wenn festgelegt, werden Änderungen nur zurückgegeben, wenn sie von einem Nutzer in dieser Liste vorgenommen wurden. |
earliestChangeTime |
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: |
latestChangeTime |
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: |
pageSize |
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 |
Optional. Ein Seitentoken, das von einem vorherigen |
Antworttext
Antwortnachricht für SearchKonten-RPC.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"changeHistoryEvents": [
{
object ( |
Felder | |
---|---|
changeHistoryEvents[] |
Ergebnisse, die für den Aufrufer zugänglich waren. |
nextPageToken |
Ein Token, das als |
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 |
FIREBASE_LINK |
FirebaseLink-Ressource |
GOOGLE_ADS_LINK |
GoogleAdsLink-Ressource |
GOOGLE_SIGNALS_SETTINGS |
GoogleSignalsSettings-Ressource |
CONVERSION_EVENT |
ConversionEvent-Ressource |
MEASUREMENT_PROTOCOL_SECRET |
MeasurementProtocolSecret-Ressource |
DATA_RETENTION_SETTINGS |
DataRetentionSettings-Ressource |
DISPLAY_VIDEO_360_ADVERTISER_LINK |
DisplayVideo360AdvertiserLink-Ressource |
DISPLAY_VIDEO_360_ADVERTISER_LINK_PROPOSAL |
DisplayVideo360AdvertiserLinkOffer-Ressource |
DATA_STREAM |
DataStream-Ressource |
ATTRIBUTION_SETTINGS |
AttributionSettings-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 ( |
Felder | |
---|---|
id |
ID dieses Änderungsverlaufs. Diese ID ist in Google Analytics eindeutig. |
changeTime |
Zeitpunkt der Änderung. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
actorType |
Der Akteur, der diese Änderung vorgenommen hat. |
userActorEmail |
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 |
Bei „true“ wurde die Liste der zurückgegebenen Änderungen gefiltert und enthält nicht alle Änderungen, die bei diesem Ereignis vorgenommen wurden. |
changes[] |
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 ( |
Felder | |
---|---|
resource |
Ressourcenname der Ressource, deren Änderungen in diesem Eintrag beschrieben werden. |
action |
Die Art der Aktion, durch die diese Ressource geändert wurde. |
resourceBeforeChange |
Ressourceninhalte aus der Zeit vor der Änderung. Wenn diese Ressource durch diese Änderung erstellt wurde, fehlt dieses Feld. |
resourceAfterChange |
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 |
Felder | |
---|---|
Union-Feld Für |
|
account |
Eine Übersicht einer Kontoressource im Änderungsverlauf. |
property |
Snapshot einer Property-Ressource im Änderungsverlauf |
firebaseLink |
Ein Snapshot einer FirebaseLink-Ressource im Änderungsverlauf. |
googleAdsLink |
Übersicht einer GoogleAdsLink-Ressource im Änderungsverlauf |
conversionEvent |
Eine Übersicht einer ConversionEvent-Ressource im Änderungsverlauf. |
measurementProtocolSecret |
Ein Snapshot einer MeasurementProtocolSecret-Ressource im Änderungsverlauf. |
dataRetentionSettings |
Übersicht einer Ressource für Einstellungen zur Datenaufbewahrung im Änderungsverlauf. |
dataStream |
Ein Snapshot einer DataStream-Ressource im Änderungsverlauf. |