Skip to main content
Server path: /google-ads | Type: Application | PCID required: Yes

​
Tools

ToolDescription
google-ads_create_customer_clientCreate a client account under a manager
google-ads_generate_keyword_ideasGenerate keyword ideas
google-ads_get_fieldGet a single Google Ads field’s metadata
google-ads_list_accessible_customersList accessible customer accounts
google-ads_list_invoicesList invoices for a billing setup
google-ads_mutate_ad_group_adsCreate, update, or remove ads in ad groups
google-ads_mutate_ad_group_criteriaCreate, update, or remove ad group criteria (keywords, audiences)
google-ads_mutate_ad_groupsCreate, update, or remove ad groups
google-ads_mutate_adsUpdate ads
google-ads_mutate_campaign_budgetsCreate, update, or remove campaign budgets
google-ads_mutate_campaign_criteriaCreate, update, or remove campaign criteria
google-ads_mutate_campaignsCreate, update, or remove campaigns
google-ads_mutate_conversion_actionsCreate, update, or remove conversion actions
google-ads_mutate_customerUpdate a customer account
google-ads_mutate_customer_client_linkLink or unlink a client account to a manager
google-ads_search_google_adsRun a Google Ads Query Language (GAQL) query
google-ads_search_google_ads_fieldsSearch Google Ads field metadata
google-ads_upload_click_conversionsUpload offline click conversions
Create a client account under a manager Parameters:
ParameterTypeRequiredDefaultDescription
customerIdstringYes—The numeric ID of the Google Ads customer (account) being operated on, without dashes (e.g. “1234567890”). For manager accounts acting on a client, this is the operated-on account; the manager is supplied via the connection’s login-customer-id.
accessRolestringNo—The access role granted to the invited user (optional).
customerClientobjectYes—The new client customer to create. Typically includes descriptiveName, currencyCode, and timeZone.
emailAddressstringNo—Email of a user to invite to the new client account (optional).
validateOnlybooleanNo—If true, the request is validated but not executed.
Generate keyword ideas Parameters:
ParameterTypeRequiredDefaultDescription
customerIdstringYes—The numeric ID of the Google Ads customer (account) being operated on, without dashes (e.g. “1234567890”). For manager accounts acting on a client, this is the operated-on account; the manager is supplied via the connection’s login-customer-id.
geoTargetConstantsstring[]No—Resource names of geo targets, e.g. [“geoTargetConstants/2840”].
includeAdultKeywordsbooleanNo—If true, adult keywords are included in the results.
keywordAndUrlSeedobjectNo—A combined keyword and URL seed. Provide url and keywords.
keywordPlanNetworkstringNo—Targeting network.
keywordSeedobjectNo—A seed of one or more keywords. Provide keywords as a string array.
languagestringNo—The resource name of the language to target, e.g. “languageConstants/1000”.
pageSizeintegerNo—Number of results to retrieve in a single page.
pageTokenstringNo—Token of the page to retrieve from a previous response.
urlSeedobjectNo—A seed page URL. Provide url as a string.
Get a single Google Ads field’s metadata Parameters:
ParameterTypeRequiredDefaultDescription
resourceNamestringYes—The resource name of the field to retrieve, e.g. “googleAdsFields/campaign.id”. The slash is part of the resource name and must not be percent-encoded.
List accessible customer accounts
List invoices for a billing setup Parameters:
ParameterTypeRequiredDefaultDescription
customerIdstringYes—The numeric ID of the Google Ads customer (account) being operated on, without dashes (e.g. “1234567890”). For manager accounts acting on a client, this is the operated-on account; the manager is supplied via the connection’s login-customer-id.
billingSetupstringYes—The resource name of the billing setup, e.g. “customers/123/billingSetups/456”.
issueYearstringYes—The year (yyyy) of the invoice issue date.
issueMonthstringYes—The month of the invoice issue date.
Create, update, or remove ads in ad groups Parameters:
ParameterTypeRequiredDefaultDescription
customerIdstringYes—The numeric ID of the Google Ads customer (account) being operated on, without dashes (e.g. “1234567890”). For manager accounts acting on a client, this is the operated-on account; the manager is supplied via the connection’s login-customer-id.
operationsobject[]Yes—Required. The list of operations to perform. Each element has exactly one of create (a resource object), update (a resource object with resourceName, accompanied by updateMask), or remove (a resource name string).
partialFailurebooleanNo—If true, successful operations are carried out and invalid operations return errors. If false, all operations are carried out in one transaction if and only if they are all valid.
responseContentTypestringNo—Determines whether the mutable resource or just the resource name is returned.
validateOnlybooleanNo—If true, the request is validated but not executed; only errors are returned.
Create, update, or remove ad group criteria (keywords, audiences) Parameters:
ParameterTypeRequiredDefaultDescription
customerIdstringYes—The numeric ID of the Google Ads customer (account) being operated on, without dashes (e.g. “1234567890”). For manager accounts acting on a client, this is the operated-on account; the manager is supplied via the connection’s login-customer-id.
operationsobject[]Yes—Required. The list of operations to perform. Each element has exactly one of create (a resource object), update (a resource object with resourceName, accompanied by updateMask), or remove (a resource name string).
partialFailurebooleanNo—If true, successful operations are carried out and invalid operations return errors. If false, all operations are carried out in one transaction if and only if they are all valid.
responseContentTypestringNo—Determines whether the mutable resource or just the resource name is returned.
validateOnlybooleanNo—If true, the request is validated but not executed; only errors are returned.
Create, update, or remove ad groups Parameters:
ParameterTypeRequiredDefaultDescription
customerIdstringYes—The numeric ID of the Google Ads customer (account) being operated on, without dashes (e.g. “1234567890”). For manager accounts acting on a client, this is the operated-on account; the manager is supplied via the connection’s login-customer-id.
operationsobject[]Yes—Required. The list of operations to perform. Each element has exactly one of create (a resource object), update (a resource object with resourceName, accompanied by updateMask), or remove (a resource name string).
partialFailurebooleanNo—If true, successful operations are carried out and invalid operations return errors. If false, all operations are carried out in one transaction if and only if they are all valid.
responseContentTypestringNo—Determines whether the mutable resource or just the resource name is returned.
validateOnlybooleanNo—If true, the request is validated but not executed; only errors are returned.
Update ads Parameters:
ParameterTypeRequiredDefaultDescription
customerIdstringYes—The numeric ID of the Google Ads customer (account) being operated on, without dashes (e.g. “1234567890”). For manager accounts acting on a client, this is the operated-on account; the manager is supplied via the connection’s login-customer-id.
operationsobject[]Yes—Required. The list of operations to perform. Each element has exactly one of create (a resource object), update (a resource object with resourceName, accompanied by updateMask), or remove (a resource name string).
partialFailurebooleanNo—If true, successful operations are carried out and invalid operations return errors. If false, all operations are carried out in one transaction if and only if they are all valid.
responseContentTypestringNo—Determines whether the mutable resource or just the resource name is returned.
validateOnlybooleanNo—If true, the request is validated but not executed; only errors are returned.
Create, update, or remove campaign budgets Parameters:
ParameterTypeRequiredDefaultDescription
customerIdstringYes—The numeric ID of the Google Ads customer (account) being operated on, without dashes (e.g. “1234567890”). For manager accounts acting on a client, this is the operated-on account; the manager is supplied via the connection’s login-customer-id.
operationsobject[]Yes—Required. The list of operations to perform. Each element has exactly one of create (a resource object), update (a resource object with resourceName, accompanied by updateMask), or remove (a resource name string).
partialFailurebooleanNo—If true, successful operations are carried out and invalid operations return errors. If false, all operations are carried out in one transaction if and only if they are all valid.
responseContentTypestringNo—Determines whether the mutable resource or just the resource name is returned.
validateOnlybooleanNo—If true, the request is validated but not executed; only errors are returned.
Create, update, or remove campaign criteria Parameters:
ParameterTypeRequiredDefaultDescription
customerIdstringYes—The numeric ID of the Google Ads customer (account) being operated on, without dashes (e.g. “1234567890”). For manager accounts acting on a client, this is the operated-on account; the manager is supplied via the connection’s login-customer-id.
operationsobject[]Yes—Required. The list of operations to perform. Each element has exactly one of create (a resource object), update (a resource object with resourceName, accompanied by updateMask), or remove (a resource name string).
partialFailurebooleanNo—If true, successful operations are carried out and invalid operations return errors. If false, all operations are carried out in one transaction if and only if they are all valid.
responseContentTypestringNo—Determines whether the mutable resource or just the resource name is returned.
validateOnlybooleanNo—If true, the request is validated but not executed; only errors are returned.
Create, update, or remove campaigns Parameters:
ParameterTypeRequiredDefaultDescription
customerIdstringYes—The numeric ID of the Google Ads customer (account) being operated on, without dashes (e.g. “1234567890”). For manager accounts acting on a client, this is the operated-on account; the manager is supplied via the connection’s login-customer-id.
operationsobject[]Yes—Required. The list of operations to perform. Each element has exactly one of create (a resource object), update (a resource object with resourceName, accompanied by updateMask), or remove (a resource name string).
partialFailurebooleanNo—If true, successful operations are carried out and invalid operations return errors. If false, all operations are carried out in one transaction if and only if they are all valid.
responseContentTypestringNo—Determines whether the mutable resource or just the resource name is returned.
validateOnlybooleanNo—If true, the request is validated but not executed; only errors are returned.
Create, update, or remove conversion actions Parameters:
ParameterTypeRequiredDefaultDescription
customerIdstringYes—The numeric ID of the Google Ads customer (account) being operated on, without dashes (e.g. “1234567890”). For manager accounts acting on a client, this is the operated-on account; the manager is supplied via the connection’s login-customer-id.
operationsobject[]Yes—Required. The list of operations to perform. Each element has exactly one of create (a resource object), update (a resource object with resourceName, accompanied by updateMask), or remove (a resource name string).
partialFailurebooleanNo—If true, successful operations are carried out and invalid operations return errors. If false, all operations are carried out in one transaction if and only if they are all valid.
responseContentTypestringNo—Determines whether the mutable resource or just the resource name is returned.
validateOnlybooleanNo—If true, the request is validated but not executed; only errors are returned.
Update a customer account Parameters:
ParameterTypeRequiredDefaultDescription
customerIdstringYes—The numeric ID of the Google Ads customer (account) being operated on, without dashes (e.g. “1234567890”). For manager accounts acting on a client, this is the operated-on account; the manager is supplied via the connection’s login-customer-id.
operationobjectYes—The single update operation. Provide update (the customer object with changed fields) and updateMask (comma-separated field paths to update).
responseContentTypestringNo—Whether to return the mutable resource or just the resource name.
validateOnlybooleanNo—If true, the request is validated but not executed.
Link or unlink a client account to a manager Parameters:
ParameterTypeRequiredDefaultDescription
customerIdstringYes—The numeric ID of the Google Ads customer (account) being operated on, without dashes (e.g. “1234567890”). For manager accounts acting on a client, this is the operated-on account; the manager is supplied via the connection’s login-customer-id.
operationobjectYes—The single operation to perform. Has exactly one of create, update (with updateMask), or remove.
validateOnlybooleanNo—If true, the request is validated but not executed.
Run a Google Ads Query Language (GAQL) query Parameters:
ParameterTypeRequiredDefaultDescription
customerIdstringYes—The numeric ID of the Google Ads customer (account) being operated on, without dashes (e.g. “1234567890”). For manager accounts acting on a client, this is the operated-on account; the manager is supplied via the connection’s login-customer-id.
pageSizeintegerNo—Number of elements to retrieve in a single page. Maximum 10000. When too large, it is capped to the maximum.
pageTokenstringNo—Token of the page to retrieve, from a previous response’s nextPageToken. Omit to retrieve the first page.
querystringYes—Required. The GAQL query string. Selects fields from one resource with optional WHERE / ORDER BY / LIMIT clauses.
returnTotalResultsCountbooleanNo—If true, the total number of results matching the query, ignoring LIMIT, is included in the response.
validateOnlybooleanNo—If true, the request is validated but not executed.
Search Google Ads field metadata Parameters:
ParameterTypeRequiredDefaultDescription
pageSizeintegerNo—Number of elements to retrieve in a single page.
pageTokenstringNo—Token of the page to retrieve from a previous response.
querystringYes—Required. The metadata query string.
Upload offline click conversions Parameters:
ParameterTypeRequiredDefaultDescription
customerIdstringYes—The numeric ID of the Google Ads customer (account) being operated on, without dashes (e.g. “1234567890”). For manager accounts acting on a client, this is the operated-on account; the manager is supplied via the connection’s login-customer-id.
conversionsobject[]Yes—The list of click conversions to upload.
debugEnabledbooleanNo—If true, enriched diagnostic information is returned.
partialFailurebooleanYes—Required to be true. Successful operations are carried out and invalid ones return errors.
validateOnlybooleanNo—If true, the request is validated but not executed.