Method: accounts.searchChangeHistoryEvents

Szuka we wszystkich zmianach na koncie lub jego elementach podrzędnych zgodnie ze wskazanym zestawem filtrów.

Zwraca tylko podzbiór zmian obsługiwanych przez interfejs API. Interfejs może wyświetlać 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 ustawiona, zwraca 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 tylko zmiany, które 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).

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. Dopuszczalne 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. Dopuszczalne 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 zastąpione 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ą zostać zwrócone z historii zmian.

Wartości w polu enum
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIEDTyp zasobu jest nieznany lub nieokreślony.
ACCOUNTZasób konta
PROPERTYZasób usługi
GOOGLE_SIGNALS_SETTINGSZasób GoogleSignalsSettings
CONVERSION_EVENTZasób ConversionEvent
MEASUREMENT_PROTOCOL_SECRETZasób MeasurementProtocolSecret
CUSTOM_DIMENSIONZasób CustomDimension
CUSTOM_METRICZasób CustomMetric
DATA_RETENTION_SETTINGSZasób DataRetentionSettings
DATA_STREAMZasób DataStream
ATTRIBUTION_SETTINGSZasób AttributionSettings

ActionType

Rodzaje działań, które mogą zmienić zasób.

Wartości w polu enum
ACTION_TYPE_UNSPECIFIEDTyp działania jest nieznany lub nieokreślony.
CREATEDzasób został utworzony w ramach tej zmiany,
UPDATEDZasób został zaktualizowany w ramach tej zmiany.
DELETEDzasó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.

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. Dopuszczalne 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ść” jest ustawione na „USER” (użytkownik), 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 jest to prawda, zwracana lista zmian została przefiltrowana 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_UNSPECIFIEDNieznany lub nieokreślony typ podmiotu.
USERZmiany wprowadzone przez użytkownika określonego w polu actorEmail.
SYSTEMzmiany wprowadzone przez system Google Analytics.
SUPPORTZmiany 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 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 nie będzie widoczne.

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)

migawka zasobu Usługa 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 ekranu zasobu ustawień przechowywania danych w historii zmian.

dataStream

object (DataStream)

Zrzut stanu zasobu DataStream w historii zmian.