Method: accounts.searchChangeHistoryEvents

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Pesquisa todas as mudanças em uma conta ou nos filhos dela, considerando o conjunto especificado de filtros.

Solicitação HTTP

POST https://analyticsadmin.googleapis.com/v1beta/{account=accounts/*}:searchChangeHistoryEvents

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
account

string

Obrigatório. O recurso da conta para retornar os recursos do histórico de alterações.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "property": string,
  "resourceType": [
    enum (ChangeHistoryResourceType)
  ],
  "action": [
    enum (ActionType)
  ],
  "actorEmail": [
    string
  ],
  "earliestChangeTime": string,
  "latestChangeTime": string,
  "pageSize": integer,
  "pageToken": string
}
Campos
property

string

Opcional. Nome do recurso de uma propriedade filha. Se definido, retorna apenas as alterações feitas nessa propriedade ou nos recursos filhos dela.
resourceType[]

enum (ChangeHistoryResourceType)

Opcional. Se definido, só retornará mudanças se elas forem para um recurso que corresponde a pelo menos um desses tipos.
action[]

enum (ActionType)

Opcional. Se definido, retorna somente mudanças que correspondam a um ou mais desses tipos de ação.
actorEmail[]

string

Opcional. Se definido, só retornará mudanças se elas forem feitas por um usuário nessa lista.
earliestChangeTime

string (Timestamp format)

Opcional. Se definido, retorna apenas as alterações feitas depois desse tempo (incluídas).

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
latestChangeTime

string (Timestamp format)

Opcional. Se definido, só retorna alterações feitas antes dessa data (inclusive).

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
pageSize

integer

Opcional. O número máximo de itens do ChangeHistoryEvent a serem retornados. O serviço pode retornar menos que esse valor, mesmo se houver páginas adicionais. Se não for especificado, serão retornados no máximo 50 itens. O valor máximo é 200 (valores maiores serão convertidos na porcentagem máxima).
pageToken

string

Opcional. Um token de página recebido de uma chamada SearchChangeHistoryEvents anterior. Forneça isso para recuperar a página subsequente. Ao paginar, todos os outros parâmetros fornecidos para SearchChangeHistoryEvents precisam corresponder à chamada que forneceu o token da página.

Corpo da resposta

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Mensagem de resposta para a RPC de SearchAccounts.

Representação JSON 
{
  "changeHistoryEvents": [
    {
      object (ChangeHistoryEvent)
    }
  ],
  "nextPageToken": string
}
Campos
changeHistoryEvents[]

object (ChangeHistoryEvent)

Resultados que podem ser acessados pelo autor da chamada.
nextPageToken

string

Um token, que pode ser enviado como pageToken para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/analytics.edit

Tipo de recurso de histórico de alterações

Tipos de recursos com mudanças que podem ser retornadas do histórico de alterações.

Enums
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED Tipo de recurso desconhecido ou não especificado.
ACCOUNT Recurso da conta
PROPERTY Recurso da propriedade
GOOGLE_SIGNALS_SETTINGS Recurso GoogleSignalsSettings
CONVERSION_EVENT Recurso ConversionEvent
MEASUREMENT_PROTOCOL_SECRET Recurso MeasurementMeasurementSecret
DATA_RETENTION_SETTINGS Recurso DataRetentionSettings
DATA_STREAM Recurso DataStream
ATTRIBUTION_SETTINGS Recurso AttributionSettings
EXPANDED_DATA_SET Recurso ExpandedDataSet
CHANNEL_GROUP Recurso ChannelGroup

Tipo de ação

Tipos de ações que podem mudar um recurso.

Enums
ACTION_TYPE_UNSPECIFIED Tipo de ação desconhecido ou não especificado.
CREATED O recurso foi criado nesta alteração.
UPDATED O recurso foi atualizado nesta mudança.
DELETED O recurso foi excluído nesta alteração.

Evento de histórico de alterações

Um conjunto de alterações realizadas em uma conta do Google Analytics ou em propriedades filhas que resultaram na mesma causa. As causas comuns são atualizações feitas na IU do Google Analytics, mudanças no suporte ao cliente ou mudanças automáticas de sistema do Google Analytics.

Representação JSON 
{
  "id": string,
  "changeTime": string,
  "actorType": enum (ActorType),
  "userActorEmail": string,
  "changesFiltered": boolean,
  "changes": [
    {
      object (ChangeHistoryChange)
    }
  ]
}
Campos
id

string

ID desse evento do histórico de alterações. Esse ID é exclusivo no Google Analytics.
changeTime

string (Timestamp format)

Hora em que a alteração foi feita.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
actorType

enum (ActorType)

O tipo de ator que fez essa alteração.
userActorEmail

string

Endereço de e-mail da Conta do Google que fez a alteração. Será um endereço de e-mail válido se o campo do ator estiver definido como USER. Caso contrário, ficará vazio. As Contas do Google excluídas vão causar um erro.
changesFiltered

boolean

Se for verdadeiro, a lista de alterações retornadas será filtrada e não representará todas as alterações ocorridas nesse evento.
changes[]

object (ChangeHistoryChange)

É uma lista das mudanças feitas nesse evento do histórico de alterações que se enquadram nos filtros especificados em SearchChangeHistoryEventsRequest.

Tipo de ator

Diferentes tipos de usuários que podem fazer mudanças nos recursos do Google Analytics.

Enums
ACTOR_TYPE_UNSPECIFIED Tipo de ator desconhecido ou não especificado.
USER Mudanças feitas pelo usuário especificado em actorEmail.
SYSTEM Mudanças feitas pelo sistema do Google Analytics.
SUPPORT Mudanças feitas pela equipe da Central de suporte do Google Analytics

MudarHistóricoHistórico

Descrição de uma alteração em um único recurso do Google Analytics.

Representação JSON 
{
  "resource": string,
  "action": enum (ActionType),
  "resourceBeforeChange": {
    object (ChangeHistoryResource)
  },
  "resourceAfterChange": {
    object (ChangeHistoryResource)
  }
}
Campos
resource

string

Nome do recurso com mudanças descritas por essa entrada.
action

enum (ActionType)

O tipo de ação que mudou este recurso.
resourceBeforeChange

object (ChangeHistoryResource)

Conteúdo do recurso anterior à mudança. Se o recurso tiver sido criado na alteração, este campo estará ausente.
resourceAfterChange

object (ChangeHistoryResource)

Conteúdo do recurso após a alteração. Se o recurso tiver sido excluído nessa alteração, esse campo estará ausente.

Histórico de alterações

Um snapshot de um recurso como antes ou depois do resultado de uma alteração no histórico de alterações.

Representação 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.
}
Campos

Campo de união resource.

resource pode ser apenas de um dos tipos a seguir:
account

object (Account)

Um snapshot de um recurso de conta no histórico de alterações.
property

object (Property)

Um snapshot de um recurso de propriedade no histórico de alterações.
conversionEvent

object (ConversionEvent)

Um snapshot de um recurso ConversionEvent no histórico de alterações.
measurementProtocolSecret

object (MeasurementProtocolSecret)

Um snapshot de um recurso MeasurementMeasurementSecret no histórico de alterações.
dataRetentionSettings

object (DataRetentionSettings)

Um snapshot de um recurso de configurações de retenção de dados no histórico de alterações.
dataStream

object (DataStream)

Um snapshot de um recurso DataStream no histórico de alterações.