Reach customers wherever they are. Show up at the right time and place across the vast Google Ads ecosystem.
Go to siteThe Google Ads API lets you programmatically manage your Google Ads data and campaigns. You can use the API to automate common tasks, such as:
You can also use the API to get information about your campaigns, such as:
The Google Ads API is a powerful tool that lets you manage your Google Ads data and campaigns programmatically. With the API, you can automate common tasks, such as creating and managing campaigns, adding and removing keywords, and adjusting bids. You can also use the API to get information about your campaigns, such as campaign stats, keyword stats, and ad performance.
The Pipedream components interact with Google Ads API through Pipedream's proxy service, which handles authentication and developer token requirements.
The components accept a standard Google Ads API request object with the following structure:
const googleAdsReq = {
method: "get|post|put|delete", // HTTP method
url: "/v16/...", // Google Ads API endpoint path
headers: {
"Authorization": `Bearer ${this.googleAds.$auth.oauth_access_token}`
},
data: {} // Optional request body for POST/PUT requests
}
To make different API calls while using the proxy:
url
path to match your desired Google Ads API endpointmethod
to match the required HTTP methoddata
fieldExample for a custom query:
const googleAdsReq = {
method: "post",
url: "/v16/customers/1234567890/googleAds:search",
headers: {
"Authorization": `Bearer ${this.googleAds.$auth.oauth_access_token}`
},
data: {
query: "SELECT campaign.id, campaign.name FROM campaign"
}
}
The proxy endpoint will remain the same: https://eolid4dq1k0t9hi.m.pipedream.net
import { axios } from "@pipedream/platform"
export default defineComponent({
props: {
googleAds: { type: "app", app: "google_ads" }
},
async run({ $ }) {
const googleAdsReq = {
method: "get",
url: "/v16/customers:listAccessibleCustomers",
headers: {
"Authorization": `Bearer ${this.googleAds.$auth.oauth_access_token}`,
// "login-customer-id": this.googleAds.$auth.login_customer_id // optional for this endpoint
}
}
// proxy google ads request
return await axios($, {
url: "https://eolid4dq1k0t9hi.m.pipedream.net",
data: googleAdsReq,
})
}
})
Emit new event when a new campaign is created. See the documentation
Emit new event for new leads on a Lead Form. See the documentation
Adds a contact to a specific customer list in Google Ads. Lists typically update in 6 to 12 hours after operation. See the documentation
Create a new customer list in Google Ads. See the documentation
Generates a report from your Google Ads data. See the documentation
Send an event from to Google Ads to track offline conversions. See the documentation
Google Ads uses OAuth authentication. When you connect your Google Ads account, Pipedream will open a popup window where you can sign into Google Ads and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Google Ads API.
Pipedream requests the following authorization scopes when you connect your account:
email
profile
https://www.googleapis.com/auth/adwords
GET
https://accounts.google.com/o/oauth2/auth
?
client_id={{oauth.client_id}}
&
redirect_uri={{oauth.redirect_uri}}
&
state={{oauth.state}}
&
response_type=code
&
scope={{oauth.space_separated_scopes}}
&
prompt=consent
&
access_type=offline
POST
https://oauth2.googleapis.com/token
content-type: application/x-www-form-urlencoded
accept: application/json
client_id={{oauth.client_id}}
&
client_secret={{oauth.client_secret}}
&
redirect_uri={{oauth.redirect_uri}}
&
grant_type=authorization_code
&
code={{oauth.code}}
POST
https://oauth2.googleapis.com/token
content-type: application/x-www-form-urlencoded
accept: application/json
client_id={{oauth.client_id}}
&
client_secret={{oauth.client_secret}}
&
grant_type=refresh_token
&
refresh_token={{oauth.refresh_token}}