Use Google Ads in Sim to list accessible accounts and campaigns, retrieve ad groups and performance metrics, and run custom Google Ads Query Language (GAQL) queries. These read operations support campaign reporting and budget monitoring workflows.
Connect your Google account and select a reporting operation. Google requires the adwords OAuth scope even for read-only reports; Sim's Google Ads operations do not create or modify ads, budgets, or billing.
Google Ads API access belongs to the Google Cloud project that owns the OAuth client. Self-hosted deployments must enable the Google Ads API and configure the project's access level in the Google Ads API overview . Test access works only with Google Ads test accounts; production accounts require an appropriate production access level. Developer tokens were retired on September 9, 2026 and are no longer needed.
Use the client account's Customer ID for reports. If your Google user accesses that account through a manager, set Manager Customer ID in the additional fields. List Customers returns accounts directly accessible to the signed-in user, which may include the manager rather than its client accounts. Test accounts do not serve ads and cannot demonstrate real impressions, clicks, or spend.
All report operations return one page at a time (up to 10,000 rows). Use the returned nextPageToken in Page Token with unchanged query inputs to retrieve the next page. totalCount counts the current page. Custom Query also returns totalResultsCount, which ignores GAQL LIMIT. Daily performance reports return one row per entity and date; sum counts before computing ratios. Costs are in micros of the customer account currency.
Sim requests these scopes when someone connects a Google Ads account. For a self-hosted deployment, register your own app with the provider using the settings below. See Integrations and OAuth for setup.
Setting Value Redirect URI <NEXT_PUBLIC_APP_URL>/api/auth/oauth2/callback/google-adsEnvironment variables GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET
Scope Description https://www.googleapis.com/auth/userinfo.emailView email address https://www.googleapis.com/auth/userinfo.profileView basic profile info https://www.googleapis.com/auth/adwordsManage Google Ads campaigns and reporting
Connect to Google Ads to list accessible accounts, list campaigns, view ad group details, get performance metrics, and run custom GAQL queries.
List Google Ads accounts directly accessible by the authenticated user; query customer_client for manager subaccounts
Parameter Type Required Description
Parameter Type Description customerIdsarray Customer IDs directly accessible by the user totalCountnumber Total number of accessible customer accounts
Run a custom Google Ads Query Language (GAQL) query
Parameter Type Required Description customerIdstring Yes Google Ads customer ID (numeric, no dashes) managerCustomerIdstring No Manager account customer ID (if accessing via manager account) querystring Yes GAQL query to execute pageTokenstring No Page token for pagination
Parameter Type Description resultsarray Rows containing only the fields selected by the GAQL query totalResultsCountnumber Total matching rows ignoring LIMIT, when returned by Google nextPageTokenstring Token for the next page; keep the same query and customer
List campaigns in a Google Ads account with optional status filtering
Parameter Type Required Description pageTokenstring No Continuation token from the previous page; keep the same customer and query inputs customerIdstring Yes Google Ads customer ID (numeric, no dashes) managerCustomerIdstring No Manager account customer ID (if accessing via manager account) statusstring No Filter by campaign status (ENABLED, PAUSED, REMOVED) limitnumber No Maximum number of campaigns to return
Parameter Type Description nextPageTokenstring Continuation token, or null on the last page; reuse unchanged query inputs campaignsarray List of campaigns in the account ↳ id string Campaign ID ↳ name string Campaign name ↳ status string Campaign status (ENABLED, PAUSED, REMOVED) ↳ channelType string Advertising channel type (SEARCH, DISPLAY, SHOPPING, VIDEO, PERFORMANCE_MAX) ↳ startDate string Campaign start date (YYYY-MM-DD) ↳ endDate string Campaign end date (YYYY-MM-DD) ↳ budgetAmountMicros string Daily budget in micros (divide by 1,000,000 for currency value) totalCountnumber Number of campaigns in this page
Get performance metrics for Google Ads campaigns over a date range
Parameter Type Required Description pageTokenstring No Continuation token from the previous page; keep the same customer and query inputs customerIdstring Yes Google Ads customer ID (numeric, no dashes) managerCustomerIdstring No Manager account customer ID (if accessing via manager account) campaignIdstring No Filter by specific campaign ID dateRangestring No Predefined date range (LAST_7_DAYS, LAST_30_DAYS, THIS_MONTH, LAST_MONTH, TODAY, YESTERDAY) startDatestring No Custom start date in YYYY-MM-DD format endDatestring No Custom end date in YYYY-MM-DD format
Parameter Type Description nextPageTokenstring Continuation token, or null on the last page; reuse unchanged query inputs campaignsarray Campaign performance data broken down by date ↳ id string Campaign ID ↳ name string Campaign name ↳ status string Campaign status ↳ impressions string Number of impressions ↳ clicks string Number of clicks ↳ costMicros string Cost in micros (divide by 1,000,000 for currency value) ↳ ctr number Click-through rate (0.0 to 1.0) ↳ conversions number Number of conversions ↳ date string Date for this row (YYYY-MM-DD) totalCountnumber Number of rows in this page
List ad groups in a Google Ads campaign
Parameter Type Required Description pageTokenstring No Continuation token from the previous page; keep the same customer and query inputs customerIdstring Yes Google Ads customer ID (numeric, no dashes) managerCustomerIdstring No Manager account customer ID (if accessing via manager account) campaignIdstring Yes Campaign ID to list ad groups for statusstring No Filter by ad group status (ENABLED, PAUSED, REMOVED) limitnumber No Maximum number of ad groups to return
Parameter Type Description nextPageTokenstring Continuation token, or null on the last page; reuse unchanged query inputs adGroupsarray List of ad groups in the campaign ↳ id string Ad group ID ↳ name string Ad group name ↳ status string Ad group status (ENABLED, PAUSED, REMOVED) ↳ type string Ad group type (SEARCH_STANDARD, DISPLAY_STANDARD, SHOPPING_PRODUCT_ADS) ↳ campaignId string Parent campaign ID ↳ campaignName string Parent campaign name totalCountnumber Number of ad groups in this page
Get performance metrics for individual ads over a date range
Parameter Type Required Description pageTokenstring No Continuation token from the previous page; keep the same customer and query inputs customerIdstring Yes Google Ads customer ID (numeric, no dashes) managerCustomerIdstring No Manager account customer ID (if accessing via manager account) campaignIdstring No Filter by campaign ID adGroupIdstring No Filter by ad group ID dateRangestring No Predefined date range (LAST_7_DAYS, LAST_30_DAYS, THIS_MONTH, LAST_MONTH, TODAY, YESTERDAY) startDatestring No Custom start date in YYYY-MM-DD format endDatestring No Custom end date in YYYY-MM-DD format limitnumber No Maximum number of results to return
Parameter Type Description nextPageTokenstring Continuation token, or null on the last page; reuse unchanged query inputs adsarray Ad performance data broken down by date ↳ adId string Ad ID ↳ adGroupId string Parent ad group ID ↳ adGroupName string Parent ad group name ↳ campaignId string Parent campaign ID ↳ campaignName string Parent campaign name ↳ adType string Ad type (RESPONSIVE_SEARCH_AD, EXPANDED_TEXT_AD, etc.) ↳ impressions string Number of impressions ↳ clicks string Number of clicks ↳ costMicros string Cost in micros (divide by 1,000,000 for currency value) ↳ ctr number Click-through rate (0.0 to 1.0) ↳ conversions number Number of conversions ↳ date string Date for this row (YYYY-MM-DD) totalCountnumber Number of rows in this page