AdsApp.​LanguageSelector

  • Fetches languages for targeting in Google Ads campaigns and allows for filtering and sorting.

  • Provides methods like withIds, withLimit, and withResourceNames to refine the selection of languages.

  • Returns an iterator (LanguageIterator) to access the selected languages.

  • Supports conditions and ordering to further customize the results based on metrics like impressions or clicks.

  • Can be used to identify languages based on their IDs or Google Ads API resource names.

 Fetches languages. Supports filtering and sorting.

Typical usage: 

var languageSelector = campaign.targeting()
    .languages()
    .withCondition("metrics.impressions > 100")
    .orderBy("metrics.clicks DESC");

var languageIterator = languageSelector.get();
while (languageIterator.hasNext()) {
  var language = languageIterator.next();
}
 Related:

Methods:

MemberTypeDescription
get() AdsApp.LanguageIterator Fetches the requested languages and returns an iterator.
withIds(ids) AdsApp.LanguageSelector Restricts this selector to return only languages with the given language IDs.
withLimit(limit) AdsApp.LanguageSelector Specifies limit for the selector to use.
withResourceNames(resourceNames) AdsApp.LanguageSelector Restricts this selector to return only languages with the given Google Ads API resource names.

get()

Fetches the requested languages and returns an iterator.

Return values:

TypeDescription
AdsApp.LanguageIterator Iterator of the requested languages.

withIds(ids)

Restricts this selector to return only languages with the given language IDs.

All languages are uniquely identified by the combination of their ad group ID and language ID. The IDs for this selector are thus represented as two-element arrays, with the first element being the ad group ID and the second being the language ID: 

var languageIds = [
  ['12345', '987987'],
  ['23456', '876876'],
  ['34567', '765765'],
];
selector = selector.withIds(languageIds);

The resulting selector can be further refined by applying additional conditions to it. The ID-based condition will then be AND-ed together with all the other conditions, including any other ID-based conditions. So, for instance, the following selector: 

var ids1 = [
  ['12345', '987987'],
  ['23456', '876876'],
  ['34567', '765765'],
];
var ids2 = [
  ['34567', '765765'],
  ['45678', '654654'],
  ['56789', '543543'],
];
AdsApp.targeting().languages()
   .withIds(ids1)
   .withIds(ids2);
 will only get the language with ID ['34567', '765765'], since it would be the only language that satisfies both ID conditions.

Arguments:

NameTypeDescription
ids Object[][] Array of language IDs.

Return values:

TypeDescription
AdsApp.LanguageSelector The selector restricted to the given IDs.

withLimit(limit)

Specifies limit for the selector to use. For instance, withLimit(50) returns only the first 50 entities.

Arguments:

NameTypeDescription
limit int How many entities to return.

Return values:

TypeDescription
AdsApp.LanguageSelector The selector with limit applied.

withResourceNames(resourceNames)

Restricts this selector to return only languages with the given Google Ads API resource names. 
const languageResourceNames = [
  'customers/1234567890/campaignCriteria/111~222',
  'customers/1234567890/campaignCriteria/111~333',
  'customers/1234567890/campaignCriteria/444~555',
];
selector = selector.withResourceNames(languageResourceNames);

The resulting selector can be further refined by applying additional conditions to it. The resource name condition will then be AND-ed together with all the other conditions.

The selector can only support up to 10,000 resource names. If more than 10,000 resource names are specified, the corresponding get() call will fail with a runtime error.

Arguments:

NameTypeDescription
resourceNames String[] Array of language resource names.

Return values:

TypeDescription
AdsApp.LanguageSelector The selector restricted to the given resource names.