Documentation>Google Ads Scripts API
Intermediate Level

Google Ads Scripts API

Complete reference for Google Ads Scripts API methods, objects, and available services for building powerful automation.

45 minutes
Core API Objects

Campaign Management

  • AdsApp.campaigns() - Campaign operations
  • campaign.getStats() - Performance data
  • campaign.setBudget() - Budget management
  • campaign.pause() - Status control

Keyword & Ad Operations

  • AdsApp.keywords() - Keyword management
  • keyword.setMaxCpc() - Bid adjustments
  • AdsApp.ads() - Ad management
  • adGroup.newKeywordBuilder() - Creating keywords
Common API Patterns
// Basic campaign iteration
const campaigns = AdsApp.campaigns()
  .withCondition('Status = ENABLED')
  .withCondition('Cost > 100 DURING LAST_7_DAYS')
  .get();

while (campaigns.hasNext()) {
  const campaign = campaigns.next();
  const stats = campaign.getStatsFor('LAST_7_DAYS');
  
  // Your logic here
  Logger.log(`${campaign.getName()}: €${stats.getCost().toFixed(2)}`);
}

// Keyword bid management
const keywords = AdsApp.keywords()
  .withCondition('Status = ENABLED')
  .withCondition('Clicks > 10 DURING LAST_30_DAYS')
  .get();

while (keywords.hasNext()) {
  const keyword = keywords.next();
  const currentBid = keyword.getMaxCpc();
  const newBid = currentBid * 1.1; // 10% increase
  
  keyword.setMaxCpc(newBid);
}

These patterns form the foundation of most Google Ads automation scripts.