Shopping

function getAllShoppingCampaigns() {  // AdsApp.shoppingCampaigns() will return all campaigns that are not removed  // by default.  const campaignIterator = AdsApp.shoppingCampaigns().get();  console.log(`Total shopping campaigns found : ${  campaignIterator.totalNumEntities()}`);  return campaignIterator; }

function getShoppingCampaignByName(shoppingCampaignName) {  const campaignIterator = AdsApp.shoppingCampaigns()  .withCondition(`campaign.name = "${shoppingCampaignName}"`)  .get();  if (campaignIterator.hasNext()) {  const campaign = campaignIterator.next();  console.log(`Campaign Name: ${campaign.getName()}`);  console.log(`Enabled: ${campaign.isEnabled()}`);  console.log(`Bidding strategy: ${campaign.getBiddingStrategyType()}`);  console.log(`Ad rotation: ${campaign.getAdRotationType()}`);  console.log(`Start date: ${formatDate(campaign.getStartDate())}`);  console.log(`End date: ${formatDate(campaign.getEndDate())}`);  return campaign;  } else {  throw new Error(  `No shopping campaign named "${shoppingCampaignName}" found`);  } } function formatDate(date) {  function zeroPad(number) {  return Utilities.formatString('%02d', number);  }  return (date == null) ?  'None' :  zeroPad(date.year) + zeroPad(date.month) + zeroPad(date.day); }

function getShoppingAdGroupByName(shoppingAdGroupName) {  const adGroupIterator = AdsApp.shoppingAdGroups()  .withCondition(`ad_group.name = "${shoppingAdGroupName}"`)  .get();  if (!adGroupIterator.hasNext()) {  throw new Error(`No ad group with name "${shoppingAdGroupName}" found`);  }  const shoppingAdGroup = adGroupIterator.next();  if (adGroupIterator.totalNumEntities() > 1) {  console.warn(`Multiple ad groups named "${shoppingAdGroupName}" found. Using the one from campaign "${shoppingAdGroup.getCampaign().getName()}"`);  }  return shoppingAdGroup; }

function createElectronicsShoppingAdGroup() {  // This example snippet assumes a user has a shopping campaign named  // 'Shopping' and creates a new ad group named 'Electronics' in the campaign.  // Please customize the snippet to suit your use case.  const shoppingCampaignName = 'Shopping';  const newAdGroupName = 'Electronics';  const shoppingCampaign = AdsApp.shoppingCampaigns()  .withCondition(`campaign.name = "${shoppingCampaignName}"`)  .get()  .next();  const adGroupOperation = shoppingCampaign.newAdGroupBuilder()  .withName(newAdGroupName)  .withCpc(0.75)  .build();  if (adGroupOperation.isSuccessful()) {  const adGroup = adGroupOperation.getResult();  console.log(`Successfully created ad group "${  adGroup.getName()}" in campaign "${adGroup.getCampaign().getName()}"`);  } else {  const errors = adGroupOperation.getErrors();  console.error(`Creation failed with errors: ${errors}`);  throw new Error(`Failed to create ad group "${  newAdGroupName}" in campaign "${shoppingCampaignName}"`);  } }

function createElectronicsProductGroups() {  // This example snippet assumes a user has a shopping campaign named  // 'Shopping' that includes an ad group named 'Electronics'. Please customize  // the product group hierarchy to suit your use case.  const shoppingCampaignName = 'Shopping';  const shoppingAdGroupName = 'Electronics';  const shoppingAdGroup = AdsApp.shoppingAdGroups()  .withCondition(`campaign.name = "${shoppingCampaignName}"`)  .withCondition(`ad_group.name = "${shoppingAdGroupName}"`)  .get()  .next();  const rootProductGroup = shoppingAdGroup.rootProductGroup();  // The created product group hierarchy will be  // - root  // - 'Cardcow' brand  // - New condition  // - Refurbished condition  // - Other conditions  // - Other brands  // Add a brand product group for 'Cardcow' under the root product group.  const brandNode = rootProductGroup.newChild()  .brandBuilder()  .withName('Cardcow')  .withBid(1.2)  .build()  .getResult();  // Add groups for new and refurbished Cardcow brand items.  const newItems = brandNode.newChild()  .conditionBuilder()  .withCondition('NEW')  .build()  .getResult();  const refurbishedItems = brandNode.newChild()  .conditionBuilder()  .withCondition('REFURBISHED')  .withBid(0.9)  .build()  .getResult(); }

function actOnAllElectronicsProductGroups() {  // This example snippet assumes a user has a hierarchy of product groups under  // an ad group named 'Electronics' in a shopping campaign named 'Shopping'. It  // applies the function 'actOnProductGroupAndChildren' to each product group  // in the hierarchy. Please customize the 'actOnProductGroupAndChildren'  // function to suit your specific use case.  const shoppingCampaignName = 'Shopping';  const shoppingAdGroupName = 'Electronics';  const shoppingAdGroup = AdsApp.shoppingAdGroups()  .withCondition(`campaign.name = "${shoppingCampaignName}"`)  .withCondition(`ad_group.name = "${shoppingAdGroupName}"`)  .get()  .next();  const rootProductGroup = shoppingAdGroup.rootProductGroup();  actOnProductGroupAndChildren(rootProductGroup, 0); } function actOnProductGroupAndChildren(productGroup, level) {  // This example function logs descriptive information about the given  // productGroup and all children of the given productGroup. Please customize  // the function to suit your particular use case.  let description = '';  if (productGroup.isOtherCase()) {  description = 'Other';  } else if (productGroup.getDimension() == 'CATEGORY') {  description = productGroup.asCategory().getName();  } else {  description = productGroup.getValue();  }  // Note: Child product groups may not have a max cpc if it has been excluded.  const padding = new Array(level + 1).join('-');  console.log(  '%s %s, %s, %s, %s, %s', padding, description,  productGroup.getDimension(), productGroup.getMaxCpc(),  productGroup.isOtherCase(), productGroup.getId().toFixed());  for (const childProductGroup of productGroup.children()) {  actOnProductGroupAndChildren(childProductGroup, level + 1);  } }

function getEverythingElseProductGroupForAdGroup(shoppingAdGroupName) {  const adGroupIterator = AdsApp.shoppingAdGroups()  .withCondition(`ad_group.name = "${shoppingAdGroupName}"`)  .get();  if (!adGroupIterator.hasNext()) {  throw new Error(`No ad group with name "${shoppingAdGroupName}" found`);  }  const shoppingAdGroup = adGroupIterator.next();  if (adGroupIterator.totalNumEntities() > 1) {  console.warn(`Multiple ad groups named "${shoppingAdGroupName}" found. Using the one from campaign "${shoppingAdGroup.getCampaign().getName()}"`);  }  const rootProductGroup = shoppingAdGroup.rootProductGroup();  for (const childProductGroup of rootProductGroup.children()) {  if (childProductGroup.isOtherCase()) {  // Note: Child product groups may not have a max cpc if it has been  // excluded.  console.log(  `"Everything else" product group found. Type of the product group is ${  childProductGroup.getDimension()} and bid is ${  childProductGroup.getMaxCpc()}`);  return childProductGroup;  }  }  console.warn(  '"Everything else" product group not found under root product group.');  return null; }

function updateVariousProductGroupBids() {  // This example snippet modifies the bids of some product groups based on  // criteria. Please modify the snippet to suit your use case.  const productGroups = AdsApp.productGroups()  .withCondition('Clicks > 5')  .withCondition('Ctr > 0.01')  .forDateRange('LAST_MONTH')  .get();  for (const productGroup of productGroups) {  productGroup.setMaxCpc(productGroup.getMaxCpc() + 0.01);  } }

function getProductAdsInShoppingAdGroup(shoppingAdGroupName) { const adGroupIterator = AdsApp.shoppingAdGroups() .withCondition(`ad_group.name = "${shoppingAdGroupName}"`) .get(); if (!adGroupIterator.hasNext()) { throw new Error(`No ad group with name "${shoppingAdGroupName}" found`); } const shoppingAdGroup = adGroupIterator.next(); if (adGroupIterator.totalNumEntities() > 1) { console.warn(`Multiple ad groups named "${shoppingAdGroupName}" found. Using the one from campaign "${shoppingAdGroup.getCampaign().getName()}"`); } const productAdIterator = shoppingAdGroup.ads().get(); console.log(`Ad Group "${shoppingAdGroup.getName()}" has ${ productAdIterator.totalNumEntities()} ads`); return productAdIterator; }

function createElectronicsProductAd() {  // This example snippet assumes a user has a shopping campaign named  // 'Shopping' that includes an ad group named 'Electronics'. Please customize  // the snippet to suit your use case.  const shoppingCampaignName = 'Shopping';  const shoppingAdGroupName = 'Electronics';  const shoppingAdGroup = AdsApp.shoppingAdGroups()  .withCondition(`campaign.name = "${shoppingCampaignName}"`)  .withCondition(`ad_group.name = "${shoppingAdGroupName}"`)  .get()  .next();  const adOperation =  shoppingAdGroup.newAdBuilder().withMobilePreferred(true).build();  if (adOperation.isSuccessful()) {  const productAd = adOperation.getResult();  console.log(`Successfully created product ad in ad group "${  productAd.getAdGroup().getName()}"`);  } else {  const errors = adOperation.getErrors();  console.error(`Creation failed with errors: ${errors}`);  throw new Error(  `Failed to create product ad in ad group "${shoppingAdGroupName}"`);  } }