Contents

Filter

Filter condition for reporting requests.

Declaration

object Filter

Properties

NameTypeDescription
fieldstring

The name of the field to filter on (for example, localSpend, impressions).

operatorstring

Comparison operator. Supported operators (may vary by endpoint): BETWEEN, CONTAINS, CONTAINS_ANY, CONTAINS_ALL, ENDS_WITH, EQUALS, GREATER_THAN, GREATER_THAN_OR_EQUAL_TO, IN, LESS_THAN, LESS_THAN_OR_EQUAL_TO, LIKE, NOT_EQUALS, STARTS_WITH.

valueFilter.Value

One or more filter conditions applied to the result set.

Discussion

The Filter specifies a single field-level filter condition for a reporting request. The field name must match a filterable field on the target entity (for example, localSpend, impressions, campaignId). The operator determines the comparison type, and value supplies the comparison operand.

You can include multiple Filter objects in the filters array of a AppsReportingRequest or BrandsReportingRequest to narrow results by several criteria simultaneously. Supported operators vary by endpoint and field type: numeric fields support range operators like GREATER_THAN and BETWEEN. String fields support EQUALS, IN, and pattern operators like STARTS_WITH.

Endpoints that accept a Filter are: Campaigns Report, Ad Groups Report, Ads Report, Keywords Report, Search Terms Report, Campaigns Report (Brands), Ad Groups Report (Brands), Ads Report (Brands), Keywords Report (Brands), Search Terms Report (Brands), Impression Share Query, and Search Term Popularity Query.

Example

{
  "field": "localSpend",
  "operator": "GREATER_THAN",
  "value": [
    "100.00"
  ]
}

Topics

Dictionaries

See Also