How to Automate Google Ads with the Python API in 2026

pip install google-ads pandas python-dotenv

# Verification
google-ads --version
python -c "import google.ads.googleads.client; print('OK')"

developer_token: 'ABW-1234567890-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
login_customer_id: '1234567890'
use_proto_plus: true
client_id: 'your-client-id.googleusercontent.com'
client_secret: 'your-client-secret'
refresh_token: 'your-long-refresh-token'

# Optional: proxy for scaling
proxy: null

from google.ads.googleads.client import GoogleAdsClient
from google.ads.googleads.errors import GoogleAdsException

client = GoogleAdsClient.load_from_storage('google-ads.yaml')

ga_service = client.get_service('GoogleAdsService')

query = '''
SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM campaign
WHERE status = 'ENABLED'
DURING LAST_7_DAYS
'''

try:
    response = ga_service.search(customer_id=client.get_service('GoogleAdsService').login_customer_id, query=query)
    for row in response:
        campaign = row.campaign
        metrics = row.metrics
        print(f"ID: {campaign.id}, Nom: {campaign.name}, Clicks: {metrics.clicks}, Coût: {metrics.cost_micros / 1_000_000:.2f}€")
except GoogleAdsException as ex:
    print(f"Erreur: {ex.error}")

from google.ads.googleads.client import GoogleAdsClient
import pandas as pd

client = GoogleAdsClient.load_from_storage('google-ads.yaml')
ga_service = client.get_service('GoogleAdsService')

query = '''
SELECT
  campaign.name,
  ad_group.id,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros,
  metrics.conversions_value,
  segments.device
FROM ad_group
WHERE segments.device != UNSPECIFIED
  AND metrics.impressions > 0
DURING LAST_30_DAYS
ORDER BY metrics.cost_micros DESC
LIMIT 10000
'''

rows = []
response = ga_service.search(customer_id=client.login_customer_id, query=query)
for row in response:
    rows.append({
        'campaign': row.campaign.name,
        'ad_group_id': row.ad_group.id,
        'impressions': row.metrics.impressions,
        'clicks': row.metrics.clicks,
        'cost': row.metrics.cost_micros / 1_000_000,
        'conv_value': row.metrics.conversions_value,
        'device': row.segments.device.name,
        'roas': row.metrics.conversions_value / (row.metrics.cost_micros / 1_000_000) if row.metrics.cost_micros > 0 else 0
    })

df = pd.DataFrame(rows)
df.to_csv('rapport_google_ads.csv', index=False)
print(df.describe())
print("ROAS moyen:", df['roas'].mean())

from google.ads.googleads.client import GoogleAdsClient
from google.ads.googleads.errors import GoogleAdsException

client = GoogleAdsClient.load_from_storage('google-ads.yaml')
campaign_service = client.get_service('CampaignService')

def adjust_bid(customer_id, campaign_id, new_cpc_bid_micros):
    campaign = client.get_type('Campaign')
    campaign.resource_name = campaign_service.campaign_path(customer_id, campaign_id)
    campaign.manual_cpc_adjustment = new_cpc_bid_micros  # Ex: 2000000 for 2€
    
    campaign_operation = client.get_type('CampaignOperation')
    campaign_operation.update = campaign
    campaign_operation.update_mask = client.get_service('CampaignService').get_field_mask(campaign)
    
    try:
        response = campaign_service.mutate_campaigns(customer_id=customer_id, operations=[campaign_operation])
        print(f"Bid updated for campaign {campaign_id}: {response.results[0].resource_name}")
    except GoogleAdsException as ex:
        print(f"Bid error {campaign_id}: {ex.error}")

# Example usage
customer_id = client.login_customer_id
adjust_bid(customer_id, '1234567890', 1500000)  # 1.5€ target CPC

from google.ads.googleads.client import GoogleAdsClient

client = GoogleAdsClient.load_from_storage('google-ads.yaml')
ga_service = client.get_service('GoogleAdsService')
keyword_service = client.get_service('KeywordPlanIdeaService')

query = '''
SELECT
  keyword_view.resource_name,
  keyword_view.keyword.text,
  metrics.impressions,
  metrics.ctr
FROM keyword_view
WHERE metrics.impressions > 100
  AND metrics.ctr < 0.01
DURING LAST_30_DAYS
'''

customer_id = client.login_customer_id
response = ga_service.search(customer_id=customer_id, query=query)
paused = []

for row in response:
    keyword_resource = row.keyword_view.resource_name
    # Parse keyword ID (simplified, use real parsing)
    keyword_id = keyword_resource.split('/')[-1]
    
    keyword_op = client.get_type('KeywordPlanKeywordOperation')
    keyword = client.get_type('KeywordPlanKeyword')
    keyword.resource_name = keyword_resource
    keyword.status = client.enums.KeywordPlanKeywordStatusEnum.PAUSED
    keyword_op.update = keyword
    keyword_op.update_mask = client.get_service('KeywordPlanIdeaService').get_field_mask(keyword)
    
    try:
        # Note: Use AdGroupCriterionService for real pauses
        print(f"Paused: {row.keyword_view.keyword.text}")
        paused.append(keyword_id)
    except:
        pass

print(f"Keywords paused: {len(paused)}")

#!/bin/bash
cd /path/to/google-ads-automation

# Reports
python report_performance.py

# Optimize bids
python optimize_bids.py

# Pause bad keywords
python pause_keywords.py

# Log
echo "$(date): Full run complete" >> ads_log.txt