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 zwrócić dodatkowe zmiany.

Żą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

Wymagany. 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: 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 jest ustawiona, zwraca 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 (wyższe 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 wysyłać prośby 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
EXPANDED_DATA_SET Zasób ExpandedDataSet
CHANNEL_GROUP Zasób ChannelGroup
ENHANCED_MEASUREMENT_SETTINGS Zasób EnhancedMeasurementSettings
DATA_REDACTION_SETTINGS Zasób DataRedactionSettings
SKADNETWORK_CONVERSION_VALUE_SCHEMA Zasób SKAdNetworkConversionValueSchema
AUDIENCE Zasób odbiorców
EVENT_CREATE_RULE Zasób EventCreateRule
KEY_EVENT Zasób KeyEvent
CALCULATED_METRIC Zasób CalculatedMetric
REPORTING_DATA_ANNOTATION Zasób ReportingDataAnnotation
SUBPROPERTY_SYNC_CONFIG Zasób SubpropertySyncConfig
REPORTING_IDENTITY_SETTINGS Zasób ReportingIdentitySettings

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 użytkownika, 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)
  },
  "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)
  },
  "keyEvent": {
    object (KeyEvent)
  },
  "calculatedMetric": {
    object (CalculatedMetric)
  },
  "reportingDataAnnotation": {
    object (ReportingDataAnnotation)
  },
  "subpropertySyncConfig": {
    object (SubpropertySyncConfig)
  },
  "reportingIdentitySettings": {
    object (ReportingIdentitySettings)
  }
  // End of list of possible types for union field resource.
}
Pola

Pole unii resource.

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.
googleSignalsSettings

object (GoogleSignalsSettings)

Zrzut zasobu GoogleSignalsSettings w historii zmian.
conversionEvent

object (ConversionEvent)

Zrzut zasobu ConversionEvent w historii zmian.
measurementProtocolSecret

object (MeasurementProtocolSecret)

Zrzut zasobu MeasurementProtocolSecret w historii zmian.
customDimension

object (CustomDimension)

Migawka zasobu CustomDimension w historii zmian.
customMetric

object (CustomMetric)

Migawka zasobu CustomMetric w historii zmian.
dataRetentionSettings

object (DataRetentionSettings)

Zrzut 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)

Zrzut zasobu ExpandedDataSet w historii zmian.
channelGroup

object (ChannelGroup)

Migawka zasobu ChannelGroup w historii zmian.
enhancedMeasurementSettings

object (EnhancedMeasurementSettings)

Migawka zasobu EnhancedMeasurementSettings w historii zmian.
dataRedactionSettings

object (DataRedactionSettings)

Migawka zasobu DataRedactionSettings w historii zmian.
skadnetworkConversionValueSchema

object (SKAdNetworkConversionValueSchema)

Zrzut zasobu SKAdNetworkConversionValueSchema w historii zmian.
audience

object (Audience)

Migawka zasobu Odbiorcy w historii zmian.
eventCreateRule

object (EventCreateRule)

Migawka zasobu EventCreateRule w historii zmian.
keyEvent

object (KeyEvent)

Zrzut zasobu KeyEvent w historii zmian.
calculatedMetric

object (CalculatedMetric)

Zrzut zasobu CalculatedMetric w historii zmian.
reportingDataAnnotation

object (ReportingDataAnnotation)

Migawka zasobu ReportingDataAnnotation w historii zmian.
subpropertySyncConfig

object (SubpropertySyncConfig)

Zrzut zasobu SubpropertySyncConfig w historii zmian.
reportingIdentitySettings

object (ReportingIdentitySettings)

Migawka zasobu ReportingIdentitySettings w historii zmian.