GetGoogleAdsReport 2025.5.31.15¶
Pacote¶
com.snowflake.openflow.runtime | runtime-google-ads-nar
Descrição¶
Um processador que pode interagir com a Google Ads Reporting API. Por padrão, ele busca dados uma vez por dia
Requisito de entrada¶
FORBIDDEN
Oferece suporte a propriedades dinâmicas confidenciais¶
falso
Propriedades¶
Propriedade |
Descrição |
---|---|
ID da conta de cliente |
ID da conta do Google Ads para a qual o relatório deve ser obtido |
Serviço de credenciais do GCP |
Controller Service usado para obter as credenciais do Google Cloud Platform. |
Nome do recurso do Google Ads |
Nome do recurso que deve ser usado na cláusula “FROM” da consulta |
Token de desenvolvedor do Google |
Token de desenvolvedor necessário para acessar as APIs do Google |
Atributos do relatório |
Lista de atributos de relatório separados por vírgula |
Métricas de relatório |
Lista de métricas de relatório separadas por vírgula |
Segmentos de relatórios |
Lista de segmentos de relatório separados por vírgula |
Data de início do relatório |
Data de início a partir da qual a ingestão deve ocorrer. |
Gerenciamento do estado¶
Escopos |
Descrição |
---|---|
CLUSTER |
Armazena informações sobre a última definição de relatório na forma de hash para detectar alterações no esquema. Na ingestão incremental (quando o segmento “segments.date” é selecionado), ele mantém o controle da última data de ingestão para baixar apenas novas partes de dados. Além disso, a data de início é salva. |
Relações¶
Nome |
Descrição |
---|---|
failure |
FlowFiles de erro transferido ao receber uma resposta de erro da Google Ads Reporting API ou quando ocorre um erro durante o processamento da resposta. |
success |
FlowFiles de resposta transferidos ao receber a resposta de sucesso do Google Ads Reporting API. |
Grava atributos¶
Nome |
Descrição |
---|---|
google.ads.client.account.id |
ID da conta no Google Ads para a qual determinado relatório deve ser ingerido |
google.ads.resource.name |
Nome do recurso no Google Ads que serve de fonte para o relatório |
google.ads.query |
Consulta usada para obter os dados da Google Ads StreamSearch API |
google.ads.attributes |
Atributos do recurso selecionado |
google.ads.metrics |
Métricas coletadas no contexto de um determinado recurso |
google.ads.segments |
Compartimentos nos quais as métricas devem ser agrupadas |
google.ads.ingestion.strategy |
A estratégia usada para ingestão. Pode ser “SNAPSHOT” ou “INCREMENTAL” |
google.ads.start.date |
Data a partir da qual os dados são baixados do Google Ads (incluindo a data fornecida) |
google.ads.end.date |
Data em que os dados foram baixados do Google Ads (incluindo a data fornecida) |
google.ads.report.schema.changed |
Sinalizador que indica se o esquema do relatório foi alterado entre as execuções do processador |
google.ads.report.conversion.window |
Número de dias que são obtidos do Google Ads durante o carregamento incremental. Com base nos valores da janela de conversão |
fragment.identifier |
Um ID exclusivo de cada execução de ingestão. Permite identificar todos os FlowFiles gerados durante uma única execução. |
fragment.index |
Número que representa o identificador exclusivo no lote de FlowFiles gerados durante uma execução de ingestão |
fragment.count |
Quantidade de FlowFiles gerados durante a execução do processador |
avro.schema |
Esquema Avro que representa os dados obtidos |
mime.type |
Tipo de mime do relatório retornado. |