Method: accounts.searchChangeHistoryEvents

Szuka we wszystkich zmianach na koncie lub jego podrzędnych pod kątem określonego zestawu filtrów.

Żądanie HTTP

POST https://analyticsadmin.googleapis.com/v1beta/{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: „konta/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 jest ustawiony, zwracaj zmiany tylko wtedy, gdy dotyczą zasobu pasującego do co najmniej jednego z tych typów.
action[]

enum (ActionType)

Opcjonalnie: Jeśli to ustawienie jest ustawione, zwracane są tylko zmiany odpowiadające co najmniej 1 z tych typów działań.
actorEmail[]

string

Opcjonalnie: Jeśli to ustawienie jest włączone, zwracane są tylko zmiany wprowadzone przez użytkownika z tej listy.
earliestChangeTime

string (Timestamp format)

Opcjonalnie: Jeśli jest ustawiony, zwracane są tylko zmiany wprowadzone po tej dacie (włącznie).

Sygnatura czasowa w formacie RFC3339 UTC „Zulu” z rozdzielczością nanosekundy 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 formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc 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ć mniej niż tę wartość, nawet jeśli są dodatkowe strony. Jeśli nie zostanie podany, zwróci się maksymalnie 50 elementów. Maksymalna wartość to 200 (wyższe wartości zostaną przymusowo zastąpione maksymalną).
pageToken

string

Opcjonalnie: Token strony otrzymany z poprzedniego wywołania funkcji accounts.searchChangeHistoryEvents. Podaj go, aby pobrać kolejną stronę. Podczas podziału na strony wszystkie inne parametry przekazane do funkcji accounts.searchChangeHistoryEvents muszą być zgodne z wywołaniem, które dostarczyło token strony.

Treść odpowiedzi

Odpowiedź na wywołanie procedury zdalnej SearchAccounts.

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 dzwonią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ą zostać zwrócone 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
DATA_RETENTION_SETTINGS Zasób DataRetentionSettings
DATA_STREAM Zasób DataStream
ATTRIBUTION_SETTINGS Zasób AttributionSettings

ActionType

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

Wartości w polu enum
ACTION_TYPE_UNSPECIFIED Typ działania jest nieznany lub nieokreślony.
CREATED zasób został utworzony w ramach tej zmiany,
UPDATED Zasób został zaktualizowany w ramach tej zmiany.
DELETED zasób został usunięty w ramach tej zmiany;

ChangeHistoryEvent

Zbiór zmian na koncie Google Analytics lub jego usługach podrzędnych, które zostały wprowadzone z tego samego powodu. Typowymi przyczynami są aktualizacje w interfejsie Google Analytics, zmiany wprowadzone przez obsługę 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. Ten identyfikator jest unikalny w Google Analytics.
changeTime

string (Timestamp format)

Czas wprowadzenia zmiany.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
actorType

enum (ActorType)

Typ aktora, który wprowadził tę zmianę.
userActorEmail

string

Adres e-mail konta Google, na którym wprowadzono zmianę. Jeśli pole „Użytkownik, który wykonał czynność” jest ustawione na „USER”, będzie to prawidłowy adres e-mail. W przeciwnym razie pole będzie puste. Konta Google, które zostały usunięte, spowodują błąd.
changesFiltered

boolean

Jeśli to pole ma wartość true, zwracana lista zmian została odfiltrowana i nie obejmuje wszystkich zmian, które wystą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 typy podmiotów, 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 polu actorEmail.
SYSTEM zmiany wprowadzone przez system Google Analytics.
SUPPORT Zmiany wprowadzone przez zespół pomocy Google Analytics.

ChangeHistoryChange

Opis zmiany w pojedynczym zasobie Google Analytics.

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

string

Nazwa zasobu, którego zmiany są opisane przez ten wpis.
action

enum (ActionType)

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

object (ChangeHistoryResource)

Zawartość zasobu sprzed wprowadzenia zmiany. Jeśli 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 ramach tej zmiany, to pole będzie puste.

ChangeHistoryResource

Zrzut zasobu przed lub po zmianie w historii zmian.

Zapis JSON 
{

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

Pole unii resource.

resource może być tylko jednym z tych elementów:
account

object (Account)

migawka zasobu Konta w historii zmian,
property

object (Property)

Zrzut zasobu usługi w historii zmian.
conversionEvent

object (ConversionEvent)

Zrzut ekranu pokazujący zasób ConversionEvent w historii zmian.
measurementProtocolSecret

object (MeasurementProtocolSecret)

Zrzut z zasobem MeasurementProtocolSecret w historii zmian.
dataRetentionSettings

object (DataRetentionSettings)

Zrzut zasobu ustawień przechowywania danych w historii zmian.
dataStream

object (DataStream)

Zrzut obrazu zasobu DataStream w historii zmian.