Relatórios filtrados

A nova API Search Ads 360 Reporting já está disponível. Ela oferece mais flexibilidade para criar relatórios personalizados e integrar os dados aos seus aplicativos e processos relacionados à geração de relatórios. Saiba mais sobre como migrar e usar a nova API Search Ads 360 Reporting.

Por padrão, seu relatório contém todos os dados no reportScope que sua solicitação especifica. Se você quiser que um relatório tenha somente os dados que correspondem a um conjunto de critérios, adicione um ou mais filtros a ele. Somente as linhas que satisfazem todos os filtros são retornadas.

Por exemplo, você pode solicitar um relatório de todas as palavras-chave em uma agência. Em seguida, é possível especificar um filtro para que somente as palavras-chave com URLs da página de destino começando com www.example.com e www.another-example.com apareçam no relatório.

"filters": [
  {
    "column" : { "columnName": "keywordLandingPage" },
    "operator" : "startsWith",
    "values" : [
      "http://www.example.com",
      "http://www.another-example.com"
    ]
  }
]

Cada filtro especifica uma coluna a ser filtrada, um operador e uma lista de valores que devem estar na coluna especificada:

"filters": [
  {
   "column" : column to filter on,
   "operator" : operator specifying the type of filter,
   "values" : list of values
  },
  { ... another filter can go here ... }
]

Observação: algumas colunas não podem ser filtradas. Na referência "Tipos de relatórios", cada coluna indica se é Filterable.

Operadores de filtro

Todos os filtros diferenciam maiúsculas de minúsculas. Ou seja, um filtro com "www.Sprockets.com" não vai corresponder a uma coluna que contenha "www.sprockets.com".

Operador	Descrição	Número de valores compatíveis
equals	A coluna precisa corresponder exatamente ao valor especificado.	1
notEquals	A coluna não pode corresponder ao valor especificado.	1
in	A coluna precisa corresponder exatamente a um dos valores na lista do filtro. Não é válido para tipos de dados de lista (como String list).	variável
lessThan	A coluna precisa conter um valor menor que o especificado. Se você especificar esse filtro para uma coluna Boolean, a API Search Ads 360 vai converter false em um valor numérico de 0 e true em 1. Se você especificar esse filtro para uma coluna String, a API vai comparar a ordem lexicográfica. Não é válido para tipos de dados de lista (como String list).	1
greaterThan	A coluna precisa conter um valor maior que um dos valores na lista do filtro. Se você especificar esse filtro para uma coluna Boolean, a API converterá false em um valor numérico de 0 e true em 1. Se você especificar esse filtro para uma coluna String, a API vai comparar a ordem lexicográfica. Não é válido para tipos de dados de lista (como String list).	1
lessThanOrEqual	A coluna precisa conter um valor menor ou igual a um dos valores na lista do filtro. Se você especificar esse filtro para uma coluna Boolean, a API converterá false em um valor numérico de 0 e true em 1. Se você especificar esse filtro para uma coluna String, a API vai comparar a ordem lexicográfica. Não é válido para tipos de dados de lista (como String list).	1
greaterThanOrEqual	A coluna precisa conter um valor maior ou igual a um dos valores na lista do filtro. Se você especificar esse filtro para uma coluna Boolean, a API converterá false em um valor numérico de 0 e true em 1. Se você especificar esse filtro para uma coluna String, a API vai comparar a ordem lexicográfica. Não é válido para tipos de dados de lista (como String list).	1
isNull	A coluna precisa estar vazia. Por exemplo, se você especificar isNull para a coluna keywordMaxCpc em um relatório de palavras-chave, ele conterá somente palavras-chave que não especificaram um CPC máx.	0
isNotNull	A coluna precisa conter um valor.	0
startsWith	A coluna precisa começar com uma das strings da lista do filtro. Válida apenas para String colunas.	variável
containsSubstring	A coluna precisa conter todas ou parte de uma das strings especificadas na lista do filtro. Por exemplo, um filtro containsSubstring com os valores: ["ham", "cheese"] retornaria linhas com este valor: hamburger cheeseburger mas não retornaria linhas com estes valores: lobster roll lettuce high amplitude (high amplitude inclui a substring "h am", mas todos os caracteres, incluindo os espaços, são avaliados pelo filtro) Válida apenas para String colunas.	variável
doesNotContainSubstring	A coluna não pode conter nenhuma das strings da lista do filtro. Por exemplo, um filtro doesNotContainSubstring com os valores: ["ham", "cheese"] retornaria linhas com este valor: lobster roll lettuce mas não retornaria linhas com estes valores: hamburger queijohambúrguer Válida apenas para String colunas.	variável
containsElement	A coluna precisa conter pelo menos um dos valores na lista do filtro. Válido apenas para colunas com tipos de dados de lista (como String list). Por exemplo, em um relatório campaign, um filtro containsElement com os valores ["foo", "bar"] a filtragem na coluna effectiveLabels retornaria apenas campanhas rotuladas com foo, bar ou ambos.	variável