Method: accounts.searchChangeHistoryEvents

Przeszukuje wszystkie zmiany na koncie lub jego elementach podrzędnych przy użyciu określonego zestawu filtrów.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
account

string

Wymagane. Zasób konta, dla którego są zwracane zasoby historii zmian. Format: konta/{konto}

Przykład: accounts/100

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

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

string

Opcjonalnie: Nazwa zasobu usługi podrzędnej. Jeśli jest ustawiona, zwraca tylko zmiany wprowadzone w tej usłudze lub jej zasobach podrzędnych. Format: properties/{propertyId}

Przykład: properties/100

resourceType[]

enum (ChangeHistoryResourceType)

Opcjonalnie: Jeśli są ustawione, zwracaj zmiany tylko wtedy, gdy dotyczą zasobu pasującego do co najmniej jednego z tych typów.

action[]

enum (ActionType)

Opcjonalnie: Jeśli są ustawione, zwróć tylko te zmiany, które pasują do co najmniej jednego z tych działań.

actorEmail[]

string

Opcjonalnie: Jeśli jest skonfigurowana, zwracaj tylko zmiany wprowadzone przez użytkownika z tej listy.

earliestChangeTime

string (Timestamp format)

Opcjonalnie: Jeśli jest ustawione, zwracane są tylko zmiany wprowadzone po tym czasie (włącznie).

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

latestChangeTime

string (Timestamp format)

Opcjonalnie: Jeśli jest ustawione, zwracane są tylko zmiany wprowadzone przed tym terminem (włącznie).

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

pageSize

integer

Opcjonalnie: Maksymalna liczba elementów ChangeHistoryEvent do zwrócenia. Usługa może zwrócić mniejszą liczbę niż ta wartość, nawet jeśli istnieją dodatkowe strony. Jeśli nie określono inaczej, zwrócony zostanie maksymalnie 50 produktów. Wartość maksymalna to 200 (wyższe wartości zostaną zmienione na wartość maksymalną).

pageToken

string

Opcjonalnie: Token strony otrzymany z poprzedniego wywołania funkcji accounts.searchChangeHistoryEvents. Podaj go, aby pobrać kolejną stronę. Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu accounts.searchChangeHistoryEvents muszą być zgodne z wywołaniem, które dostarczyło token strony.

Treść odpowiedzi

Komunikat z odpowiedzią dla RPC kont wyszukiwania.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "changeHistoryEvents": [
    {
      object (ChangeHistoryEvent)
    }
  ],
  "nextPageToken": string
}
Pola
changeHistoryEvents[]

object (ChangeHistoryEvent)

Wyniki, które były dostępne dla wywołującego.

nextPageToken

string

Token, który może zostać wysłany jako pageToken w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

ChangeHistoryResourceType

Typy zasobów, których zmiany mogą być zwracane z historii zmian.

Wartości w polu enum
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED Nieznany lub nieokreślony typ zasobu.
ACCOUNT Zasób konta
PROPERTY Zasób usługi
GOOGLE_SIGNALS_SETTINGS Zasób GoogleSignalsSettings
CONVERSION_EVENT Zasób ConversionEvent
MEASUREMENT_PROTOCOL_SECRET Zasób MeasurementProtocolSecret
CUSTOM_DIMENSION Zasób CustomWymiar
CUSTOM_METRIC Zasób CustomMetric
DATA_RETENTION_SETTINGS Zasób DataRetentionSettings
DATA_STREAM Zasób DataStream
ATTRIBUTION_SETTINGS Zasób AttributionSettings
EXPANDED_DATA_SET Zasób ExtendedDataSet
CHANNEL_GROUP Zasób grupy kanałów
ENHANCED_MEASUREMENT_SETTINGS Zasób EnhancedMeasurementSettings
DATA_REDACTION_SETTINGS Zasób DataRedactionSettings
SKADNETWORK_CONVERSION_VALUE_SCHEMA Zasób SKAdNetworkConversionValueSchema
AUDIENCE Zasób odbiorców
EVENT_CREATE_RULE Zasób EventCreateRule
CALCULATED_METRIC Zasób ComputedMetric

ActionType

Typy działań, które mogą zmieniać zasób.

Wartości w polu enum
ACTION_TYPE_UNSPECIFIED Nieznany lub nieokreślony typ działania.
CREATED W ramach tej zmiany utworzono zasób.
UPDATED Zasób został zaktualizowany w ramach tej zmiany.
DELETED Zasób został usunięty w związku z tą zmianą.

ChangeHistoryEvent

Zestaw zmian na koncie Google Analytics lub w usługach podrzędnych, które zostały spowodowane tą samą przyczyną. Typowe przyczyny to zmiany wprowadzone w interfejsie Google Analytics, zmiany w obsłudze klienta lub automatyczne zmiany w systemie Google Analytics.

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

