--- title: Google Ads API Integration on Truto slug: googleads category: Marketing Automation canonical: "https://truto.one/integrations/detail/googleads/" --- # Google Ads API Integration on Truto **Category:** Marketing Automation **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Roles** — The Role object represents a role of a User. - **Users** — The User object represents a User. - **Workspaces** — Workspaces represent concepts like teams, workspaces, projects in apps that support them ### Unified Ads Management API - **Accounts** — Accounts are the top level resource in the Ads API. Each account has a unique ID and contains a set of campaigns. - **Ad Groups** — Ad Groups are the third level resource in the Ads API. Each ad_group has a unique ID and contains a set of ads. - **Ads** — Ads are the fourth level resource in the Ads API. Each ad has a unique ID and contains a set of creatives. - **Assets** — The assets like images, videos, etc. which can be used in the ads and creatives. - **Campaigns** — Campaigns are the second level resource in the Ads API. Each campaign has a unique ID and contains a set of ad_groups. - **Custom Audiences** — ## How it works 1. **Link your customer's Google Ads account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Google Ads.** The Proxy API is a 1-to-1 mapping of the Google Ads API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Centralize cross-channel ad reporting for your customers** — SaaS analytics platforms can pull Google Ads account, campaign, ad group, and ad-level data through Truto's Unified Ads Management API — alongside other ad platforms — to give end users a single dashboard for all paid media performance without building separate integrations for each channel. - **Sync CRM audiences into Google Ads for precision targeting** — CRM and CDP platforms can push dynamically updated customer segments into Google Ads as Custom Audiences, enabling end users to run remarketing or exclusion campaigns directly from their existing workflow without switching to the Google Ads UI. - **Automate campaign and ad management from your product** — E-commerce platforms, feed managers, and marketing automation tools can let their users create, pause, and update Google Ads campaigns, ad groups, and assets programmatically — for example, pausing ads for out-of-stock products or launching campaigns from a product catalog. - **Offer multi-account ad oversight for agency clients** — Agency management software can use the Unified Ads Management API to read accounts, campaigns, and performance data across all of an agency's client Google Ads accounts, enabling centralized monitoring and bulk operations from a single interface. - **Enrich user and workspace data for access governance** — Security and IT governance platforms can leverage the Unified User Directory API to read Google Ads user roles and workspace structures, helping their customers audit who has access to ad accounts and enforce least-privilege policies. ## What you can build - **Unified paid media dashboard** — Display Google Ads campaign spend, impressions, and clicks alongside other ad platforms in a single view by reading Accounts, Campaigns, Ad Groups, and Ads through the Unified Ads Management API. - **Dynamic audience sync from CRM segments** — Push customer lists from your platform into Google Ads Custom Audiences so end users can target or exclude specific segments without leaving your product. - **Programmatic campaign launcher** — Let users create and configure Google Ads Campaigns, Ad Groups, Ads, and Assets directly from your app's interface — ideal for e-commerce merchants who want to launch ads from their store admin. - **Cross-account ad performance alerts** — Monitor campaign and ad group status changes across multiple Google Ads accounts and trigger notifications when budgets are exhausted or campaigns are paused. - **Ad account access audit log** — Use the Unified User Directory API to list users, roles, and workspaces associated with Google Ads accounts, giving IT and compliance teams visibility into who can manage ad spend. - **Creative asset library with performance context** — Sync ad Assets and their associated Ads from Google Ads so creative teams can review which headlines, descriptions, and images are running and how they map to active campaigns. ## FAQs ### How does authentication work for Google Ads through Truto? Google Ads uses OAuth 2.0 for authentication. Truto handles the full OAuth flow — token acquisition, refresh, and storage — so your end users simply authorize via a consent screen and you never manage credentials directly. ### Which Google Ads objects are available through Truto's Unified Ads Management API? The Unified Ads Management API maps to Accounts, Campaigns, Ad Groups, Ads, Assets, and Custom Audiences. These cover the core objects needed for reporting, campaign management, and audience syncing. ### Can I read user roles and workspace information from Google Ads? Yes. Truto's Unified User Directory API exposes Roles, Users, and Workspaces for Google Ads, allowing you to audit account access and permission structures. ### Are there specific tools or proxy endpoints available for Google Ads today? Google Ads tools are built on request. If you need workflows beyond what the Unified APIs expose — such as conversion uploads or GAQL-based custom reporting — reach out to Truto and they will scope and build the required tools for your use case. ### How does Truto handle Google Ads API rate limits and pagination? Truto abstracts away pagination and implements rate-limit handling internally, including automatic retries and backoff. Your application receives clean, paginated responses through a consistent interface regardless of Google Ads API quotas. ### Can I manage multiple Google Ads accounts (MCC structure) through a single integration? Yes. The Unified Ads Management API's Accounts resource supports reading client accounts under a Manager Account (MCC), so your users can connect at the manager level and your app can access all child accounts.