Method: accounts.searchChangeHistoryEvents

Przeszukuje wszystkie zmiany na koncie lub jego kontach podrzędnych z użyciem 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 mają zostać zwrócone zasoby historii zmian. Format: accounts/{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 właściwości podrzędnej. Jeśli jest ustawiony, zwracane są tylko zmiany wprowadzone w tej usłudze lub jej zasobach podrzędnych. Format: właściwość/{propertyId} Przykład: „właściwości/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 jest ustawiony, zwracane są tylko te zmiany, które pasują do co najmniej jednego z tych typów działań.
actorEmail[]

string

Opcjonalnie. Jeśli zasada jest skonfigurowana, zwracaj tylko zmiany wprowadzone przez użytkowników z tej listy.
earliestChangeTime

string (Timestamp format)

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

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC 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 ustawiony, zwracane są tylko zmiany wprowadzone przed tym terminem (włącznie).

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC 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ć mniej niż ta wartość, nawet jeśli istnieją dodatkowe strony. Jeśli nie określono inaczej, zwróconych zostanie maksymalnie 50 produktów. Maksymalna wartość to 200 (wyższe wartości zostaną przekształcone w wartość maksymalną).
pageToken

string

Opcjonalnie. Token strony odebrany z poprzedniego wywołania accounts.searchChangeHistoryEvents. Podaj je, aby pobrać kolejną stronę. W przypadku podziału na strony wszystkie pozostałe parametry podane w interfejsie accounts.searchChangeHistoryEvents muszą odpowiadać wywołaniu, które podało token strony.

Treść odpowiedzi

Komunikat 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, które były dostępne dla rozmówcy.
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 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 zdarzenia konwersji
MEASUREMENT_PROTOCOL_SECRET Zasób MeasurementProtocolSecret
CUSTOM_DIMENSION Zasób wymiaru niestandardowego
CUSTOM_METRIC Zasób CustomMetric
DATA_RETENTION_SETTINGS Zasób DataPrzechowywanieSettings
DATA_STREAM Zasób DataStream
ATTRIBUTION_SETTINGS Zasób Ustawienia atrybucji
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 Zasoby związane z odbiorcami
EVENT_CREATE_RULE Zasób EventCreateRule
CALCULATED_METRIC Zasób Processing Metrics

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 W ramach tej zmiany zaktualizowano zasób.
DELETED W ramach tej zmiany został usunięty zasób.

ChangeHistoryEvent

Zbiór zmian na koncie Google Analytics lub w jego usługach podrzędnych, które wynikają z tej samej przyczyny. Typowe przyczyny to zmiany wprowadzone 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. Jest on niepowtarzalny w Google Analytics.
changeTime

string (Timestamp format)

Godzina wprowadzenia zmiany.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC 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ł zmianę.
userActorEmail

string

Adres e-mail konta Google, na którym wprowadzono zmianę. Jeśli pole użytkownika jest ustawione na USER, będzie to prawidłowy adres e-mail. W przeciwnym razie pole jest puste. Usunięte konta Google będą powodować błąd.
changesFiltered

boolean

Jeśli ma wartość true (prawda), lista zwróconych zmian została odfiltrowana i nie zawiera 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 podanego w actorEmail.
SYSTEM Zmiany wprowadzone przez system Google Analytics.
SUPPORT Zmiany wprowadzone przez pracowników zespołu pomocy Google Analytics.

ChangeHistoryChange

Opis zmiany pojedynczego zasobu 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)

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 niedostępne.
resourceAfterChange

object (ChangeHistoryResource)

Zawartość zasobu od momentu wprowadzenia zmiany. Jeśli w ramach tej zmiany ten zasób został usunięty, to pole będzie niedostępne.

ChangeHistoryResource

Migawka zasobu w stanie sprzed 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)
  },
  "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 być tylko jedną z tych wartości:
account

object (Account)

Migawka zasobu konta w historii zmian.
property

object (Property)

Migawka zasobu usługi w historii zmian.
googleSignalsSettings

object (GoogleSignalsSettings)

Migawka zasobu GoogleSignalsSettings w historii zmian.
conversionEvent

object (ConversionEvent)

Migawka zasobu ConversionEvent w historii zmian.
measurementProtocolSecret

object (MeasurementProtocolSecret)

Zrzut zasobu MeasurementProtocolSecret w historii zmian.
customDimension

object (CustomDimension)

Migawka zasobu wymiaru niestandardowego w historii zmian.
customMetric

object (CustomMetric)

Zrzut zasobu CustomMetric w historii zmian.
dataRetentionSettings

object (DataRetentionSettings)

Migawka zasobu ustawień przechowywania danych w historii zmian.
dataStream

object (DataStream)

Zrzut zasobu DataStream w historii zmian.
attributionSettings

object (AttributionSettings)

Migawka zasobu AttributionSettings w historii zmian.
expandedDataSet

object (ExpandedDataSet)

Migawka zasobu ExtendedDataSet w historii zmian.
channelGroup

object (ChannelGroup)

Zrzut zasobu grupy kanałów w historii zmian.
enhancedMeasurementSettings

object (EnhancedMeasurementSettings)

Migawka zasobu EnhancedMeasurementSettings w historii zmian.
dataRedactionSettings

object (DataRedactionSettings)

Migawka zasobu DataRedactionSettings w historii zmian.
skadnetworkConversionValueSchema

object (SKAdNetworkConversionValueSchema)

Migawka zasobu SKAdNetworkConversionValueSchema w historii zmian.
audience

object (Audience)

Migawka zasobu Odbiorcy w historii zmian.
eventCreateRule

object (EventCreateRule)

Zrzut zasobu EventCreateRule w historii zmian.
calculatedMetric

object (CalculatedMetric)

Migawka zasobu MeasuredMetrics w historii zmian.