Method: accounts.searchChangeHistoryEvents

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

Zwraca tylko podzbiór zmian obsługiwanych przez interfejs API. Interfejs może zwracać dodatkowe zmiany.

Żą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 mają zostać zwrócone zasoby historii zmian. Format: accounts/{account}

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 ustawiony, zwracane są tylko zmiany wprowadzone w tej usłudze lub jej zasobach podrzędnych. Format: usługi/{identyfikator_usługi}

Przykład: properties/100
resourceType[]

enum (ChangeHistoryResourceType)

Opcjonalnie: Jeśli jest ustawiony, zwraca zmiany tylko wtedy, gdy dotyczą one 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 tym czasie (włącznie).

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
latestChangeTime

string (Timestamp format)

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

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
pageSize

integer

Opcjonalnie: Maksymalna liczba elementów ChangeHistoryEvent do zwrócenia. Jeśli nie zostanie podany, zwróci się maksymalnie 50 elementów. Maksymalna wartość to 200 (wyższe wartości zostaną przymusowo ustawione na maksymalną).

Pamiętaj, że usługa może zwrócić stronę z mniejszą liczbą elementów niż ta wartość (a nawet zero) i że mogą istnieć dodatkowe strony. Jeśli chcesz uzyskać określoną liczbę elementów, musisz nadal wysyłać żądanie kolejnych stron za pomocą parametru pageToken, aż uzyskasz odpowiednią liczbę.
pageToken

string

Opcjonalnie: Token strony otrzymany z poprzedniego wywołania funkcji accounts.searchChangeHistoryEvents. Podaj ten parametr, 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 RPC 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żna wysłać jako pageToken, aby pobrać następną stronę. 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 Typ zasobu jest nieznany lub nieokreślony.
ACCOUNT Zasób konta
PROPERTY Zasób właściwości
GOOGLE_SIGNALS_SETTINGS Zasób GoogleSignalsSettings
CONVERSION_EVENT Typ zasobu ConversionEvent
MEASUREMENT_PROTOCOL_SECRET Zasób MeasurementProtocolSecret
CUSTOM_DIMENSION Zasób CustomDimension
CUSTOM_METRIC Zasób CustomMetric
DATA_RETENTION_SETTINGS Zasób DataRetentionSettings
DATA_STREAM Zasób DataStream
ATTRIBUTION_SETTINGS Zasób AttributionSettings

ActionType

Rodzaje działań, które mogą zmienić 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 z historii zmian. Ten identyfikator jest unikalny w Google Analytics.
changeTime

string (Timestamp format)

Czas wprowadzenia zmiany.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
actorType

enum (ActorType)

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

string

Adres e-mail konta Google, które wprowadziło zmianę. Jeśli pole „Użytkownik, który wykonał czynność” ma wartość „USER”, to 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 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 podmiotu.
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)

Typ działania, które spowodowało zmianę tego zasobu.
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 stanu 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)

migawka zasobu Usługa w historii zmian,
conversionEvent

object (ConversionEvent)

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

object (MeasurementProtocolSecret)

Zrzut ekranu zasobu MeasurementProtocolSecret w historii zmian.
dataRetentionSettings

object (DataRetentionSettings)

Zrzut zasoby ustawień przechowywania danych w historii zmian.
dataStream

object (DataStream)

Zrzut stanu zasobu DataStream w historii zmian.