Date range must be specified if the selector has conditions or ordering
for a stat field. Note that only the last date range specified for the
selector will take effect.
Sets a custom date range onto the selector. Both parameters can be either
an object containing year, month, and day fields, or an 8-digit string in
YYYYMMDD form. For instance, March 24th, 2013 is
represented as either {year: 2013, month: 3, day: 24} or
"20130324". The date range is inclusive on both ends, so
forDateRange("20130324", "20130324") sets the range of one
day.
Date range must be specified if the selector has conditions or ordering
for a stat field. Note that only the last date range specified for the
selector will take effect.
The results will be ordered by metrics.clicks in descending order.
Results with equal metrics.clicks value will be ordered by metrics.ctr in
ascending order.
All specified conditions are AND-ed together. The above
example will retrieve entities that observed over 100 metrics.impressions
AND more than 5 clicks.
The parameter to be passed into this method must be of the following
form:
"COLUMN_NAME OPERATOR VALUE"
Operators
The operator that can be used in a condition depends on the type of column.
For Integer and Long columns (e.g.
metrics.clicks and metrics.impressions):
< <= > >= = !=
For Double columns (e.g. metrics.ctr):
< >
For String columns (e.g. campaign.name):
= != (NOT) (LIKE | CONTAINS | REGEXP_MATCH)
For Enumeration columns (ones that can only take one
value from a predefined list, such as Status):
= != IN () NOT IN ()
For StringSet columns (e.g. campaign.labels):
CONTAINS ALL () CONTAINS ANY () CONTAINS NONE ()
Conditions using IN, NOT IN, CONTAINS
ALL, CONTAINS ANY and CONTAINS NONE
operators look as follows:
withCondition("resource.column_name IN (Value1, Value2)")
Columns
All column names are case-sensitive, and so are all values of enumerated
columns (such as Status).
[null,null,["Last updated 2024-12-18 UTC."],[[["Fetches ad group-level mobile apps, supporting filtering and sorting based on criteria like impressions and clicks."],["Allows for date range specification, enabling analysis within specific timeframes using predefined or custom ranges."],["Provides methods for ordering results by various metrics, such as cost, click-through rate, and bid amount."],["Can be further refined using conditions to narrow down results based on specific column values and operators."],["Offers the flexibility to limit the number of returned entities and to select either legacy or upgraded mobile apps."]]],[]]