Google Ads API Integration

Table of contents
  1. Overview
  2. Getting Started
    1. Step 1: Connect Google Ads
    2. Step 2: Authorize Access
  3. Data Synced
    1. Available Data Sources
    2. Data Sync Frequency
  4. Permissions & Security
    1. Required Permissions
    2. Why does Growth Nirvana need these permissions?
  5. Troubleshooting
    1. Common Issues & Fixes
      1. Error: “Permission Denied”
      2. Data Not Syncing?
  6. Contact Support

Overview

Growth Nirvana’s Google Ads API integration allows customers to sync their advertising data from Google Ads into their data warehouse of choice (BigQuery, Snowflake, Redshift, etc.).

With this integration, you can:

  • Automate campaign, keyword, and conversion data extraction
  • Support scheduled and real-time syncs
  • Manage multiple accounts for agencies
  • Securely authenticate using OAuth 2.0

Getting Started

Step 1: Connect Google Ads

  1. In your Growth Nirvana account, click on “ELT Connectors” in the left sidebar
  2. Click “Add New Connection”
  3. Select Google Ads from the available connectors
  4. Click “Connect” to start the authentication process

Step 2: Authorize Access

Growth Nirvana uses OAuth 2.0 to securely connect to your Google Ads account.

  • When prompted, log in to your Google account
  • Grant permissions for “adwords.readonly” (read access to campaign data)
  • Growth Nirvana does not modify any campaign settings—it only retrieves performance data

Data Synced

Available Data Sources

Data Type Description
Campaigns Pulls campaign-level performance metrics
Ad Groups Retrieves ad group-level data
Keywords Fetches keyword performance, CPC, CTR
Conversions Syncs conversion data for attribution
Search Terms Pulls search query performance data

Data Sync Frequency

  • Default: Daily
  • Custom: Set up real-time or scheduled syncs via the Growth Nirvana dashboard

Permissions & Security

Required Permissions

  • adwords.readonly – Read access to campaign data
  • https://www.googleapis.com/auth/adwords – Basic Google Ads account access

Why does Growth Nirvana need these permissions?

Growth Nirvana only reads campaign performance data—it does not make any changes to your campaigns.

Growth Nirvana follows industry best practices for data encryption and OAuth authentication.

Troubleshooting

Common Issues & Fixes

Error: “Permission Denied”

  • Ensure you are logged into the correct Google account
  • Check that your Google Ads user role allows API access
  • If the issue persists, try re-authenticating by removing and re-adding the integration

Data Not Syncing?

  • Check that your campaigns are active in Google Ads
  • Verify your data sync schedule in Growth Nirvana

For more help, contact support@growthnirvana.com

Contact Support

Need help? Reach out to Growth Nirvana Support: