> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://apidocs.polytomic.com/2023-04-25/configuring-your-connections/connections/google-ads/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://apidocs.polytomic.com/_mcp/server.

# Google Ads

Supports:
* ✅ Model sync destination
* ✅ Bulk sync source
* ✅ Connection Proxy




## Connection

### Configuration
<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>auto_add_accounts</code></td>
<td><code>boolean</code></td>
<td style="vertical-align: top;">Automatically add new accounts</td>
<td><code>false</code></td>
</tr>
<tr>
<td><code>client_id</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;"></td>
<td><code>false</code></td>
</tr>
<tr>
<td><code>client_secret</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;"></td>
<td><code>false</code></td>
</tr>
<tr>
<td><code>oauth_refresh_token</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;"></td>
<td><code>false</code></td>
</tr>
</tbody>
</table>

<h4 id="oauth-token-expiry">`oauth_token_expiry`</h4>

<h5 id="oauth-token-expiry-<nil>">When `oauth_token_expiry` has a value</h5>

<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>accounts</code></td>
<td><code>array</code></td>
<td style="vertical-align: top;">Accounts</td>
<td><code>true</code></td>
</tr>
<tr>
<td><code>blanket_user_consent</code></td>
<td><code>boolean</code></td>
<td style="vertical-align: top;">All transmitted users consented to ad personalization and information sharing with Google Ads<br/><br/>Causes this connection to send signals to Google Ads indicating that every transmitted user has accepted ad personalization and data sharing policies. This will cause the user to be included in more advertising functions</td>
<td><code>false</code></td>
</tr>
<tr>
<td><code>custom_reports</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Custom reports<br/><br/>One report per line. Format is a report name:ads object:field list. e.g. myReport:ad_groups:campaign.id</td>
<td><code>false</code></td>
</tr>
<tr>
<td><code>use_data_manager_apis</code></td>
<td><code>boolean</code></td>
<td style="vertical-align: top;">Use Data Manager APIs<br/><br/>Use Google Data Manager APIs for user list operations and conversion uploads. Requires a token granted the Data Manager OAuth scope.</td>
<td><code>false</code></td>
</tr>
</tbody>
</table>



#### Example

```json
{
  "name": "Google Ads connection",
  "type": "googleads",
  "configuration": {
    "auto_add_accounts": false,
    "client_id": "a45gadsfdsaf47byor2ugfbhsgllpf12gf56gfds",
    "client_secret": "ay8d5hdepz62px8lqeoakuea2ccl4rxm13i6tbyorxhu1i20kc8ruvksmzxq",
    "oauth_refresh_token": "dasfdasz62px8lqeoakuea2ccl4rxm13i6tbyorxhu1i20kc8ruvksmzxq"
  }
}
```

### Read-only properties
<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>connected_user</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Connected user's email</td>
<td><code>false</code></td>
</tr>
</tbody>
</table>


## Model Sync
### Target
Google Ads connections may be used as the destination in a model sync.




### Target creation

Google Ads connections may be used to create a new target for a model sync. The
following parameters are required to create a new target:

<table>
<thead>
<tr>
  <th>NAME</th>
  <th>DESCRIPTION</th>
  <th>ENUM</th>
</tr></thead>
<tbody>
<tr>
  <td>account</td>
  <td>Account ID</td>
  <td>true</td>
</tr>

<tr>
  <td>name</td>
  <td>User list name</td>
  <td>false</td>
</tr>

</tbody>
</table>




## Bulk Sync
### Source
#### Configuration
<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>reporting_lookback</code></td>
<td><code>integer</code></td>
<td style="vertical-align: top;">Lookback period for reports</td>
<td><code>false</code></td>
</tr>
</tbody>
</table>


#### Example
```json
{
  ...
  "source_configuration": {
    "reporting_lookback": 0
  }
}
```