- 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 em todas as alterações em uma conta ou nas contas secundárias com base no conjunto especificado de filtros.
Solicitação HTTP
POST https://analyticsadmin.googleapis.com/v1alpha/{account=accounts/*}:searchChangeHistoryEvents
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros | |
---|---|
account |
Obrigatório. O recurso da conta para o qual retornar recursos do histórico de alterações. Formato: accounts/{account} Exemplo: |
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 de uma propriedade filha. Se definido, retorna apenas as alterações feitas nessa propriedade ou nos recursos filhos dela. Formato: propriedades/{propertyId} Exemplo: |
resourceType[] |
Opcional. Se definido, retornará alterações somente se forem para um recurso que corresponda a pelo menos um desses tipos. |
action[] |
Opcional. Se definido, retorna apenas as mudanças que correspondem a um ou mais desses tipos de ações. |
actorEmail[] |
Opcional. Se definido, retorna 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 RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
latestChangeTime |
Opcional. Se definido, retorna apenas as alterações feitas antes desse período (inclusive). Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
pageSize |
Opcional. O número máximo de itens ChangeHistoryEvent a ser retornado. O serviço pode retornar menos do que esse valor, mesmo que haja páginas adicionais. Se não for especificado, no máximo 50 itens serão retornados. 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 a 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 alterações 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 de 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 |
CUSTOM_DIMENSION |
Recurso CustomDimension |
CUSTOM_METRIC |
Recurso CustomMetric |
DATA_RETENTION_SETTINGS |
Recurso DataRetençãoSettings |
DISPLAY_VIDEO_360_ADVERTISER_LINK |
Recurso DisplayVideo360AdvertiserLink |
DISPLAY_VIDEO_360_ADVERTISER_LINK_PROPOSAL |
Recurso DisplayVideo360AdvertiserLinkProposal |
SEARCH_ADS_360_LINK |
Recurso SearchAds360Link |
DATA_STREAM |
Recurso do DataStream |
ATTRIBUTION_SETTINGS |
Recurso AttributionSettings |
EXPANDED_DATA_SET |
Recurso ExtendedDataSet |
CHANNEL_GROUP |
Recurso ChannelGroup |
BIGQUERY_LINK |
Recurso de link do BigQuery |
ENHANCED_MEASUREMENT_SETTINGS |
Recurso EnhancedMeasurementSettings |
DATA_REDACTION_SETTINGS |
Recurso DataRedactionSettings |
SKADNETWORK_CONVERSION_VALUE_SCHEMA |
Recurso SKAdNetworkConversionValueSchema |
ADSENSE_LINK |
Recurso AdSenseLink |
AUDIENCE |
Recurso de público-alvo |
EVENT_CREATE_RULE |
Recurso EventCreateRule |
CALCULATED_METRIC |
Recurso CalculatedMetric |
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 com base nessa mudança. |
UPDATED |
O recurso foi atualizado com base nessa mudança. |
DELETED |
O recurso foi excluído nesta mudança. |
ChangeHistoryEvent
Um conjunto de alterações em uma conta do Google Analytics ou nas propriedades filhas 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 desse evento do histórico de alterações. Ele é exclusivo no Google Analytics. |
changeTime |
Hora em que a alteração foi feita. Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
actorType |
O tipo de agente 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 "ator" estiver definido como USER. Caso contrário, estará vazio. As 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 mudanças feitas nesse 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
Uma 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 cujas alterações são descritas por esta entrada. |
action |
O tipo de ação que alterou este recurso. |
resourceBeforeChange |
Conteúdos do recurso anteriores à mudança. Se o recurso tiver sido criado com a mudança, este campo vai estar ausente. |
resourceAfterChange |
Conteúdo do recurso posterior à alteração. Se o recurso tiver sido excluído após a mudança, este campo vai estar ausente. |
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 resumo de um recurso da conta no histórico de alterações. |
property |
Um snapshot de um recurso de propriedade no histórico de alterações. |
firebaseLink |
Um snapshot de um recurso FirebaseLink no histórico de alterações. |
googleAdsLink |
Um instantâneo de um recurso GoogleAdsLink no histórico de alterações. |
googleSignalsSettings |
Um resumo de um recurso GoogleSignalsSettings no histórico de alterações. |
displayVideo360AdvertiserLink |
Um resumo de um recurso DisplayVideo360AdvertiserLink no histórico de alterações. |
displayVideo360AdvertiserLinkProposal |
Um resumo de um recurso DisplayVideo360AdvertiserLinkProposal no histórico de alterações. |
conversionEvent |
Um resumo de um recurso ConversionEvent no histórico de alterações. |
measurementProtocolSecret |
Um snapshot de um recurso Measurement ProtocolSecret no histórico de alterações. |
customDimension |
Um snapshot de um recurso CustomDimension no histórico de alterações. |
customMetric |
Um snapshot de um recurso CustomMetric 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. |
searchAds360Link |
Um snapshot de um recurso do SearchAds360Link no histórico de alterações. |
dataStream |
Um snapshot de um recurso do DataStream no histórico de alterações. |
attributionSettings |
Um resumo do recurso AttributionSettings no histórico de alterações. |
expandedDataSet |
Um snapshot de um recurso ExpandDataSet no histórico de alterações. |
channelGroup |
Um resumo de um recurso de ChannelGroup no histórico de alterações. |
bigqueryLink |
Um snapshot de um recurso de link do BigQuery no histórico de alterações. |
enhancedMeasurementSettings |
Um resumo do recurso EnhancedMeasurementSettings no histórico de alterações. |
dataRedactionSettings |
Um resumo do recurso DataRedactionSettings no histórico de alterações. |
skadnetworkConversionValueSchema |
Um snapshot do recurso SKAdNetworkConversionValueSchema no histórico de alterações. |
adsenseLink |
Um instantâneo de um recurso AdSenseLink no histórico de alterações. |
audience |
Um resumo de um recurso de público-alvo no histórico de alterações. |
eventCreateRule |
Um snapshot de um recurso EventCreateRule no histórico de alterações. |
calculatedMetric |
Um snapshot de um recurso CalculatedMetric no histórico de alterações. |