AdsApp.​AdGroupPhoneNumberSelector

AI-generated Key Takeaways

outlined_flag

• This object fetches ad group-level phone numbers and supports filtering and sorting.

• The forDateRange() method allows setting a predefined or custom date range for the selection.

• The get() method fetches the phone numbers and returns an iterator to access them.

• The orderBy() method allows specifying the order in which the results are returned, supporting multiple sorting criteria.

• The withCondition() method adds filters to narrow down the results based on various column types and operators.

Typical usage:

var adGroupPhoneNumberSelector = adGroup.extensions()
    .phoneNumbers()
    .withCondition("metrics.impressions > 100")
    .forDateRange("LAST_MONTH")
    .orderBy("metrics.clicks DESC");

var adGroupPhoneNumberIterator = adGroupPhoneNumberSelector.get();
while (adGroupPhoneNumberIterator.hasNext()) {
  var adGroupPhoneNumber = adGroupPhoneNumberIterator.next();
}

• AdGroupPhoneNumberIterator
• AdGroupPhoneNumber

Methods:

forDateRange(dateRange)

TODAY, YESTERDAY, LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, LAST_BUSINESS_WEEK, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN, THIS_WEEK_MON_TODAY, THIS_WEEK_SUN_TODAY, LAST_MONTH, THIS_MONTH, ALL_TIME. Example:

selector.forDateRange("THIS_WEEK_SUN_TODAY");

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.

Arguments:

Return values:

forDateRange(dateFrom, dateTo)

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.

Arguments:

Return values:

get()

Return values:

orderBy(orderBy)

• orderBy("metrics.cost_micros") - orders results by metrics.cost_micros, in ascending order.
• orderBy("metrics.ctr ASC") - orders results by metrics.ctr, in ascending order.
• orderBy("ad_group_criterion.cpc_bid_micros DESC") - orders results by ad_group_criterion.cpc_bid_micros, in descending order.

See AdGroupPhoneNumberSelector.withCondition(String) for enumeration of columns that can be used.

orderBy() may be called multiple times. Consider the following example:

selector = selector.forDateRange("LAST_14_DAYS")
    .orderBy("metrics.clicks DESC")
    .orderBy("metrics.ctr ASC");

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.

If a stats column is used in the ordering, date range must be specified via AdGroupPhoneNumberSelector.forDateRange(String) or AdGroupPhoneNumberSelector.forDateRange(Object, Object).

LabelNames column cannot be used for ordering.

Arguments:

Return values:

withCondition(condition)

Multiple conditions may be added to the same selector:

selector = selector.forDateRange("LAST_MONTH")
    .withCondition("metrics.clicks > 5")
    .withCondition("metrics.impressions > 100");

The parameter to be passed into this method must be of the following form:

"COLUMN_NAME OPERATOR VALUE"

Operators

• 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 ()

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).

If a stats column is used in the condition, date range must be specified via AdGroupPhoneNumberSelector.forDateRange(String) or AdGroupPhoneNumberSelector.forDateRange(Object, Object).

Arguments:

Return values:

withLimit(limit)

Arguments:

Return values: