Method: accounts.searchChangeHistoryEvents

Przeszukuje wszystkie zmiany na koncie lub jego kontach podrzędnych, biorąc pod uwagę określony zestaw 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, 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 ta opcja jest ustawiona, zwracane są tylko zmiany dotyczące zasobu, który pasuje do co najmniej jednego z tych typów.
action[]

enum (ActionType)

Opcjonalnie. Jeśli to ustawienie jest włączone, zwracane są tylko zmiany, które pasują do co najmniej jednego 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 to ustawienie jest włączone, zwracane są tylko zmiany wprowadzone po tym czasie (włącznie).

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. 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 ustawiona, zwraca tylko zmiany wprowadzone przed tym czasem (włącznie).

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. 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 podano tego argumentu, zwracanych jest maksymalnie 50 elementów. Maksymalna wartość to 200 (większe wartości zostaną zredukowane do tej wartości).

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

string

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

Treść odpowiedzi

Wiadomość z odpowiedzią dla 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, do których jednostka wywołująca miała dostęp;
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

Rodzaje 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 usługi
GOOGLE_SIGNALS_SETTINGS Zasób GoogleSignalsSettings
CONVERSION_EVENT Zasób 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 nie został określony.
CREATED Zasób został utworzony w ramach tej zmiany.
UPDATED W ramach tej zmiany zaktualizowano zasób.
DELETED Zasób został usunięty w ramach tej zmiany.

ChangeHistoryEvent

Zestaw zmian na koncie Google Analytics lub w jego usługach podrzędnych, które wynikają z tej samej przyczyny. Typowe przyczyny to aktualizacje wprowadzone w interfejsie Google Analytics, zmiany wprowadzone przez zespół obsługi 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.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. 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 podmiotu, 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ść” ma wartość USER, będzie to prawidłowy adres e-mail. W przeciwnym razie pole będzie puste. Usunięte konta Google spowodują błąd.
changesFiltered

boolean

Jeśli wartość to „true”, zwrócona lista zmian została przefiltrowana i nie zawiera wszystkich zmian, które zaszł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 rodzaje 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 pracowników zespołu pomocy Google Analytics.

ChangeHistoryChange

Opis zmiany w jednym 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 w tym wpisie.
action

enum (ActionType)

Rodzaj działania, które spowodowało zmianę tego zasobu.
resourceBeforeChange

object (ChangeHistoryResource)

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

object (ChangeHistoryResource)

Zawartość zasobu po wprowadzeniu zmiany. Jeśli ten zasób został usunięty w ramach tej zmiany, to pole będzie nieobecne.

ChangeHistoryResource

Zrzut zasobu przed lub po wprowadzeniu zmiany 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 zbiorcze resource.

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

object (Account)

Migawka zasobu konta w historii zmian.
property

object (Property)

Migawka zasobu Usługa w historii zmian.
conversionEvent

object (ConversionEvent)

Zrzut zasobu ConversionEvent w historii zmian.
measurementProtocolSecret

object (MeasurementProtocolSecret)

Zrzut zasobu MeasurementProtocolSecret w historii zmian.
dataRetentionSettings

object (DataRetentionSettings)

Zrzut zasobu ustawień przechowywania danych w historii zmian.
dataStream

object (DataStream)

Zrzut zasobu DataStream w historii zmian.