- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- ChangeHistoryResourceType
- ActionType
- ChangeHistoryEvent
- ActorType
- ChangeHistoryChange:
- ChangeHistoryResource
- Wypróbuj
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/v1beta/{account=accounts/*}:searchChangeHistoryEvents
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
account |
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 ( |
Pola | |
---|---|
property |
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[] |
Opcjonalnie. Jeśli jest ustawiony, zwracaj zmiany tylko wtedy, gdy dotyczą zasobu pasującego do co najmniej jednego z tych typów. |
action[] |
Opcjonalnie. Jeśli jest ustawiony, zwracane są tylko te zmiany, które pasują do co najmniej jednego z tych typów działań. |
actorEmail[] |
Opcjonalnie. Jeśli zasada jest skonfigurowana, zwracaj tylko zmiany wprowadzone przez użytkowników z tej listy. |
earliestChangeTime |
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: |
latestChangeTime |
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: |
pageSize |
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 |
Opcjonalnie. Token strony odebrany z poprzedniego wywołania |
Treść odpowiedzi
Komunikat z odpowiedzią dla RPC SearchAccounts.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"changeHistoryEvents": [
{
object ( |
Pola | |
---|---|
changeHistoryEvents[] |
Wyniki, które były dostępne dla rozmówcy. |
nextPageToken |
Token, który można wysłać jako |
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 |
FIREBASE_LINK |
Zasób FirebaseLink |
GOOGLE_ADS_LINK |
Zasób z linkiem GoogleAds |
GOOGLE_SIGNALS_SETTINGS |
Zasób GoogleSignalsSettings |
CONVERSION_EVENT |
Zasób zdarzenia konwersji |
MEASUREMENT_PROTOCOL_SECRET |
Zasób MeasurementProtocolSecret |
DATA_RETENTION_SETTINGS |
Zasób DataPrzechowywanieSettings |
DISPLAY_VIDEO_360_ADVERTISER_LINK |
Zasób połączenia reklamodawców Display Video360 |
DISPLAY_VIDEO_360_ADVERTISER_LINK_PROPOSAL |
Zasób oferty połączenia reklamodawcy DisplayVideo360 |
DATA_STREAM |
Zasób DataStream |
ATTRIBUTION_SETTINGS |
Zasób Ustawienia atrybucji |
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 ( |
Pola | |
---|---|
id |
Identyfikator tego zdarzenia historii zmian. Jest on niepowtarzalny w Google Analytics. |
changeTime |
Godzina wprowadzenia zmiany. Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
actorType |
Rodzaj użytkownika, który wprowadził zmianę. |
userActorEmail |
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 |
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[] |
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 ( |
Pola | |
---|---|
resource |
Nazwa zasobu, którego zmiany są opisane w tym wpisie. |
action |
Typ działania, które zmieniło ten zasób. |
resourceBeforeChange |
Zawartość zasobu sprzed wprowadzenia zmiany. Jeśli ten zasób został utworzony w ramach tej zmiany, to pole będzie niedostępne. |
resourceAfterChange |
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 |
Pola | |
---|---|
Pole sumy
|
|
account |
Migawka zasobu konta w historii zmian. |
property |
Migawka zasobu usługi w historii zmian. |
firebaseLink |
Migawka zasobu FirebaseLink w historii zmian. |
googleAdsLink |
Migawka zasobu GoogleAdsLink w historii zmian. |
conversionEvent |
Migawka zasobu ConversionEvent w historii zmian. |
measurementProtocolSecret |
Zrzut zasobu MeasurementProtocolSecret w historii zmian. |
dataRetentionSettings |
Migawka zasobu ustawień przechowywania danych w historii zmian. |
dataStream |
Zrzut zasobu DataStream w historii zmian. |