Índice
AnalyticsAdminService
(interface)AccessBetweenFilter
(mensagem)AccessDateRange
(mensagem)AccessDimension
(mensagem)AccessDimensionHeader
(mensagem)AccessDimensionValue
(mensagem)AccessFilter
(mensagem)AccessFilterExpression
(mensagem)AccessFilterExpressionList
(mensagem)AccessInListFilter
(mensagem)AccessMetric
(mensagem)AccessMetricHeader
(mensagem)AccessMetricValue
(mensagem)AccessNumericFilter
(mensagem)AccessNumericFilter.Operation
(enum)AccessOrderBy
(mensagem)AccessOrderBy.DimensionOrderBy
(mensagem)AccessOrderBy.DimensionOrderBy.OrderType
(enum)AccessOrderBy.MetricOrderBy
(mensagem)AccessQuota
(mensagem)AccessQuotaStatus
(mensagem)AccessRow
(mensagem)AccessStringFilter
(mensagem)AccessStringFilter.MatchType
(enum)Account
(mensagem)AccountSummary
(mensagem)AcknowledgeUserDataCollectionRequest
(mensagem)AcknowledgeUserDataCollectionResponse
(mensagem)ActionType
(enum)ActorType
(enum)ArchiveCustomDimensionRequest
(mensagem)ArchiveCustomMetricRequest
(mensagem)ChangeHistoryChange
(mensagem)ChangeHistoryChange.ChangeHistoryResource
(mensagem)ChangeHistoryEvent
(mensagem)ChangeHistoryResourceType
(enum)ConversionEvent
(mensagem)ConversionEvent.ConversionCountingMethod
(enum)ConversionEvent.DefaultConversionValue
(mensagem)CreateConversionEventRequest
(mensagem)CreateCustomDimensionRequest
(mensagem)CreateCustomMetricRequest
(mensagem)CreateDataStreamRequest
(mensagem)CreateFirebaseLinkRequest
(mensagem)CreateGoogleAdsLinkRequest
(mensagem)CreateMeasurementProtocolSecretRequest
(mensagem)CreatePropertyRequest
(mensagem)CustomDimension
(mensagem)CustomDimension.DimensionScope
(enum)CustomMetric
(mensagem)CustomMetric.MeasurementUnit
(enum)CustomMetric.MetricScope
(enum)CustomMetric.RestrictedMetricType
(enum)DataRetentionSettings
(mensagem)DataRetentionSettings.RetentionDuration
(enum)DataSharingSettings
(mensagem)DataStream
(mensagem)DataStream.AndroidAppStreamData
(mensagem)DataStream.DataStreamType
(enum)DataStream.IosAppStreamData
(mensagem)DataStream.WebStreamData
(mensagem)DeleteAccountRequest
(mensagem)DeleteConversionEventRequest
(mensagem)DeleteDataStreamRequest
(mensagem)DeleteFirebaseLinkRequest
(mensagem)DeleteGoogleAdsLinkRequest
(mensagem)DeleteMeasurementProtocolSecretRequest
(mensagem)DeletePropertyRequest
(mensagem)FirebaseLink
(mensagem)GetAccountRequest
(mensagem)GetConversionEventRequest
(mensagem)GetCustomDimensionRequest
(mensagem)GetCustomMetricRequest
(mensagem)GetDataRetentionSettingsRequest
(mensagem)GetDataSharingSettingsRequest
(mensagem)GetDataStreamRequest
(mensagem)GetMeasurementProtocolSecretRequest
(mensagem)GetPropertyRequest
(mensagem)GoogleAdsLink
(mensagem)IndustryCategory
(enum)ListAccountSummariesRequest
(mensagem)ListAccountSummariesResponse
(mensagem)ListAccountsRequest
(mensagem)ListAccountsResponse
(mensagem)ListConversionEventsRequest
(mensagem)ListConversionEventsResponse
(mensagem)ListCustomDimensionsRequest
(mensagem)ListCustomDimensionsResponse
(mensagem)ListCustomMetricsRequest
(mensagem)ListCustomMetricsResponse
(mensagem)ListDataStreamsRequest
(mensagem)ListDataStreamsResponse
(mensagem)ListFirebaseLinksRequest
(mensagem)ListFirebaseLinksResponse
(mensagem)ListGoogleAdsLinksRequest
(mensagem)ListGoogleAdsLinksResponse
(mensagem)ListMeasurementProtocolSecretsRequest
(mensagem)ListMeasurementProtocolSecretsResponse
(mensagem)ListPropertiesRequest
(mensagem)ListPropertiesResponse
(mensagem)MeasurementProtocolSecret
(mensagem)NumericValue
(mensagem)Property
(mensagem)PropertySummary
(mensagem)PropertyType
(enum)ProvisionAccountTicketRequest
(mensagem)ProvisionAccountTicketResponse
(mensagem)RunAccessReportRequest
(mensagem)RunAccessReportResponse
(mensagem)SearchChangeHistoryEventsRequest
(mensagem)SearchChangeHistoryEventsResponse
(mensagem)ServiceLevel
(enum)UpdateAccountRequest
(mensagem)UpdateConversionEventRequest
(mensagem)UpdateCustomDimensionRequest
(mensagem)UpdateCustomMetricRequest
(mensagem)UpdateDataRetentionSettingsRequest
(mensagem)UpdateDataStreamRequest
(mensagem)UpdateGoogleAdsLinkRequest
(mensagem)UpdateMeasurementProtocolSecretRequest
(mensagem)UpdatePropertyRequest
(mensagem)
AnalyticsAdminService
Interface de serviço da API Admin do Google Analytics (GA4).
AcknowledgeUserDataCollection |
---|
Reconhece os termos de coleta de dados do usuário para a propriedade especificada. Essa confirmação precisa ser concluída (na interface do Google Analytics ou por meio desta API) antes da criação dos recursos Measurement ProtocolSecret.
|
ArchiveCustomDimension |
---|
Arquiva uma CustomDimension em uma propriedade.
|
ArchiveCustomMetric |
---|
Arquiva uma CustomMetric em uma propriedade.
|
CreateConversionEvent |
---|
Cria um evento de conversão com os atributos especificados.
|
CreateCustomDimension |
---|
Cria uma CustomDimension.
|
CreateCustomMetric |
---|
Cria uma CustomMetric.
|
CreateDataStream |
---|
Cria um DataStream.
|
CreateFirebaseLink |
---|
Cria um FirebaseLink. As propriedades podem ter no máximo um FirebaseLink.
|
CreateGoogleAdsLink |
---|
Cria um GoogleAdsLink.
|
CreateMeasurementProtocolSecret |
---|
Cria uma chave secreta do Measurement Protocol.
|
CreateProperty |
---|
Cria uma propriedade do "GA4" com o local e os atributos especificados.
|
DeleteAccount |
---|
Marca a conta de destino como excluída de forma reversível (ou seja: "lixeira") e a retorna. Essa API não tem um método para restaurar contas excluídas de maneira reversível. No entanto, elas podem ser restauradas usando a interface da lixeira. Se as contas não forem restauradas antes do prazo de validade, elas e todos os recursos secundários (por exemplo, Propriedades, GoogleAdsLinks, Streams, AccessBindings) serão eliminados permanentemente. https://support.google.com/analytics/answer/6154772 Retornará um erro se o destino não for encontrado.
|
DeleteConversionEvent |
---|
Exclui um evento de conversão em uma propriedade.
|
DeleteDataStream |
---|
Exclui um DataStream em uma propriedade.
|
DeleteFirebaseLink |
---|
Exclui um FirebaseLink em uma propriedade
|
DeleteGoogleAdsLink |
---|
Exclui um GoogleAdsLink em uma propriedade
|
DeleteMeasurementProtocolSecret |
---|
Exclui o Measurement ProtocolSecret de destino.
|
DeleteProperty |
---|
Marca a propriedade de destino como excluída de forma reversível (ou seja: "lixeira") e a retorna. Essa API não tem um método para restaurar propriedades excluídas de forma reversível. No entanto, elas podem ser restauradas usando a interface da lixeira. Se as propriedades não forem restauradas antes do prazo de validade, a propriedade e todos os recursos filhos (por exemplo: GoogleAdsLinks, Streams, AccessBindings) serão limpos permanentemente. https://support.google.com/analytics/answer/6154772 Retornará um erro se o destino não for encontrado ou não for uma propriedade do GA4.
|
GetAccount |
---|
Procurar uma única conta.
|
GetConversionEvent |
---|
Recuperar um único evento de conversão.
|
GetCustomDimension |
---|
Busca uma única CustomDimension.
|
GetCustomMetric |
---|
Procura uma única CustomMetric.
|
GetDataRetentionSettings |
---|
Retorna as configurações de retenção de dados do singleton desta propriedade.
|
GetDataSharingSettings |
---|
Acessar as configurações de compartilhamento de dados de uma conta. As configurações de compartilhamento de dados são Singletons.
|
GetDataStream |
---|
Procurar um único DataStream.
|
GetMeasurementProtocolSecret |
---|
Busca um único Measurement ProtocolSecret do "GA4".
|
GetProperty |
---|
Procurar uma única propriedade "GA4".
|
ListAccountSummaries |
---|
Retorna resumos de todas as contas acessíveis pelo autor da chamada.
|
ListAccounts |
---|
Retorna todas as contas acessíveis pelo autor da chamada. Essas contas talvez não tenham propriedades do GA4 no momento. As contas excluídas de forma reversível (ou seja, na "lixeira") são excluídas por padrão. Retorna uma lista vazia se nenhuma conta relevante for encontrada.
|
ListConversionEvents |
---|
Retorna uma lista de eventos de conversão na propriedade mãe especificada. Retorna uma lista vazia se nenhum evento de conversão for encontrado.
|
ListCustomDimensions |
---|
Lista as dimensões personalizadas de uma propriedade.
|
ListCustomMetrics |
---|
Lista CustomMetrics em uma propriedade.
|
ListDataStreams |
---|
Lista o DataStreams em uma propriedade.
|
ListFirebaseLinks |
---|
Lista FirebaseLinks em uma propriedade. As propriedades podem ter no máximo um FirebaseLink.
|
ListGoogleAdsLinks |
---|
Lista GoogleAdsLinks em uma propriedade.
|
ListMeasurementProtocolSecrets |
---|
Retorna Measurement ProtocolSecrets filhos da propriedade pai especificada.
|
ListProperties |
---|
Retorna Propriedades filhas na conta pai especificada. Somente as propriedades do "GA4" serão retornadas. As propriedades serão excluídas se o autor da chamada não tiver acesso. As propriedades excluídas de forma reversível (ou seja: "lixeira") são excluídas por padrão. Retorna uma lista vazia se nenhuma propriedade relevante for encontrada.
|
ProvisionAccountTicket |
---|
Solicita um tíquete para criar uma conta.
|
RunAccessReport |
---|
Retorna um relatório personalizado de registros de acesso a dados. O relatório fornece registros de cada vez que um usuário lê os dados de relatório do Google Analytics. Os registros de acesso são mantidos por até dois anos. É possível solicitar relatórios de acesso aos dados para uma propriedade. Os relatórios podem ser solicitados para qualquer propriedade, mas as dimensões não relacionadas à cota só podem ser solicitadas nas propriedades do Google Analytics 360. Esse método só está disponível para administradores. Esses registros de acesso a dados incluem relatórios da interface do GA4, Análises detalhadas da interface do GA4, API GA4 Data e outros produtos, como o Firebase e a AdMob, que podem recuperar dados do Google Analytics usando uma vinculação. Esses registros não incluem mudanças de configuração da propriedade, como adicionar um fluxo ou mudar o fuso horário de uma propriedade. Para acessar o histórico de alterações de configuração, consulte searchChangeHistoryEvents.
|
SearchChangeHistoryEvents |
---|
Pesquisa todas as alterações feitas em uma conta ou nos filhos dela de acordo com o conjunto de filtros especificado.
|
UpdateAccount |
---|
Atualiza uma conta.
|
UpdateConversionEvent |
---|
Atualiza um evento de conversão com os atributos especificados.
|
UpdateCustomDimension |
---|
Atualiza uma CustomDimension em uma propriedade.
|
UpdateCustomMetric |
---|
Atualiza uma CustomMetric em uma propriedade.
|
UpdateDataRetentionSettings |
---|
Atualiza as configurações de retenção de dados do Singleton para esta propriedade.
|
UpdateDataStream |
---|
Atualiza um DataStream em uma propriedade.
|
UpdateGoogleAdsLink |
---|
Atualiza um GoogleAdsLink em uma propriedade
|
UpdateMeasurementProtocolSecret |
---|
Atualiza uma chave secreta do Measurement Protocol.
|
UpdateProperty |
---|
Atualiza uma propriedade.
|
AccessBetweenFilter
Para expressar que o resultado precisa estar entre dois números (inclusive).
Campos | |
---|---|
from_value |
Começa com este número. |
to_value |
Termina com este número. |
AccessDateRange
Um intervalo contíguo de dias: startDate, startDate + 1, ..., endDate.
Campos | |
---|---|
start_date |
A data de início inclusiva para a consulta no formato |
end_date |
A data de término inclusiva da consulta no formato |
AccessDimension
As dimensões são atributos dos seus dados. Por exemplo, a dimensão userEmail
indica o e-mail do usuário que acessou os dados do relatório. Os valores de dimensão nas respostas do relatório são strings.
Campos | |
---|---|
dimension_name |
O nome da API da dimensão. Consulte Esquema de acesso a dados para ver a lista de dimensões compatíveis com essa API. As dimensões são referenciadas por nome em |
AccessDimensionHeader
Descreve uma coluna de dimensão no relatório. As dimensões solicitadas em um relatório produzem entradas de coluna nas linhas e DimensionHeaders. No entanto, as dimensões usadas exclusivamente em filtros ou expressões não produzem colunas em um relatório; portanto, essas dimensões não produzem cabeçalhos.
Campos | |
---|---|
dimension_name |
O nome da dimensão, por exemplo, "userEmail". |
AccessDimensionValue
O valor de uma dimensão.
Campos | |
---|---|
value |
O valor da dimensão. Por exemplo, esse valor pode ser "França" para a dimensão "país". |
AccessFilter
Uma expressão para filtrar valores de dimensão ou métrica.
Campos | |
---|---|
field_name |
O nome da dimensão ou da métrica. |
Campo de união one_filter . Especifique um tipo de filtro para Filter . one_filter pode ser apenas de um dos tipos a seguir: |
|
string_filter |
Filtro relacionado a strings. |
in_list_filter |
Um filtro para valores na lista. |
numeric_filter |
Um filtro para valores numéricos ou de data. |
between_filter |
Um filtro para dois valores. |
AccessFilterExpression
Expressa filtros de dimensão ou métrica. Os campos na mesma expressão precisam ser todas as dimensões ou todas as métricas.
Campos | |
---|---|
Campo de união one_expression . Especifique um tipo de expressão de filtro para FilterExpression . one_expression pode ser apenas de um dos tipos a seguir: |
|
and_group |
Cada um dos FilterExpressions em and_group tem uma relação AND. |
or_group |
Cada um dos FilterExpressions no or_group tem um relacionamento OR. |
not_expression |
A FilterExpression NÃO é de not_expression. |
access_filter |
Um filtro primitivo. Na mesma FilterExpression, todos os nomes de campo do filtro precisam ser todas as dimensões ou todas as métricas. |
AccessFilterExpressionList
Uma lista de expressões de filtro.
Campos | |
---|---|
expressions[] |
Uma lista de expressões de filtro. |
AccessInListFilter
O resultado precisa estar em uma lista de valores de string.
Campos | |
---|---|
values[] |
A lista de valores de string. Não pode estar em branco. |
case_sensitive |
Se verdadeiro, o valor da string diferencia maiúsculas de minúsculas. |
AccessMetric
As medições quantitativas de um relatório. Por exemplo, a métrica accessCount
é o número total de registros de acesso a dados.
Campos | |
---|---|
metric_name |
O nome da API da métrica. Consulte Esquema de acesso a dados para ver a lista de métricas compatíveis com essa API. As métricas são referenciadas por nome em |
AccessMetricHeader
Descreve uma coluna de métrica no relatório. As métricas visíveis solicitadas em um relatório produzem entradas de coluna nas linhas e MetricHeaders. No entanto, as métricas usadas exclusivamente em filtros ou expressões não produzem colunas em um relatório, ou seja, elas não produzem cabeçalhos.
Campos | |
---|---|
metric_name |
O nome da métrica, por exemplo, "accessCount". |
AccessMetricValue
O valor de uma métrica.
Campos | |
---|---|
value |
O valor de medição. Por exemplo, este valor pode ser "13". |
AccessNumericFilter
Filtra os valores numéricos ou de data.
Campos | |
---|---|
operation |
O tipo de operação para este filtro. |
value |
Um valor numérico ou um valor de data. |
Operação
A operação aplicada a um filtro numérico.
Enums | |
---|---|
OPERATION_UNSPECIFIED |
Não especificado. |
EQUAL |
Igual |
LESS_THAN |
Menor que |
LESS_THAN_OR_EQUAL |
menor ou igual a |
GREATER_THAN |
maior que |
GREATER_THAN_OR_EQUAL |
maior ou igual a |
AccessOrderBy
A ordenação por define como as linhas serão classificadas na resposta. Por exemplo, ordenar linhas pela contagem de acesso decrescente é uma ordem, e ordenar linhas pela string de país é uma ordem diferente.
Campos | |
---|---|
desc |
Se verdadeiro, classifica por ordem decrescente. Se for falso ou não especificado, classifica em ordem crescente. |
Campo de união one_order_by . Especifique um tipo de ordem por para OrderBy . one_order_by pode ser apenas de um dos tipos a seguir: |
|
metric |
Classifica os resultados pelos valores de uma métrica. |
dimension |
Classifica os resultados pelos valores de uma dimensão. |
DimensionOrderBy
Classifica por valores de dimensão.
Campos | |
---|---|
dimension_name |
Um nome de dimensão na solicitação para ordenar. |
order_type |
Controla a regra de ordenação de valores de dimensão. |
OrderType
Regra para ordenar os valores de dimensão da string.
Enums | |
---|---|
ORDER_TYPE_UNSPECIFIED |
Não especificado. |
ALPHANUMERIC |
Classificação alfanumérica por ponto de código Unicode. Por exemplo, "2" < "A" < "X" < "b" < "z". |
CASE_INSENSITIVE_ALPHANUMERIC |
Classificação alfanumérica sem distinção entre maiúsculas e minúsculas por ponto de código Unicode em minúsculas. Por exemplo, "2" < "A" < "b" < "X" < "z". |
NUMERIC |
Os valores de dimensão são convertidos em números antes da classificação. Por exemplo, na classificação NUMERIC, "25" < "100" e na classificação ALPHANUMERIC , "100" < "25". Todos os valores de dimensão não numéricos têm um valor de ordem igual abaixo de todos os valores numéricos. |
MetricOrderBy
Classifica por valores de métricas.
Campos | |
---|---|
metric_name |
Um nome de métrica na solicitação para ordenar. |
AccessQuota
Estado atual de todas as cotas desta propriedade do Google Analytics. Se alguma cota de uma propriedade se esgotar, todas as solicitações para essa propriedade retornarão erros de recursos esgotados.
Campos | |
---|---|
tokens_per_day |
As propriedades podem usar 250.000 tokens por dia. A maioria das solicitações consome menos de 10 tokens. |
tokens_per_hour |
As propriedades podem usar 50 mil tokens por hora. Uma solicitação de API consome um único número de tokens, que é deduzido de todas as cotas por hora, diárias e por hora do projeto. |
concurrent_requests |
As propriedades podem usar até 50 solicitações simultâneas. |
server_errors_per_project_per_hour |
Os pares de propriedades e projetos na nuvem podem ter até 50 erros de servidor por hora. |
tokens_per_project_per_hour |
As propriedades podem usar até 25% dos tokens por projeto e por hora. Assim,as propriedades do Analytics 360 podem usar 12.500 tokens por projeto e hora. Uma solicitação de API consome um único número de tokens, que é deduzido de todas as cotas por hora, diárias e por hora do projeto. |
AccessQuotaStatus
Estado atual de um determinado grupo de cotas.
Campos | |
---|---|
consumed |
Cota consumida por esta solicitação. |
remaining |
Cota restante após essa solicitação. |
AccessRow
Acesse os dados do relatório de cada linha.
Campos | |
---|---|
dimension_values[] |
Lista de valores de dimensão. Esses valores estão na mesma ordem especificada na solicitação. |
metric_values[] |
Lista de valores de métricas. Esses valores estão na mesma ordem especificada na solicitação. |
AccessStringFilter
O filtro para strings.
Campos | |
---|---|
match_type |
O tipo de correspondência para este filtro. |
value |
O valor da string usado para a correspondência. |
case_sensitive |
Se verdadeiro, o valor da string diferencia maiúsculas de minúsculas. |
MatchType
O tipo de correspondência de um filtro de string.
Enums | |
---|---|
MATCH_TYPE_UNSPECIFIED |
Não especificado |
EXACT |
Correspondência exata do valor da string. |
BEGINS_WITH |
Começa com o valor da string. |
ENDS_WITH |
Termina com o valor da string. |
CONTAINS |
Contém o valor da string. |
FULL_REGEXP |
Correspondência total para a expressão regular com o valor da string. |
PARTIAL_REGEXP |
Correspondência parcial da expressão regular com o valor da string. |
Conta
Uma mensagem de recurso que representa uma conta do Google Analytics.
Campos | |
---|---|
name |
Apenas saída. Nome do recurso desta conta. Formato: accounts/{account} Exemplo: "accounts/100" |
create_time |
Apenas saída. Hora em que a conta foi criada originalmente. |
update_time |
Apenas saída. Horário em que os campos de payload da conta foram atualizados pela última vez. |
display_name |
Obrigatório. Nome de exibição legível por humanos para esta conta. |
region_code |
País da empresa. Precisa ser um código de região Unicode CLDR. |
deleted |
Apenas saída. Indica se esta conta foi excluída de forma reversível ou não. As contas excluídas são excluídas dos resultados da Lista, a menos que seja especificamente solicitado. |
AccountSummary
Um recurso virtual que representa uma visão geral de uma conta e de todas as propriedades filhas do GA4.
Campos | |
---|---|
name |
Nome do recurso para este resumo da conta. Formato: accountSummaries/{account_id} Exemplo: "accountSummaries/1000" |
account |
Nome do recurso da conta a que este resumo da conta se refere Formato: accounts/{account_id}. Exemplo: "accounts/1000" |
display_name |
Nome de exibição da conta mencionada neste resumo. |
property_summaries[] |
Lista de resumos para contas filhas desta conta. |
AcknowledgeUserDataCollectionRequest
Mensagem de solicitação para RPC ConfirmUserDataCollection.
Campos | |
---|---|
property |
Obrigatório. A propriedade em que a coleta de dados do usuário será confirmada. |
acknowledgement |
Obrigatório. Uma confirmação de que o autor da chamada desse método entende os termos de coleta de dados do usuário. Esse campo precisa conter o valor exato: "Confirmo que tenho as declarações e os direitos de privacidade necessários dos meus usuários finais para coleta e processamento dos dados deles, incluindo a associação desses dados às informações de visitas que o Google Analytics coleta da minha propriedade de site e/ou app". |
AcknowledgeUserDataCollectionResponse
Esse tipo não tem campos.
Mensagem de resposta para RPC ConfirmUserDataCollection.
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. |
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 actor_email. |
SYSTEM |
Alterações feitas pelo sistema do Google Analytics. |
SUPPORT |
Alterações feitas pela equipe de suporte do Google Analytics. |
ArchiveCustomDimensionRequest
Mensagem de solicitação para RPC ArchiveCustomDimension.
Campos | |
---|---|
name |
Obrigatório. O nome da CustomDimension a ser arquivada. Exemplo de formato: Properties/1234/customDimensões/5678 |
ArchiveCustomMetricRequest
Mensagem de solicitação para a RPC ArchiveCustomMetric.
Campos | |
---|---|
name |
Obrigatório. O nome da CustomMetric a ser arquivada. Exemplo de formato: properties/1234/customMetrics/5678 |
ChangeHistoryChange
A descrição de uma alteração em um único recurso do Google Analytics.
Campos | |
---|---|
resource |
Nome do recurso com as alterações descritas por esta entrada. |
action |
O tipo de ação que alterou esse recurso. |
resource_before_change |
Conteúdo do recurso anterior à mudança. Se o recurso tiver sido criado nesta alteração, este campo não estará presente. |
resource_after_change |
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.
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. |
firebase_link |
Um resumo de um recurso FirebaseLink no histórico de alterações. |
google_ads_link |
Um resumo de um recurso do GoogleAdsLink no histórico de alterações. |
conversion_event |
Um instantâneo de um recurso ConversionEvent no histórico de alterações. |
measurement_protocol_secret |
Um resumo de um recurso Measurement ProtocolSecret no histórico de alterações. |
data_retention_settings |
Um resumo de um recurso de configurações de retenção de dados no histórico de alterações. |
data_stream |
Um resumo de um recurso do DataStream no histórico de alterações. |
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.
Campos | |
---|---|
id |
ID deste evento do histórico de alterações. Esse ID é exclusivo no Google Analytics. |
change_time |
Horário em que a alteração foi feita. |
actor_type |
O tipo de ator que fez a alteração. |
user_actor_email |
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. |
changes_filtered |
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. |
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 |
ConversionEvent
Um evento de conversão em uma propriedade do Google Analytics.
Campos | |
---|---|
name |
Apenas saída. Nome do recurso desse evento de conversão. Formato: Properties/{property}/conversionEvents/{conversion_event} |
event_name |
Imutável. O nome deste evento de conversão. Exemplos: "click", "purchase" |
create_time |
Apenas saída. Horário em que esse evento de conversão foi criado na propriedade. |
deletable |
Apenas saída. Se definido, esse evento poderá ser excluído com DeleteConversionEvent. |
custom |
Apenas saída. Se definido como verdadeiro, esse evento de conversão vai se referir a um evento personalizado. Se definido como "falso", esse evento de conversão se refere a um evento padrão no GA. Os eventos padrão geralmente têm um significado especial no GA. Os eventos padrão geralmente são criados pelo sistema do GA, mas, em alguns casos, podem ser criados pelos administradores da propriedade. Os eventos personalizados são contabilizados no número máximo de eventos de conversão personalizados que podem ser criados por propriedade. |
counting_method |
Opcional. O método pelo qual as conversões serão contadas em vários eventos de uma sessão. Se esse valor não for fornecido, ele será definido como |
default_conversion_value |
Opcional. Define um valor/moeda padrão para um evento de conversão. |
ConversionCountingMethod
O método pelo qual as conversões serão contadas em vários eventos de uma sessão.
Enums | |
---|---|
CONVERSION_COUNTING_METHOD_UNSPECIFIED |
Método de contagem não especificado. |
ONCE_PER_EVENT |
Cada instância de evento é considerada uma conversão. |
ONCE_PER_SESSION |
Uma instância de evento é considerada uma conversão no máximo uma vez por sessão por usuário. |
DefaultConversionValue
Define um valor/moeda padrão para um evento de conversão. É preciso fornecer o valor e a moeda.
Campos | |
---|---|
value |
Esse valor será usado para preencher o valor de todas as conversões do event_name especificado em que o parâmetro "value" não está definido. |
currency_code |
Quando um evento de conversão para esse event_name não tiver uma moeda definida, ela será aplicada como padrão. Precisa estar no formato de código de moeda ISO 4217. Consulte https://en.wikipedia.org/wiki/ISO_4217 para mais informações. |
CreateConversionEventRequest
Mensagem de solicitação para RPC CreateConversionEvent
Campos | |
---|---|
conversion_event |
Obrigatório. O evento de conversão a ser criado. |
parent |
Obrigatório. O nome do recurso da propriedade mãe em que esse evento de conversão será criado. Formato: propriedades/123 |
CreateCustomDimensionRequest
Mensagem de solicitação para RPC CreateCustomDimension.
Campos | |
---|---|
parent |
Obrigatório. Exemplo de formato: properties/1234 |
custom_dimension |
Obrigatório. A CustomDimension a ser criada. |
CreateCustomMetricRequest
Mensagem de solicitação para RPC CreateCustomMetric.
Campos | |
---|---|
parent |
Obrigatório. Exemplo de formato: properties/1234 |
custom_metric |
Obrigatório. A CustomMetric a ser criado. |
CreateDataStreamRequest
Mensagem de solicitação para RPC CreateDataStream.
Campos | |
---|---|
parent |
Obrigatório. Exemplo de formato: properties/1234 |
data_stream |
Obrigatório. O DataStream a ser criado. |
CreateFirebaseLinkRequest
Mensagem de solicitação para RPC CreateFirebaseLink
Campos | |
---|---|
parent |
Obrigatório. Formato: propriedades/{property_id} Exemplo: properties/1234 |
firebase_link |
Obrigatório. O link do Firebase a ser criado. |
CreateGoogleAdsLinkRequest
Mensagem de solicitação para RPC CreateGoogleAdsLink
Campos | |
---|---|
parent |
Obrigatório. Exemplo de formato: properties/1234 |
google_ads_link |
Obrigatório. O GoogleAdsLink a ser criado. |
CreateMeasurementProtocolSecretRequest
Mensagem de solicitação para RPC CreateMeasurementProtocoloSecret
Campos | |
---|---|
parent |
Obrigatório. O recurso pai em que este secret será criado. Formato: Properties/{property}/dataStreams/{dataStream} |
measurement_protocol_secret |
Obrigatório. A chave secreta do Measurement Protocol a ser criada. |
CreatePropertyRequest
Mensagem de solicitação para RPC CreateProperty.
Campos | |
---|---|
property |
Obrigatório. A propriedade a ser criada. Observação: a propriedade fornecida precisa especificar a mãe. |
CustomDimension
Uma definição para uma CustomDimension.
Campos | |
---|---|
name |
Apenas saída. Nome do recurso para este recurso CustomDimension. Formato: Properties/{property}/customDimensões/{customDimension} |
parameter_name |
Obrigatório. Imutável. Nome do parâmetro de inclusão de tags dessa dimensão personalizada. No caso de uma dimensão no escopo do usuário, esse vai ser o nome da propriedade do usuário. Se for uma dimensão no escopo do evento, esse vai ser o nome do parâmetro de evento. Se for uma dimensão no escopo do item, esse vai ser o nome do parâmetro encontrado na matriz de itens de e-commerce. Pode conter apenas caracteres alfanuméricos e sublinhado, começando com uma letra. Comprimento máximo de 24 caracteres para dimensões no escopo do usuário e 40 caracteres para dimensões no escopo do evento. |
display_name |
Obrigatório. Nome de exibição dessa dimensão personalizada, conforme mostrado na interface do Google Analytics. Comprimento máximo de 82 caracteres, alfanuméricos mais espaço e sublinhado começando com uma letra. Nomes de exibição gerados pelo sistema legados podem conter colchetes, mas as atualizações nesse campo nunca permitirão colchetes. |
description |
Opcional. Descrição dessa dimensão personalizada. Comprimento máximo de 150 caracteres. |
scope |
Obrigatório. Imutável. O escopo dessa dimensão. |
disallow_ads_personalization |
Opcional. Se definida como verdadeira, a dimensão será definida como NPA e será excluída da personalização de anúncios. No momento, isso só é compatível com dimensões personalizadas no escopo do usuário. |
DimensionScope
Valores válidos para o escopo desta dimensão.
Enums | |
---|---|
DIMENSION_SCOPE_UNSPECIFIED |
Escopo desconhecido ou não especificado. |
EVENT |
Dimensão com escopo para um evento. |
USER |
Dimensão com escopo para um usuário. |
ITEM |
Dimensão no escopo para itens de e-commerce |
CustomMetric
A definição de uma métrica personalizada.
Campos | |
---|---|
name |
Apenas saída. Nome do recurso para este recurso CustomMetric. Formato: Properties/{property}/customMetrics/{customMetric} |
parameter_name |
Obrigatório. Imutável. Nome da marcação desta métrica personalizada. Se a métrica for no escopo do evento, esse vai ser o nome do parâmetro do evento. Pode conter apenas caracteres alfanuméricos e sublinhado, começando com uma letra. Comprimento máximo de 40 caracteres para métricas no escopo do evento. |
display_name |
Obrigatório. Nome de exibição dessa métrica personalizada, conforme mostrado na interface do Google Analytics. Comprimento máximo de 82 caracteres, alfanuméricos mais espaço e sublinhado começando com uma letra. Nomes de exibição gerados pelo sistema legados podem conter colchetes, mas as atualizações nesse campo nunca permitirão colchetes. |
description |
Opcional. Descrição dessa dimensão personalizada. Comprimento máximo de 150 caracteres. |
measurement_unit |
Obrigatório. O tipo do valor da métrica personalizada. |
scope |
Obrigatório. Imutável. O escopo dessa métrica personalizada. |
restricted_metric_type[] |
Opcional. Tipos de dados restritos que essa métrica pode conter. Obrigatório para métricas com unidade de medida CURRENCY. Precisa estar vazio para métricas com uma unidade de medida que não seja CURRENCY. |
MeasurementUnit
Tipos possíveis de representação do valor da métrica personalizada.
A representação da moeda pode mudar no futuro, exigindo uma alteração interruptiva na API.
Enums | |
---|---|
MEASUREMENT_UNIT_UNSPECIFIED |
MeasurementUnit não especificado ou ausente. |
STANDARD |
Essa métrica usa unidades padrão. |
CURRENCY |
Essa métrica avalia uma moeda. |
FEET |
Esta métrica mede pés. |
METERS |
Esta métrica mede metros. |
KILOMETERS |
Esta métrica mede quilômetros. |
MILES |
Esta métrica mede milhas. |
MILLISECONDS |
Esta métrica mede milissegundos. |
SECONDS |
Esta métrica mede segundos. |
MINUTES |
Essa métrica mede em minutos. |
HOURS |
Esta métrica mede horas. |
MetricScope
O escopo dessa métrica.
Enums | |
---|---|
METRIC_SCOPE_UNSPECIFIED |
Escopo desconhecido ou não especificado. |
EVENT |
Métrica com escopo para um evento. |
RestrictedMetricType
Rótulos que marcam os dados nessa métrica personalizada como dados que precisam ser restritos a usuários específicos.
Enums | |
---|---|
RESTRICTED_METRIC_TYPE_UNSPECIFIED |
Tipo desconhecido ou não especificado. |
COST_DATA |
A métrica gera relatórios de dados de custo. |
REVENUE_DATA |
A métrica informa dados de receita. |
DataRetentionSettings
Valores de configurações para retenção de dados. Este é um recurso de singleton.
Campos | |
---|---|
name |
Apenas saída. Nome do recurso DataRetençãoSetting. Formato: Properties/{property}/dataretentionSettings |
event_data_retention |
O período em que os dados de evento são retidos. |
reset_user_data_on_new_activity |
Se verdadeiro, redefine o período de retenção do identificador do usuário a cada evento desse usuário. |
RetentionDuration
Valores válidos para a duração da retenção de dados.
Enums | |
---|---|
RETENTION_DURATION_UNSPECIFIED |
A duração do tempo de retenção de dados não é especificada. |
TWO_MONTHS |
A duração do tempo de retenção de dados é de dois meses. |
FOURTEEN_MONTHS |
A duração do tempo de retenção de dados é de 14 meses. |
TWENTY_SIX_MONTHS |
A duração do tempo de retenção de dados é de 26 meses. Disponível apenas para propriedades do 360. |
THIRTY_EIGHT_MONTHS |
A duração do tempo de retenção de dados é de 38 meses. Disponível apenas para propriedades do 360. |
FIFTY_MONTHS |
A duração do tempo de retenção de dados é de 50 meses. Disponível apenas para propriedades do 360. |
DataSharingSettings
Uma mensagem de recurso que representa as configurações de compartilhamento de dados de uma conta do Google Analytics.
Campos | |
---|---|
name |
Apenas saída. Nome do recurso. Formato: accounts/{account}/dataSharingSettings Exemplo: "accounts/1000/dataSharingSettings" |
sharing_with_google_support_enabled |
Permite que o suporte do Google acesse os dados para ajudar a resolver problemas. |
sharing_with_google_assigned_sales_enabled |
Permite que as equipes de vendas do Google atribuídas ao cliente acessem os dados para sugerir alterações na configuração e melhorar os resultados. As restrições para a equipe de vendas ainda se aplicam quando ativadas. |
sharing_with_google_any_sales_enabled |
Permite que qualquer equipe de vendas do Google acesse os dados para sugerir alterações de configuração e melhorar os resultados. |
sharing_with_google_products_enabled |
Permite que o Google use os dados para melhorar outros produtos ou serviços. |
sharing_with_others_enabled |
Permite que o Google compartilhe os dados de forma anônima com outras pessoas. |
DataStream
Uma mensagem de recurso que representa um fluxo de dados.
Campos | |
---|---|
name |
Apenas saída. Nome do recurso deste fluxo de dados. Formato: properties/{property_id}/dataStreams/{stream_id} Exemplo: "properties/1000/dataStreams/2000" |
type |
Obrigatório. Imutável. O tipo desse recurso do DataStream. |
display_name |
Nome de exibição legível para o fluxo de dados. Obrigatório para fluxos de dados da Web. O comprimento máximo permitido para o nome de exibição é de 255 unidades de código UTF-16. |
create_time |
Apenas saída. Hora em que a transmissão foi criada. |
update_time |
Apenas saída. Horário em que os campos de payload do stream foram atualizados pela última vez. |
Campo de união stream_data . Dados para tipos específicos de fluxo de dados. A mensagem que será configurada corresponde ao tipo desse stream. stream_data pode ser apenas de um dos tipos a seguir: |
|
web_stream_data |
Dados específicos para fluxos da Web. Precisa ser preenchido se o tipo for WEB_DATA_STREAM. |
android_app_stream_data |
Dados específicos para fluxos do app Android. Precisa ser preenchido se o tipo for ANDROID_APP_DATA_STREAM. |
ios_app_stream_data |
Dados específicos para fluxos do app iOS. Precisa ser preenchido se o tipo for IOS_APP_DATA_STREAM. |
AndroidAppStreamData
Dados específicos para fluxos do app Android.
Campos | |
---|---|
firebase_app_id |
Apenas saída. ID do app Android correspondente no Firebase, se houver. Esse ID poderá mudar se o app Android for excluído e recriado. |
package_name |
Imutável. Nome do pacote do app que está sendo medido. Exemplo: "com.example.myandroidapp" |
DataStreamType
O tipo de fluxo de dados.
Enums | |
---|---|
DATA_STREAM_TYPE_UNSPECIFIED |
Tipo desconhecido ou não especificado. |
WEB_DATA_STREAM |
Fluxo de dados da Web. |
ANDROID_APP_DATA_STREAM |
Fluxo de dados do app Android. |
IOS_APP_DATA_STREAM |
Fluxo de dados do app iOS. |
IosAppStreamData
Dados específicos para fluxos do app iOS.
Campos | |
---|---|
firebase_app_id |
Apenas saída. O ID do app iOS correspondente no Firebase, se houver. Esse ID pode mudar se o app iOS for excluído e recriado. |
bundle_id |
Obrigatório. Imutável. O ID do pacote da Apple App Store para o aplicativo. Exemplo: "com.example.myiosapp" |
WebStreamData
Dados específicos para fluxos da Web.
Campos | |
---|---|
measurement_id |
Apenas saída. ID de métricas do Google Analytics. Exemplo: "G-1A2BCD345E" |
firebase_app_id |
Apenas saída. ID do app da Web correspondente no Firebase, se houver. Esse ID poderá mudar se o app da Web for excluído e recriado. |
default_uri |
Nome de domínio do app da Web que está sendo medido ou vazio. Exemplo: "http://www.google.com.br", "https://www.google.com.br" |
DeleteAccountRequest
Mensagem de solicitação para RPC DeleteAccount.
Campos | |
---|---|
name |
Obrigatório. O nome da conta a ser excluída de forma reversível. Formato: accounts/{account} Exemplo: "accounts/100" |
DeleteConversionEventRequest
Mensagem de solicitação para RPC DeleteConversionEvent
Campos | |
---|---|
name |
Obrigatório. O nome do recurso do evento de conversão a ser excluído. Formato: Properties/{property}/conversionEvents/{conversion_event}. Exemplo: "properties/123/conversionEvents/456" |
DeleteDataStreamRequest
Mensagem de solicitação para RPC DeleteDataStream.
Campos | |
---|---|
name |
Obrigatório. O nome do DataStream a ser excluído. Exemplo de formato: properties/1234/dataStreams/5678 |
DeleteFirebaseLinkRequest
Mensagem de solicitação para RPC DeleteFirebaseLink
Campos | |
---|---|
name |
Obrigatório. Formato: properties/{property_id}/firebaseLinks/{firebase_link_id} Exemplo: properties/1234/firebaseLinks/5678 |
DeleteGoogleAdsLinkRequest
Mensagem de solicitação para RPC DeleteGoogleAdsLink.
Campos | |
---|---|
name |
Obrigatório. Exemplo de formato: Properties/1234/googleAdsLinks/5678 |
DeleteMeasurementProtocolSecretRequest
Mensagem de solicitação para RPC DeleteMeasurementProtocoloSecret
Campos | |
---|---|
name |
Obrigatório. O nome do Measurement ProtocolSecret a ser excluído. Formato: Properties/{property}/dataStreams/{dataStream}/measurement ProtocolSecrets/{measurement ProtocolSecret} |
DeletePropertyRequest
Mensagem de solicitação para a RPC DeleteProperty.
Campos | |
---|---|
name |
Obrigatório. O nome da propriedade a ser excluída de forma reversível. Formato: propriedades/{property_id} Exemplo: "propriedades/1000" |
FirebaseLink
Uma vinculação entre uma propriedade do GA4 e um projeto do Firebase
Campos | |
---|---|
name |
Apenas saída. Exemplo de formato: Properties/1234/firebaseLinks/5678 |
project |
Imutável. Nome do recurso do projeto do Firebase. Ao criar um FirebaseLink, você pode fornecer esse nome de recurso usando um número ou ID do projeto. Depois que esse recurso for criado, os FirebaseLinks retornados sempre terão um project_name que contém um número de projeto. Formato: 'projects/{número do projeto}' Exemplo: 'projects/1234' |
create_time |
Apenas saída. Hora em que este FirebaseLink foi criado originalmente. |
GetAccountRequest
Mensagem de solicitação para RPC GetAccount.
Campos | |
---|---|
name |
Obrigatório. O nome da conta a ser consultada. Formato: accounts/{account} Exemplo: "accounts/100" |
GetConversionEventRequest
Mensagem de solicitação para RPC GetConversionEvent
Campos | |
---|---|
name |
Obrigatório. O nome do recurso do evento de conversão a ser recuperado. Formato: Properties/{property}/conversionEvents/{conversion_event}. Exemplo: "properties/123/conversionEvents/456" |
GetCustomDimensionRequest
Mensagem de solicitação para RPC GetCustomDimension.
Campos | |
---|---|
name |
Obrigatório. O nome da CustomDimension a ser obtida. Exemplo de formato: Properties/1234/customDimensões/5678 |
GetCustomMetricRequest
Mensagem de solicitação para RPC GetCustomMetric.
Campos | |
---|---|
name |
Obrigatório. O nome da CustomMetric a ser recebida. Exemplo de formato: properties/1234/customMetrics/5678 |
GetDataRetentionSettingsRequest
Mensagem de solicitação para a RPC GetDataRetainSettings.
Campos | |
---|---|
name |
Obrigatório. O nome das configurações a serem consultadas. Formato: properties/{property}/dataretentionSettings Exemplo: "properties/1000/dataretentionSettings" |
GetDataSharingSettingsRequest
Mensagem de solicitação para a RPC GetDataSharingSettings.
Campos | |
---|---|
name |
Obrigatório. O nome das configurações a serem consultadas. Formato: accounts/{account}/dataSharingSettings Exemplo: "accounts/1000/dataSharingSettings" |
GetDataStreamRequest
Mensagem de solicitação para RPC GetDataStream.
Campos | |
---|---|
name |
Obrigatório. O nome do DataStream a ser obtido. Exemplo de formato: properties/1234/dataStreams/5678 |
GetMeasurementProtocolSecretRequest
Mensagem de solicitação para RPC GetMeasurementProtocoloSecret.
Campos | |
---|---|
name |
Obrigatório. O nome do secret do Measurement Protocol a ser pesquisado. Formato: Properties/{property}/dataStreams/{dataStream}/measurement ProtocolSecrets/{measurement ProtocolSecret} |
GetPropertyRequest
Mensagem de solicitação para a RPC GetProperty.
Campos | |
---|---|
name |
Obrigatório. O nome da propriedade a ser pesquisada. Formato: propriedades/{property_id} Exemplo: "propriedades/1000" |
GoogleAdsLink
Uma vinculação entre uma propriedade do GA4 e uma conta do Google Ads.
Campos | |
---|---|
name |
Apenas saída. Formato: properties/{propertyId}/googleAdsLinks/{googleAdsLinkId} Observação: googleAdsLinkId não é o ID de cliente do Google Ads. |
customer_id |
Imutável. ID de cliente do Google Ads. |
can_manage_clients |
Apenas saída. Se verdadeiro, a vinculação é para uma conta de administrador do Google Ads. |
ads_personalization_enabled |
Ativar recursos de publicidade personalizados com essa integração. Publicar automaticamente minhas listas de público-alvo e os eventos/parâmetros de remarketing do Analytics a serem vinculados à conta do Google Ads. Se esse campo não for definido na criação/atualização, o padrão será "true". |
create_time |
Apenas saída. Hora em que o link foi criado originalmente. |
update_time |
Apenas saída. Hora em que o link foi atualizado pela última vez. |
creator_email_address |
Apenas saída. Endereço de e-mail do usuário que criou o link. Uma string vazia será retornada se o endereço de e-mail não puder ser recuperado. |
IndustryCategory
A categoria selecionada para essa propriedade, usada para comparações de mercado.
Enums | |
---|---|
INDUSTRY_CATEGORY_UNSPECIFIED |
Categoria do setor não especificada |
AUTOMOTIVE |
Automotivo |
BUSINESS_AND_INDUSTRIAL_MARKETS |
Mercados comercial e industrial |
FINANCE |
Finanças |
HEALTHCARE |
Saúde |
TECHNOLOGY |
Tecnologia |
TRAVEL |
Viagem |
OTHER |
Outros |
ARTS_AND_ENTERTAINMENT |
Artes e entretenimento |
BEAUTY_AND_FITNESS |
Beleza e condicionamento físico |
BOOKS_AND_LITERATURE |
Livros e literatura |
FOOD_AND_DRINK |
Alimentos e bebidas |
GAMES |
Jogos |
HOBBIES_AND_LEISURE |
Hobbies e lazer |
HOME_AND_GARDEN |
Casa e jardim |
INTERNET_AND_TELECOM |
Internet e telecomunicações |
LAW_AND_GOVERNMENT |
Legislação e governo |
NEWS |
Notícias |
ONLINE_COMMUNITIES |
Comunidades on-line |
PEOPLE_AND_SOCIETY |
Pessoas e sociedade |
PETS_AND_ANIMALS |
Animais de estimação e outros animais |
REAL_ESTATE |
Imóveis |
REFERENCE |
Referência |
SCIENCE |
Ciência |
SPORTS |
Esportes |
JOBS_AND_EDUCATION |
Empregos e educação |
SHOPPING |
Compras |
ListAccountSummariesRequest
Mensagem de solicitação para o RPC ListAccountSummaries.
Campos | |
---|---|
page_size |
O número máximo de recursos AccountSummary a serem retornados. O serviço pode retornar menos que esse valor, mesmo se houver páginas adicionais. Se não for especificado, no máximo 50 recursos serão retornados. O valor máximo é 200; (valores mais altos serão convertidos para o máximo) |
page_token |
Um token de página recebido de uma chamada |
ListAccountSummariesResponse
Mensagem de resposta para RPC ListAccountSummaries.
Campos | |
---|---|
account_summaries[] |
Resumos de todas as contas a que o autor da chamada tem acesso. |
next_page_token |
Um token, que pode ser enviado como |
ListAccountsRequest
Mensagem de solicitação para a RPC ListAccounts.
Campos | |
---|---|
page_size |
O número máximo de recursos a serem retornados. O serviço pode retornar menos que esse valor, mesmo se houver páginas adicionais. Se não for especificado, no máximo 50 recursos serão retornados. O valor máximo é 200; (valores mais altos serão convertidos para o máximo) |
page_token |
Um token de página recebido de uma chamada |
show_deleted |
Se contas excluídas de maneira reversível (ou seja: "lixadas") serão incluídas nos resultados. As contas podem ser inspecionadas para determinar se foram excluídas ou não. |
ListAccountsResponse
Mensagem de solicitação para a RPC ListAccounts.
Campos | |
---|---|
accounts[] |
Resultados que estavam acessíveis ao autor da chamada. |
next_page_token |
Um token, que pode ser enviado como |
ListConversionEventsRequest
Mensagem de solicitação para RPC ListConversionEvents
Campos | |
---|---|
parent |
Obrigatório. O nome do recurso da propriedade pai. Exemplo: "propriedades/123" |
page_size |
O número máximo de recursos a serem retornados. Se não for especificado, no máximo 50 recursos serão retornados. O valor máximo é 200; (valores mais altos serão convertidos para o máximo) |
page_token |
Um token de página recebido de uma chamada |
ListConversionEventsResponse
Mensagem de resposta para RPC ListConversionEvents.
Campos | |
---|---|
conversion_events[] |
Os eventos de conversão solicitados |
next_page_token |
Um token, que pode ser enviado como |
ListCustomDimensionsRequest
Mensagem de solicitação para RPC ListCustomDimensões.
Campos | |
---|---|
parent |
Obrigatório. Exemplo de formato: properties/1234 |
page_size |
O número máximo de recursos a serem retornados. Se não for especificado, no máximo 50 recursos serão retornados. O valor máximo é 200 (valores mais altos serão convertidos para o máximo). |
page_token |
Um token de página recebido de uma chamada Ao paginar, todos os outros parâmetros fornecidos para |
ListCustomDimensionsResponse
Mensagem de resposta para RPC ListCustomDimensões.
Campos | |
---|---|
custom_dimensions[] |
Lista de CustomDimensões. |
next_page_token |
Um token, que pode ser enviado como |
ListCustomMetricsRequest
Mensagem de solicitação para RPC ListCustomMetrics.
Campos | |
---|---|
parent |
Obrigatório. Exemplo de formato: properties/1234 |
page_size |
O número máximo de recursos a serem retornados. Se não for especificado, no máximo 50 recursos serão retornados. O valor máximo é 200 (valores mais altos serão convertidos para o máximo). |
page_token |
Um token de página recebido de uma chamada Ao paginar, todos os outros parâmetros fornecidos para |
ListCustomMetricsResponse
Mensagem de resposta para RPC ListCustomMetrics.
Campos | |
---|---|
custom_metrics[] |
Lista de CustomMetrics. |
next_page_token |
Um token, que pode ser enviado como |
ListDataStreamsRequest
Mensagem de solicitação para RPC ListDataStreams.
Campos | |
---|---|
parent |
Obrigatório. Exemplo de formato: properties/1234 |
page_size |
O número máximo de recursos a serem retornados. Se não for especificado, no máximo 50 recursos serão retornados. O valor máximo é 200 (valores mais altos serão convertidos para o máximo). |
page_token |
Um token de página recebido de uma chamada Ao paginar, todos os outros parâmetros fornecidos para |
ListDataStreamsResponse
Mensagem de resposta para RPC ListDataStreams.
Campos | |
---|---|
data_streams[] |
Lista de DataStreams. |
next_page_token |
Um token, que pode ser enviado como |
ListFirebaseLinksRequest
Mensagem de solicitação para RPC ListFirebaseLinks
Campos | |
---|---|
parent |
Obrigatório. Formato: propriedades/{property_id} Exemplo: properties/1234 |
page_size |
O número máximo de recursos a serem retornados. O serviço pode retornar menos que esse valor, mesmo se houver páginas adicionais. Se não for especificado, no máximo 50 recursos serão retornados. O valor máximo é 200; (valores mais altos serão convertidos para o máximo) |
page_token |
Um token de página recebido de uma chamada |
ListFirebaseLinksResponse
Mensagem de resposta para RPC ListFirebaseLinks
Campos | |
---|---|
firebase_links[] |
Lista de FirebaseLinks. Isso terá no máximo um valor. |
next_page_token |
Um token, que pode ser enviado como |
ListGoogleAdsLinksRequest
Mensagem de solicitação para RPC ListGoogleAdsLinks.
Campos | |
---|---|
parent |
Obrigatório. Exemplo de formato: properties/1234 |
page_size |
O número máximo de recursos a serem retornados. Se não for especificado, no máximo 50 recursos serão retornados. O valor máximo é 200 (valores mais altos serão convertidos para o máximo). |
page_token |
Um token de página recebido de uma chamada Ao paginar, todos os outros parâmetros fornecidos para |
ListGoogleAdsLinksResponse
Mensagem de resposta para RPC ListGoogleAdsLinks.
Campos | |
---|---|
google_ads_links[] |
Lista de GoogleAdsLinks. |
next_page_token |
Um token, que pode ser enviado como |
ListMeasurementProtocolSecretsRequest
Mensagem de solicitação para RPC ListMeasurement ProtocolSecret
Campos | |
---|---|
parent |
Obrigatório. O nome do recurso do stream pai. Formato: properties/{property}/dataStreams/{dataStream}/measurement ProtocolSecrets |
page_size |
O número máximo de recursos a serem retornados. Se não for especificado, no máximo 10 recursos serão retornados. O valor máximo é 10. Valores mais altos serão convertidos para o máximo. |
page_token |
Um token de página recebido de uma chamada |
ListMeasurementProtocolSecretsResponse
Mensagem de resposta para RPC ListMeasurement ProtocolSecret
Campos | |
---|---|
measurement_protocol_secrets[] |
Uma lista de secrets do stream pai especificado na solicitação. |
next_page_token |
Um token, que pode ser enviado como |
ListPropertiesRequest
Mensagem de solicitação para a RPC ListProperties.
Campos | |
---|---|
filter |
Obrigatório. Uma expressão para filtrar os resultados da solicitação. Os campos qualificados para filtragem são:
|
page_size |
O número máximo de recursos a serem retornados. O serviço pode retornar menos que esse valor, mesmo se houver páginas adicionais. Se não for especificado, no máximo 50 recursos serão retornados. O valor máximo é 200; (valores mais altos serão convertidos para o máximo) |
page_token |
Um token de página recebido de uma chamada |
show_deleted |
Define se as propriedades excluídas de maneira reversível (ou seja, "na lixeira") serão incluídas nos resultados. As propriedades podem ser inspecionadas para determinar se elas foram excluídas ou não. |
ListPropertiesResponse
Mensagem de resposta para a RPC ListProperties.
Campos | |
---|---|
properties[] |
Resultados que corresponderam aos critérios do filtro e estavam acessíveis para o autor da chamada. |
next_page_token |
Um token, que pode ser enviado como |
MeasurementProtocolSecret
Um valor secreto usado para enviar hits ao Measurement Protocol.
Campos | |
---|---|
name |
Apenas saída. Nome do recurso deste secret. Esse secret pode ser filho de qualquer tipo de stream. Formato: Properties/{property}/dataStreams/{dataStream}/measurement ProtocolSecrets/{measurement ProtocolSecret} |
display_name |
Obrigatório. Nome de exibição legível por humanos para este secret. |
secret_value |
Apenas saída. O valor secret do Measurement Protocol. Transmita esse valor ao campo api_secret da API Measurement Protocol ao enviar hits para a propriedade pai desse secret. |
NumericValue
Representar um número.
Campos | |
---|---|
Campo de união one_value . Um dos valores numéricos one_value pode ser apenas uma das seguintes opções: |
|
int64_value |
Número inteiro |
double_value |
Valor duplo |
Propriedade
Uma mensagem de recurso que representa uma propriedade do GA4 no Google Analytics.
Campos | |
---|---|
name |
Apenas saída. Nome do recurso desta propriedade. Formato: propriedades/{property_id} Exemplo: "propriedades/1000" |
property_type |
Imutável. O tipo de propriedade para este recurso de propriedade. Ao criar uma propriedade, se o tipo for "PROPERTY_TYPE_UNSPECIFIED", "ORDINARY_PROPERTY" ficará implícito. |
create_time |
Apenas saída. Horário em que a entidade foi criada originalmente. |
update_time |
Apenas saída. Horário em que os campos de payload da entidade foram atualizados pela última vez. |
parent |
Imutável. Nome do recurso do pai lógico dessa propriedade. Observação: a interface de movimentação de propriedades pode ser usada para alterar o pai. Formato: accounts/{account}, propriedades/{property} Exemplo: "accounts/100", "properties/101" |
display_name |
Obrigatório. Nome de exibição legível desta propriedade. O tamanho máximo permitido para o nome de exibição é de 100 unidades de código UTF-16. |
industry_category |
Setor associado a esta propriedade Exemplo: AUTOMOTIVE, FOOD_AND_DRINK |
time_zone |
Obrigatório. Fuso horário dos relatórios, usado como o limite do dia para relatórios, independentemente da origem dos dados. Caso o fuso horário siga o horário de verão, o Google Analytics fará os ajustes automaticamente. OBSERVAÇÃO: a alteração do fuso horário só afeta dados posteriores. Ela não é aplicada de forma retroativa. Formato: https://www.iana.org/time-zones (link em inglês). Exemplo: "America/Los_Angeles" |
currency_code |
O tipo de moeda usado em relatórios que envolvem valores monetários. Formato: https://en.wikipedia.org/wiki/ISO_4217. Exemplos: "USD", "EUR", "JPY" |
service_level |
Apenas saída. O nível de serviço do Google Analytics que se aplica a essa propriedade. |
delete_time |
Apenas saída. Se definido, a hora em que a propriedade foi enviada para a lixeira. Se não for definida, a propriedade não vai estar na lixeira. |
expire_time |
Apenas saída. Se definido, o horário em que essa propriedade na lixeira será excluída permanentemente. Se não for definida, a propriedade não vai estar na lixeira nem está programada para ser excluída. |
account |
Imutável. O nome do recurso do formato da conta mãe: accounts/{account_id}. Exemplo: "accounts/123" |
PropertySummary
Um recurso virtual que representa os metadados de uma propriedade do GA4.
Campos | |
---|---|
property |
Nome do recurso da propriedade mencionado por este resumo de propriedade Formato: propriedades/{property_id}. Exemplo: "propriedades/1000" |
display_name |
Nome de exibição da propriedade mencionada neste resumo de propriedades. |
property_type |
O tipo de propriedade da propriedade. |
parent |
Nome do recurso do pai lógico dessa propriedade. Observação: a interface de movimentação de propriedades pode ser usada para alterar o pai. Formato: accounts/{account}, propriedades/{property} Exemplo: "accounts/100", "properties/200" |
PropertyType
Tipos de recursos de propriedade.
Enums | |
---|---|
PROPERTY_TYPE_UNSPECIFIED |
Tipo de propriedade desconhecido ou não especificado |
PROPERTY_TYPE_ORDINARY |
Propriedade comum do GA4 |
PROPERTY_TYPE_SUBPROPERTY |
Subpropriedade do GA4 |
PROPERTY_TYPE_ROLLUP |
Propriedade de visualização completa do GA4 |
ProvisionAccountTicketRequest
Mensagem de solicitação para RPC ProvisionAccountTicket.
Campos | |
---|---|
account |
A conta a ser criada. |
redirect_uri |
URI de redirecionamento para o qual o usuário será encaminhado depois de aceitar os Termos de Serviço. Precisa ser configurado no Console do Cloud como um URI de redirecionamento. |
ProvisionAccountTicketResponse
Mensagem de resposta para RPC ProvisionAccountTicket.
Campos | |
---|---|
account_ticket_id |
O parâmetro a ser transmitido no link dos TOS. |
RunAccessReportRequest
A solicitação de um relatório de registro de acesso a dados.
Campos | |
---|---|
entity |
O Relatório de acesso a dados é compatível com solicitações no nível da propriedade ou da conta. Se solicitados no nível da conta, os relatórios de acesso a dados incluem todo o acesso a todas as propriedades nessa conta. Para solicitar no nível da propriedade, a entidade vai precisar ser, por exemplo, "properties/123" se "123" for o ID da propriedade do GA4. Para solicitar no nível da conta, a entidade vai precisar ser, por exemplo, "accounts/1234" se "1234" for o ID da conta do GA4. |
dimensions[] |
As dimensões solicitadas e exibidas na resposta. As solicitações podem ter até nove dimensões. |
metrics[] |
As métricas solicitadas e exibidas na resposta. As solicitações podem ter até 10 métricas. |
date_ranges[] |
Períodos dos registros de acesso a serem lidos. Se vários períodos forem solicitados, cada linha de resposta terá um índice de período baseado em zero. Se dois períodos se sobrepuserem, os registros de acesso dos dias sobrepostos serão incluídos nas linhas de resposta dos dois períodos. As solicitações podem ter até dois períodos. |
dimension_filter |
Com os filtros de dimensão, é possível restringir a resposta do relatório a valores de dimensão específicos que correspondem ao filtro. Por exemplo, filtrar registros de acesso de um único usuário. Para saber mais, consulte Princípios básicos dos filtros de dimensão para ver exemplos. Não é possível usar métricas neste filtro. |
metric_filter |
Com os filtros de métricas, é possível restringir a resposta do relatório a valores de métricas específicos que correspondem ao filtro. Os filtros de métricas são aplicados após a agregação das linhas do relatório, de maneira semelhante à cláusula SQL. Não é possível usar dimensões neste filtro. |
offset |
A contagem de linhas da primeira linha. A primeira linha é contada como a linha 0. Se o deslocamento não for especificado, ele será tratado como 0. Se o deslocamento for zero, esse método retornará a primeira página de resultados com entradas Consulte Paginação para saber mais sobre esse parâmetro. |
limit |
O número de linhas a serem retornadas. Se não for especificado, 10.000 linhas serão retornadas. A API retorna no máximo 100.000 linhas por solicitação, independentemente de quantas linhas você solicitar. A API pode retornar menos linhas do que o Consulte Paginação para saber mais sobre esse parâmetro. |
time_zone |
O fuso horário desta solicitação, se especificado. Se não for especificado, o fuso horário da propriedade será usado. O fuso horário da solicitação é usado para interpretar as datas de início e término do relatório. Formatado como strings do banco de dados da IANA (https://www.iana.org/time-zones)). Por exemplo, "America/New_York" ou "Asia/Tokyo". |
order_bys[] |
Especifica como as linhas são ordenadas na resposta. |
return_entity_quota |
Define se é necessário retornar o estado atual da cota dessa propriedade do Google Analytics. A cota é retornada em AccessQuota. Para solicitações no nível da conta, este campo precisa ser falso. |
include_all_users |
Opcional. Determina se os usuários que nunca fizeram uma chamada de API na resposta serão incluídos. Se verdadeiro, todos os usuários com acesso à propriedade ou conta especificada são incluídos na resposta, independentemente de terem feito uma chamada de API ou não. Se for "false", somente os usuários que fizeram uma chamada de API serão incluídos. |
expand_groups |
Opcional. Decidir se quer retornar os usuários nos grupos de usuários. Esse campo funciona apenas quando include_all_users está definido como verdadeiro. Se verdadeiro, todos os usuários com acesso à propriedade ou conta especificada serão retornados. Se for definido como "false", somente os usuários com acesso direto serão retornados. |
RunAccessReportResponse
A resposta personalizada do relatório de registro de acesso a dados.
Campos | |
---|---|
dimension_headers[] |
O cabeçalho de uma coluna no relatório que corresponde a uma dimensão específica. O número de DimensionHeaders e a ordem de DimensionHeaders correspondem às dimensões presentes nas linhas. |
metric_headers[] |
O cabeçalho de uma coluna no relatório que corresponde a uma métrica específica. O número de MetricHeaders e ordem de MetricHeaders correspondem às métricas presentes nas linhas. |
rows[] |
Linhas de combinações de valores de dimensão e valores de métricas no relatório. |
row_count |
O número total de linhas no resultado da consulta. Consulte Paginação para saber mais sobre esse parâmetro. |
quota |
O estado da cota para essa propriedade do Google Analytics, incluindo a solicitação. Este campo não funciona com solicitações no nível da conta. |
SearchChangeHistoryEventsRequest
Mensagem de solicitação para a RPC SearchChangeHistoryEvents.
Campos | |
---|---|
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" |
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" |
resource_type[] |
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. |
actor_email[] |
Opcional. Se definido, retorna as alterações somente se elas forem feitas por um usuário dessa lista. |
earliest_change_time |
Opcional. Se definido, retorna somente as alterações feitas depois desse período (inclusive). |
latest_change_time |
Opcional. Se definido, retorna somente as alterações feitas antes desse horário (inclusive). |
page_size |
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). |
page_token |
Opcional. Um token de página recebido de uma chamada |
SearchChangeHistoryEventsResponse
Mensagem de resposta para RPC SearchAccounts.
Campos | |
---|---|
change_history_events[] |
Resultados que estavam acessíveis ao autor da chamada. |
next_page_token |
Um token, que pode ser enviado como |
ServiceLevel
Diversos níveis de serviço do Google Analytics.
Enums | |
---|---|
SERVICE_LEVEL_UNSPECIFIED |
Nível de serviço não especificado ou inválido. |
GOOGLE_ANALYTICS_STANDARD |
A versão padrão do Google Analytics. |
GOOGLE_ANALYTICS_360 |
A versão premium paga do Google Analytics. |
UpdateAccountRequest
Mensagem de solicitação para RPC UpdateAccount.
Campos | |
---|---|
account |
Obrigatório. A conta a ser atualizada. O campo |
update_mask |
Obrigatório. Lista de campos a serem atualizados. Os nomes dos campos precisam estar em Snake-Case (por exemplo, "field_to_update"). Os campos omitidos não serão atualizados. Para substituir a entidade inteira, use um caminho com a string "*" para corresponder a todos os campos. |
UpdateConversionEventRequest
Mensagem de solicitação para RPC UpdateConversionEvent
Campos | |
---|---|
conversion_event |
Obrigatório. O evento de conversão a ser atualizado. O campo |
update_mask |
Obrigatório. Lista de campos a serem atualizados. Os nomes dos campos precisam estar em Snake-case (por exemplo, "field_to_update"). Os campos omitidos não serão atualizados. Para substituir a entidade inteira, use um caminho com a string "*" para corresponder a todos os campos. |
UpdateCustomDimensionRequest
Mensagem de solicitação para RPC UpdateCustomDimension.
Campos | |
---|---|
custom_dimension |
A CustomDimension a ser atualizada |
update_mask |
Obrigatório. Lista de campos a serem atualizados. Os campos omitidos não serão atualizados. Para substituir a entidade inteira, use um caminho com a string "*" para corresponder a todos os campos. |
UpdateCustomMetricRequest
Mensagem de solicitação para a RPC UpdateCustomMetric.
Campos | |
---|---|
custom_metric |
A CustomMetric a ser atualizado |
update_mask |
Obrigatório. Lista de campos a serem atualizados. Os campos omitidos não serão atualizados. Para substituir a entidade inteira, use um caminho com a string "*" para corresponder a todos os campos. |
UpdateDataRetentionSettingsRequest
Mensagem de solicitação para o RPC UpdateData storageSettings.
Campos | |
---|---|
data_retention_settings |
Obrigatório. As configurações a serem atualizadas. O campo |
update_mask |
Obrigatório. Lista de campos a serem atualizados. Os nomes dos campos precisam estar em Snake-case (por exemplo, "field_to_update"). Os campos omitidos não serão atualizados. Para substituir a entidade inteira, use um caminho com a string "*" para corresponder a todos os campos. |
UpdateDataStreamRequest
Mensagem de solicitação para RPC UpdateDataStream.
Campos | |
---|---|
data_stream |
O DataStream a ser atualizado |
update_mask |
Obrigatório. Lista de campos a serem atualizados. Os campos omitidos não serão atualizados. Para substituir a entidade inteira, use um caminho com a string "*" para corresponder a todos os campos. |
UpdateGoogleAdsLinkRequest
Mensagem de solicitação para RPC UpdateGoogleAdsLink
Campos | |
---|---|
google_ads_link |
O GoogleAdsLink para atualizar |
update_mask |
Obrigatório. Lista de campos a serem atualizados. Os nomes dos campos precisam estar em Snake-case (por exemplo, "field_to_update"). Os campos omitidos não serão atualizados. Para substituir a entidade inteira, use um caminho com a string "*" para corresponder a todos os campos. |
UpdateMeasurementProtocolSecretRequest
Mensagem de solicitação para RPC UpdateMeasurementProtocoloSecret
Campos | |
---|---|
measurement_protocol_secret |
Obrigatório. A chave secreta do Measurement Protocol a ser atualizada. |
update_mask |
Obrigatório. Lista de campos a serem atualizados. Os campos omitidos não serão atualizados. |
UpdatePropertyRequest
Mensagem de solicitação para a RPC UpdateProperty.
Campos | |
---|---|
property |
Obrigatório. A propriedade a ser atualizada. O campo |
update_mask |
Obrigatório. Lista de campos a serem atualizados. Os nomes dos campos precisam estar em Snake-case (por exemplo, "field_to_update"). Os campos omitidos não serão atualizados. Para substituir a entidade inteira, use um caminho com a string "*" para corresponder a todos os campos. |