string

Identyfikator tego zdarzenia historii zmian. Jest to niepowtarzalny identyfikator w Google Analytics.

changeTime

string (Timestamp format)

Czas wprowadzenia zmiany.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

actorType

enum (ActorType)

Rodzaj użytkownika, który wprowadził tę zmianę.

userActorEmail

string

Adres e-mail konta Google, na którym wprowadzono zmianę. Jeśli pole aktora jest ustawione na USER, to jest prawidłowy adres e-mail. W innym przypadku pole jest puste. Usunięte konta Google będą powodować błąd.

changesFiltered

boolean

Jeśli wartość to prawda, zwracana lista zmian została odfiltrowana i nie odzwierciedla wszystkich zmian, które nastąpiły w tym zdarzeniu.

changes[]

object (ChangeHistoryChange)

Lista zmian wprowadzonych w tym zdarzeniu historii zmian, które pasują do filtrów określonych w żądaniu SearchChangeHistoryEventsRequest.

ActorType

Różne podmioty, które mogą wprowadzać zmiany w zasobach Google Analytics.

Wartości w polu enum
ACTOR_TYPE_UNSPECIFIED Nieznany lub nieokreślony typ aktora.
USER Zmiany wprowadzone przez użytkownika określonego w actorEmail.
SYSTEM Zmiany wprowadzone przez system Google Analytics.
SUPPORT Zmiany wprowadzone przez zespół pomocy Google Analytics.

ChangeHistoryChange

Opis zmiany pojedynczej zasobu Google Analytics.

Zapis JSON
{
  "resource": string,
  "action": enum (ActionType),
  "resourceBeforeChange": {
    object (ChangeHistoryResource)
  },
  "resourceAfterChange": {
    object (ChangeHistoryResource)
  }
}
Pola
resource

string

Nazwa zasobu, którego zmiany zostały opisane w tym wpisie.

action

enum (ActionType)

Typ działania, które zmieniło ten zasób.

resourceBeforeChange

object (ChangeHistoryResource)

Zawartość zasobu sprzed wprowadzenia zmiany. Jeśli ten zasób został utworzony w ramach tej zmiany, to pole będzie puste.

resourceAfterChange

object (ChangeHistoryResource)

Zawartość zasobu po wprowadzeniu zmiany. Jeśli ten zasób został usunięty w wyniku tej zmiany, tego pola nie będzie.

ChangeHistoryResource

Zrzut zasobu w postaci sprzed zmiany w historii zmian lub po niej.

Zapis JSON
{

  // 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.
}
Pola

Pole sumy resource.

resource może mieć tylko jedną z tych wartości:

account

object (Account)

Migawka zasobu konta w historii zmian.

property

object (Property)

Zrzut zasobu usługi w historii zmian.

googleSignalsSettings

object (GoogleSignalsSettings)

Zrzut zasobu GoogleSignalsSettings w historii zmian.

conversionEvent

object (ConversionEvent)

Zrzut zasobu ConversionEvent w historii zmian.

measurementProtocolSecret

object (MeasurementProtocolSecret)

Zrzut zasobu MeasurementProtocolSecret w historii zmian.

customDimension

object (CustomDimension)

Zrzut zasobu wymiaru niestandardowego w historii zmian.

customMetric

object (CustomMetric)

Zrzut zasobu CustomMetric w historii zmian.

dataRetentionSettings

object (DataRetentionSettings)

Zrzut zasobu ustawień przechowywania danych w historii zmian.

dataStream

object (DataStream)

Zrzut zasobu DataStream w historii zmian.

attributionSettings

object (AttributionSettings)

Zrzut zasobu AttributionSettings w historii zmian.

expandedDataSet

object (ExpandedDataSet)

Zrzut zasobu ExtendedDataSet w historii zmian.

channelGroup

object (ChannelGroup)

Migawka zasobu grupy kanałów w historii zmian.

enhancedMeasurementSettings

object (EnhancedMeasurementSettings)

Migawka zasobu EnhancedMeasurementSettings w historii zmian.

dataRedactionSettings

object (DataRedactionSettings)

Zrzut zasobu DataRedactionSettings w historii zmian.

skadnetworkConversionValueSchema

object (SKAdNetworkConversionValueSchema)

Zrzut zasobu SKAdNetworkConversionValueSchema w historii zmian.

audience

object (Audience)

Zrzut zasobu Odbiorcy w historii zmian.

eventCreateRule

object (EventCreateRule)

Zrzut zasobu EventCreateRule w historii zmian.

calculatedMetric

object (CalculatedMetric)

Zrzut zasobu ComputedMetric w historii zmian.