- Solicitação HTTP
- Parâmetros de caminho
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- ChangeHistoryResourceType
- ActionType
- ChangeHistoryEvent
- ActorType
- ChangeHistoryChange
- ChangeHistoryResource
- Faça um teste
Pesquisa todas as alterações feitas em uma conta ou nos filhos dela de acordo com o conjunto de filtros especificado.
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 |
Obrigatório. O recurso de conta em que os recursos do histórico de alterações serão retornados. Formato: accounts/{account} Exemplo: "accounts/100" |
Corpo da solicitação
O corpo da solicitação contém dados com a seguinte estrutura:
Representação JSON |
---|
{ "property": string, "resourceType": [ enum ( |
Campos | |
---|---|
property |
Opcional. Nome do recurso para uma propriedade filha. Se definido, retorna apenas as alterações feitas nessa propriedade ou nos recursos filhos dela. Formato: propriedades/{propertyId} Exemplo: "propriedades/100" |
resourceType[] |
Opcional. Se definido, somente as alterações serão retornadas se forem para um recurso que corresponda a pelo menos um desses tipos. |
action[] |
Opcional. Se definido, retorna somente alterações que correspondam a um ou mais desses tipos de ações. |
actorEmail[] |
Opcional. Se definido, retorna as alterações somente se elas forem feitas por um usuário dessa lista. |
earliestChangeTime |
Opcional. Se definido, retorna somente as alterações feitas depois desse período (inclusive). Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
latestChangeTime |
Opcional. Se definido, retorna somente as alterações feitas antes desse horário (inclusive). Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
pageSize |
Opcional. O número máximo de itens 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 mais altos serão convertidos para o máximo). |
pageToken |
Opcional. Um token de página recebido de uma chamada |
Corpo da resposta
Mensagem de resposta para RPC SearchAccounts.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
Representação JSON |
---|
{
"changeHistoryEvents": [
{
object ( |
Campos | |
---|---|
changeHistoryEvents[] |
Resultados que estavam acessíveis ao autor da chamada. |
nextPageToken |
Um token, que pode ser enviado como |
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/analytics.edit
ChangeHistoryResourceType
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 |
FIREBASE_LINK |
Recurso FirebaseLink |
GOOGLE_ADS_LINK |
Recurso GoogleAdsLink |
GOOGLE_SIGNALS_SETTINGS |
Recurso GoogleSignalsSettings |
CONVERSION_EVENT |
Recurso ConversionEvent |
MEASUREMENT_PROTOCOL_SECRET |
Recurso Measurement ProtocolSecret |
DATA_RETENTION_SETTINGS |
Recurso DataRetençãoSettings |
DISPLAY_VIDEO_360_ADVERTISER_LINK |
Recurso DisplayVideo360AdvertiserLink |
DISPLAY_VIDEO_360_ADVERTISER_LINK_PROPOSAL |
Recurso DisplayVideo360AdvertiserLinkProposal |
DATA_STREAM |
Recurso do DataStream |
ATTRIBUTION_SETTINGS |
Recurso AttributionSettings |
ActionType
Tipos de ações que podem alterar 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 alteração. |
DELETED |
O recurso foi excluído nesta alteração. |
ChangeHistoryEvent
Um conjunto de alterações em uma conta do Google Analytics ou nas propriedades filhas dela que resultaram da mesma causa. As causas comuns seriam atualizações feitas na interface do Google Analytics, alterações do suporte ao cliente ou alterações automáticas do sistema do Google Analytics.
Representação JSON |
---|
{ "id": string, "changeTime": string, "actorType": enum ( |
Campos | |
---|---|
id |
ID deste evento do histórico de alterações. Esse ID é exclusivo no Google Analytics. |
changeTime |
Horário 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: |
actorType |
O tipo de ator que fez a alteração. |
userActorEmail |
Endereço de e-mail da Conta do Google que fez a alteração. Este será um endereço de e-mail válido se o campo do ator estiver definido como USER. Caso contrário, estará vazio. Contas do Google que foram excluídas causarão um erro. |
changesFiltered |
Se verdadeiro, a lista de alterações retornadas foi filtrada e não representa todas as alterações que ocorreram nesse evento. |
changes[] |
Uma lista das alterações feitas neste evento do histórico de alterações que se encaixam nos filtros especificados em SearchChangeHistoryEventsRequest. |
ActorType
Diferentes tipos de agentes que podem fazer alterações nos recursos do Google Analytics.
Enums | |
---|---|
ACTOR_TYPE_UNSPECIFIED |
Tipo de ator desconhecido ou não especificado. |
USER |
Alterações feitas pelo usuário especificado em actorEmail. |
SYSTEM |
Alterações feitas pelo sistema do Google Analytics. |
SUPPORT |
Alterações feitas pela equipe de suporte do Google Analytics. |
ChangeHistoryChange
A descrição de uma alteração em um único recurso do Google Analytics.
Representação JSON |
---|
{ "resource": string, "action": enum ( |
Campos | |
---|---|
resource |
Nome do recurso com as alterações descritas por esta entrada. |
action |
O tipo de ação que alterou este recurso. |
resourceBeforeChange |
Conteúdo do recurso anterior à mudança. Se o recurso tiver sido criado nesta alteração, este campo não estará presente. |
resourceAfterChange |
Conteúdo do recurso posterior à mudança. Se o recurso tiver sido excluído nesta alteração, este campo não estará presente. |
ChangeHistoryResource
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 |
Campos | |
---|---|
Campo de união
|
|
account |
Um instantâneo de um recurso de conta no histórico de alterações. |
property |
Um snapshot de um recurso de propriedade no histórico de alterações. |
firebaseLink |
Um resumo de um recurso FirebaseLink no histórico de alterações. |
googleAdsLink |
Um resumo de um recurso do GoogleAdsLink no histórico de alterações. |
conversionEvent |
Um instantâneo de um recurso ConversionEvent no histórico de alterações. |
measurementProtocolSecret |
Um resumo de um recurso Measurement ProtocolSecret no histórico de alterações. |
dataRetentionSettings |
Um resumo de um recurso de configurações de retenção de dados no histórico de alterações. |
dataStream |
Um resumo de um recurso do DataStream no histórico de alterações. |