Caution: You are viewing documentation for the API's REST interface. Most of our official client libraries use gRPC. See the REST Introduction for details.

Google Ads API

Manage your Google Ads accounts, campaigns, and reports with this API.

Service: googleads.googleapis.com

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://googleads.googleapis.com

REST Resource: v8

Methods
listPlannableLocations POST /v8:listPlannableLocations
Returns the list of plannable locations (for example, countries & DMAs).
listPlannableProducts POST /v8:listPlannableProducts
Returns the list of per-location plannable YouTube ad formats with allowed targeting.

REST Resource: v8.carrierConstants

Methods
get GET /v8/{resourceName=carrierConstants/*}
Returns the requested carrier constant in full detail.

REST Resource: v8.currencyConstants

Methods
get GET /v8/{resourceName=currencyConstants/*}
Returns the requested currency constant.

REST Resource: v8.customers

Methods
createCustomerClient POST /v8/customers/{customerId}:createCustomerClient
Creates a new client under manager.
generateKeywordIdeas POST /v8/customers/{customerId}:generateKeywordIdeas
Returns a list of keyword ideas.
generateProductMixIdeas POST /v8/customers/{customerId}:generateProductMixIdeas
Generates a product mix ideas given a set of preferences.
generateReachForecast POST /v8/customers/{customerId}:generateReachForecast
Generates a reach forecast for a given targeting / product mix.
get GET /v8/{resourceName=customers/*}
Returns the requested customer in full detail.
getHotelPerformanceView GET /v8/{resourceName=customers/*/hotelPerformanceView}
Returns the requested Hotel Performance View in full detail.
getShoppingPerformanceView GET /v8/{resourceName=customers/*/shoppingPerformanceView}
Returns the requested Shopping performance view in full detail.
listAccessibleCustomers GET /v8/customers:listAccessibleCustomers
Returns resource names of customers directly accessible by the user authenticating the call.
mutate POST /v8/customers/{customerId}:mutate
Updates a customer.
suggestSmartCampaignAd POST /v8/customers/{customerId}:suggestSmartCampaignAd
Suggests a Smart campaign ad compatible with the Ad family of resources, based on data points such as targeting and the business to advertise.
suggestSmartCampaignBudgetOptions POST /v8/customers/{customerId}:suggestSmartCampaignBudgetOptions
Returns BudgetOption suggestions.
uploadCallConversions POST /v8/customers/{customerId}:uploadCallConversions
Processes the given call conversions.
uploadClickConversions POST /v8/customers/{customerId}:uploadClickConversions
Processes the given click conversions.
uploadConversionAdjustments POST /v8/customers/{customerId}:uploadConversionAdjustments
Processes the given conversion adjustments.
uploadUserData POST /v8/customers/{customerId}:uploadUserData
Uploads the given user data.

REST Resource: v8.customers.accessibleBiddingStrategies

Methods
get GET /v8/{resourceName=customers/*/accessibleBiddingStrategies/*}
Returns the requested accessible bidding strategy in full detail.

REST Resource: v8.customers.accountBudgetProposals

Methods
get GET /v8/{resourceName=customers/*/accountBudgetProposals/*}
Returns an account-level budget proposal in full detail.
mutate POST /v8/customers/{customerId}/accountBudgetProposals:mutate
Creates, updates, or removes account budget proposals.

REST Resource: v8.customers.accountBudgets

Methods
get GET /v8/{resourceName=customers/*/accountBudgets/*}
Returns an account-level budget in full detail.

REST Resource: v8.customers.adGroupAdAssetViews

Methods
get GET /v8/{resourceName=customers/*/adGroupAdAssetViews/*}
Returns the requested ad group ad asset view in full detail.

REST Resource: v8.customers.adGroupAdLabels

Methods
get GET /v8/{resourceName=customers/*/adGroupAdLabels/*}
Returns the requested ad group ad label in full detail.
mutate POST /v8/customers/{customerId}/adGroupAdLabels:mutate
Creates and removes ad group ad labels.

REST Resource: v8.customers.adGroupAds

Methods
get GET /v8/{resourceName=customers/*/adGroupAds/*}
Returns the requested ad in full detail.
mutate POST /v8/customers/{customerId}/adGroupAds:mutate
Creates, updates, or removes ads.

REST Resource: v8.customers.adGroupAssets

Methods
get GET /v8/{resourceName=customers/*/adGroupAssets/*}
Returns the requested ad group asset in full detail.
mutate POST /v8/customers/{customerId}/adGroupAssets:mutate
Creates, updates, or removes ad group assets.

REST Resource: v8.customers.adGroupAudienceViews

Methods
get GET /v8/{resourceName=customers/*/adGroupAudienceViews/*}
Returns the requested ad group audience view in full detail.

REST Resource: v8.customers.adGroupBidModifiers

Methods
get GET /v8/{resourceName=customers/*/adGroupBidModifiers/*}
Returns the requested ad group bid modifier in full detail.
mutate POST /v8/customers/{customerId}/adGroupBidModifiers:mutate
Creates, updates, or removes ad group bid modifiers.

REST Resource: v8.customers.adGroupCriteria

Methods
get GET /v8/{resourceName=customers/*/adGroupCriteria/*}
Returns the requested criterion in full detail.
mutate POST /v8/customers/{customerId}/adGroupCriteria:mutate
Creates, updates, or removes criteria.

REST Resource: v8.customers.adGroupCriterionLabels

Methods
get GET /v8/{resourceName=customers/*/adGroupCriterionLabels/*}
Returns the requested ad group criterion label in full detail.
mutate POST /v8/customers/{customerId}/adGroupCriterionLabels:mutate
Creates and removes ad group criterion labels.

REST Resource: v8.customers.adGroupCriterionSimulations

Methods
get GET /v8/{resourceName=customers/*/adGroupCriterionSimulations/*}
Returns the requested ad group criterion simulation in full detail.

REST Resource: v8.customers.adGroupExtensionSettings

Methods
get GET /v8/{resourceName=customers/*/adGroupExtensionSettings/*}
Returns the requested ad group extension setting in full detail.
mutate POST /v8/customers/{customerId}/adGroupExtensionSettings:mutate
Creates, updates, or removes ad group extension settings.

REST Resource: v8.customers.adGroupFeeds

Methods
get GET /v8/{resourceName=customers/*/adGroupFeeds/*}
Returns the requested ad group feed in full detail.
mutate POST /v8/customers/{customerId}/adGroupFeeds:mutate
Creates, updates, or removes ad group feeds.

REST Resource: v8.customers.adGroupLabels

Methods
get GET /v8/{resourceName=customers/*/adGroupLabels/*}
Returns the requested ad group label in full detail.
mutate POST /v8/customers/{customerId}/adGroupLabels:mutate
Creates and removes ad group labels.

REST Resource: v8.customers.adGroupSimulations

Methods
get GET /v8/{resourceName=customers/*/adGroupSimulations/*}
Returns the requested ad group simulation in full detail.

REST Resource: v8.customers.adGroups

Methods
get GET /v8/{resourceName=customers/*/adGroups/*}
Returns the requested ad group in full detail.
mutate POST /v8/customers/{customerId}/adGroups:mutate
Creates, updates, or removes ad groups.

REST Resource: v8.customers.adParameters

Methods
get GET /v8/{resourceName=customers/*/adParameters/*}
Returns the requested ad parameter in full detail.
mutate POST /v8/customers/{customerId}/adParameters:mutate
Creates, updates, or removes ad parameters.

REST Resource: v8.customers.adScheduleViews

Methods
get GET /v8/{resourceName=customers/*/adScheduleViews/*}
Returns the requested ad schedule view in full detail.

REST Resource: v8.customers.ads

Methods
get GET /v8/{resourceName=customers/*/ads/*}
Returns the requested ad in full detail.
mutate POST /v8/customers/{customerId}/ads:mutate
Updates ads.

REST Resource: v8.customers.ageRangeViews

Methods
get GET /v8/{resourceName=customers/*/ageRangeViews/*}
Returns the requested age range view in full detail.

REST Resource: v8.customers.assetFieldTypeViews

Methods
get GET /v8/{resourceName=customers/*/assetFieldTypeViews/*}
Returns the requested asset field type view in full detail.

REST Resource: v8.customers.assets

Methods
get GET /v8/{resourceName=customers/*/assets/*}
Returns the requested asset in full detail.
mutate POST /v8/customers/{customerId}/assets:mutate
Creates assets.

REST Resource: v8.customers.batchJobs

Methods
addOperations POST /v8/{resourceName=customers/*/batchJobs/*}:addOperations
Add operations to the batch job.
get GET /v8/{resourceName=customers/*/batchJobs/*}
Returns the batch job.
listResults GET /v8/{resourceName=customers/*/batchJobs/*}:listResults
Returns the results of the batch job.
mutate POST /v8/customers/{customerId}/batchJobs:mutate
Mutates a batch job.
run POST /v8/{resourceName=customers/*/batchJobs/*}:run
Runs the batch job.

REST Resource: v8.customers.biddingDataExclusions

Methods
get GET /v8/{resourceName=customers/*/biddingDataExclusions/*}
Returns the requested data exclusion in full detail.
mutate POST /v8/customers/{customerId}/biddingDataExclusions:mutate
Creates, updates, or removes data exclusions.

REST Resource: v8.customers.biddingSeasonalityAdjustments

Methods
get GET /v8/{resourceName=customers/*/biddingSeasonalityAdjustments/*}
Returns the requested seasonality adjustment in full detail.
mutate POST /v8/customers/{customerId}/biddingSeasonalityAdjustments:mutate
Creates, updates, or removes seasonality adjustments.

REST Resource: v8.customers.biddingStrategies

Methods
get GET /v8/{resourceName=customers/*/biddingStrategies/*}
Returns the requested bidding strategy in full detail.
mutate POST /v8/customers/{customerId}/biddingStrategies:mutate
Creates, updates, or removes bidding strategies.

REST Resource: v8.customers.biddingStrategySimulations

Methods
get GET /v8/{resourceName=customers/*/biddingStrategySimulations/*}
Returns the requested bidding strategy simulation in full detail.

REST Resource: v8.customers.billingSetups

Methods
get GET /v8/{resourceName=customers/*/billingSetups/*}
Returns a billing setup.
mutate POST /v8/customers/{customerId}/billingSetups:mutate
Creates a billing setup, or cancels an existing billing setup.

REST Resource: v8.customers.campaignAssets

Methods
get GET /v8/{resourceName=customers/*/campaignAssets/*}
Returns the requested campaign asset in full detail.
mutate POST /v8/customers/{customerId}/campaignAssets:mutate
Creates, updates, or removes campaign assets.

REST Resource: v8.customers.campaignAudienceViews

Methods
get GET /v8/{resourceName=customers/*/campaignAudienceViews/*}
Returns the requested campaign audience view in full detail.

REST Resource: v8.customers.campaignBidModifiers

Methods
get GET /v8/{resourceName=customers/*/campaignBidModifiers/*}
Returns the requested campaign bid modifier in full detail.
mutate POST /v8/customers/{customerId}/campaignBidModifiers:mutate
Creates, updates, or removes campaign bid modifiers.

REST Resource: v8.customers.campaignBudgets

Methods
get GET /v8/{resourceName=customers/*/campaignBudgets/*}
Returns the requested Campaign Budget in full detail.
mutate POST /v8/customers/{customerId}/campaignBudgets:mutate
Creates, updates, or removes campaign budgets.

REST Resource: v8.customers.campaignCriteria

Methods
get GET /v8/{resourceName=customers/*/campaignCriteria/*}
Returns the requested criterion in full detail.
mutate POST /v8/customers/{customerId}/campaignCriteria:mutate
Creates, updates, or removes criteria.

REST Resource: v8.customers.campaignCriterionSimulations

Methods
get GET /v8/{resourceName=customers/*/campaignCriterionSimulations/*}
Returns the requested campaign criterion simulation in full detail.

REST Resource: v8.customers.campaignDrafts

Methods
get GET /v8/{resourceName=customers/*/campaignDrafts/*}
Returns the requested campaign draft in full detail.
listAsyncErrors GET /v8/{resourceName=customers/*/campaignDrafts/*}:listAsyncErrors
Returns all errors that occurred during CampaignDraft promote.
mutate POST /v8/customers/{customerId}/campaignDrafts:mutate
Creates, updates, or removes campaign drafts.
promote POST /v8/{campaignDraft=customers/*/campaignDrafts/*}:promote
Promotes the changes in a draft back to the base campaign.

REST Resource: v8.customers.campaignExperiments

Methods
create POST /v8/customers/{customerId}/campaignExperiments:create
Creates a campaign experiment based on a campaign draft.
end POST /v8/{campaignExperiment=customers/*/campaignExperiments/*}:end
Immediately ends a campaign experiment, changing the experiment's scheduled end date and without waiting for end of day.
get GET /v8/{resourceName=customers/*/campaignExperiments/*}
Returns the requested campaign experiment in full detail.
graduate POST /v8/{campaignExperiment=customers/*/campaignExperiments/*}:graduate
Graduates a campaign experiment to a full campaign.
listAsyncErrors GET /v8/{resourceName=customers/*/campaignExperiments/*}:listAsyncErrors
Returns all errors that occurred during CampaignExperiment create or promote (whichever occurred last).
mutate POST /v8/customers/{customerId}/campaignExperiments:mutate
Updates campaign experiments.
promote POST /v8/{campaignExperiment=customers/*/campaignExperiments/*}:promote
Promotes the changes in a experiment campaign back to the base campaign.

REST Resource: v8.customers.campaignExtensionSettings

Methods
get GET /v8/{resourceName=customers/*/campaignExtensionSettings/*}
Returns the requested campaign extension setting in full detail.
mutate POST /v8/customers/{customerId}/campaignExtensionSettings:mutate
Creates, updates, or removes campaign extension settings.

REST Resource: v8.customers.campaignFeeds

Methods
get GET /v8/{resourceName=customers/*/campaignFeeds/*}
Returns the requested campaign feed in full detail.
mutate POST /v8/customers/{customerId}/campaignFeeds:mutate
Creates, updates, or removes campaign feeds.

REST Resource: v8.customers.campaignLabels

Methods
get GET /v8/{resourceName=customers/*/campaignLabels/*}
Returns the requested campaign-label relationship in full detail.
mutate POST /v8/customers/{customerId}/campaignLabels:mutate
Creates and removes campaign-label relationships.

REST Resource: v8.customers.campaignSharedSets

Methods
get GET /v8/{resourceName=customers/*/campaignSharedSets/*}
Returns the requested campaign shared set in full detail.
mutate POST /v8/customers/{customerId}/campaignSharedSets:mutate
Creates or removes campaign shared sets.

REST Resource: v8.customers.campaignSimulations

Methods
get GET /v8/{resourceName=customers/*/campaignSimulations/*}
Returns the requested campaign simulation in full detail.

REST Resource: v8.customers.campaigns

Methods
get GET /v8/{resourceName=customers/*/campaigns/*}
Returns the requested campaign in full detail.
mutate POST /v8/customers/{customerId}/campaigns:mutate
Creates, updates, or removes campaigns.

REST Resource: v8.customers.changeStatus

Methods
get GET /v8/{resourceName=customers/*/changeStatus/*}
Returns the requested change status in full detail.

REST Resource: v8.customers.clickViews

Methods
get GET /v8/{resourceName=customers/*/clickViews/*}
Returns the requested click view in full detail.

REST Resource: v8.customers.combinedAudiences

Methods
get GET /v8/{resourceName=customers/*/combinedAudiences/*}
Returns the requested combined audience in full detail.

REST Resource: v8.customers.conversionActions

Methods
get GET /v8/{resourceName=customers/*/conversionActions/*}
Returns the requested conversion action.
mutate POST /v8/customers/{customerId}/conversionActions:mutate
Creates, updates or removes conversion actions.

REST Resource: v8.customers.conversionCustomVariables

Methods
get GET /v8/{resourceName=customers/*/conversionCustomVariables/*}
Returns the requested conversion custom variable.
mutate POST /v8/customers/{customerId}/conversionCustomVariables:mutate
Creates or updates conversion custom variables.

REST Resource: v8.customers.conversionValueRuleSets

Methods
get GET /v8/{resourceName=customers/*/conversionValueRuleSets/*}
Returns the requested conversion value rule set.
mutate POST /v8/customers/{customerId}/conversionValueRuleSets:mutate
Creates, updates or removes conversion value rule sets.

REST Resource: v8.customers.conversionValueRules

Methods
get GET /v8/{resourceName=customers/*/conversionValueRules/*}
Returns the requested conversion value rule.
mutate POST /v8/customers/{customerId}/conversionValueRules:mutate
Creates, updates, or removes conversion value rules.

REST Resource: v8.customers.customAudiences

Methods
get GET /v8/{resourceName=customers/*/customAudiences/*}
Returns the requested custom audience in full detail.
mutate POST /v8/customers/{customerId}/customAudiences:mutate
Creates or updates custom audiences.

REST Resource: v8.customers.customInterests

Methods
get GET /v8/{resourceName=customers/*/customInterests/*}
Returns the requested custom interest in full detail.
mutate POST /v8/customers/{customerId}/customInterests:mutate
Creates or updates custom interests.

REST Resource: v8.customers.customerAssets

Methods
get GET /v8/{resourceName=customers/*/customerAssets/*}
Returns the requested customer asset in full detail.
mutate POST /v8/customers/{customerId}/customerAssets:mutate
Creates, updates, or removes customer assets.

REST Resource: v8.customers.customerClients

Methods
get GET /v8/{resourceName=customers/*/customerClients/*}
Returns the requested client in full detail.

REST Resource: v8.customers.customerExtensionSettings

Methods
get GET /v8/{resourceName=customers/*/customerExtensionSettings/*}
Returns the requested customer extension setting in full detail.
mutate POST /v8/customers/{customerId}/customerExtensionSettings:mutate
Creates, updates, or removes customer extension settings.

REST Resource: v8.customers.customerFeeds

Methods
get GET /v8/{resourceName=customers/*/customerFeeds/*}
Returns the requested customer feed in full detail.
mutate POST /v8/customers/{customerId}/customerFeeds:mutate
Creates, updates, or removes customer feeds.

REST Resource: v8.customers.customerLabels

Methods
get GET /v8/{resourceName=customers/*/customerLabels/*}
Returns the requested customer-label relationship in full detail.
mutate POST /v8/customers/{customerId}/customerLabels:mutate
Creates and removes customer-label relationships.

REST Resource: v8.customers.customerNegativeCriteria

Methods
get GET /v8/{resourceName=customers/*/customerNegativeCriteria/*}
Returns the requested criterion in full detail.
mutate POST /v8/customers/{customerId}/customerNegativeCriteria:mutate
Creates or removes criteria.

REST Resource: v8.customers.customerUserAccessInvitations

Methods
get GET /v8/{resourceName=customers/*/customerUserAccessInvitations/*}
Returns the requested access invitation in full detail.
mutate POST /v8/customers/{customerId}/customerUserAccessInvitations:mutate
Creates or removes an access invitation.

REST Resource: v8.customers.customerUserAccesses

Methods
get GET /v8/{resourceName=customers/*/customerUserAccesses/*}
Returns the CustomerUserAccess in full detail.
mutate POST /v8/customers/{customerId}/customerUserAccesses:mutate
Updates, removes permission of a user on a given customer.

REST Resource: v8.customers.detailPlacementViews

Methods
get GET /v8/{resourceName=customers/*/detailPlacementViews/*}
Returns the requested Detail Placement view in full detail.

REST Resource: v8.customers.detailedDemographics

Methods
get GET /v8/{resourceName=customers/*/detailedDemographics/*}
Returns the requested detailed demographic in full detail.

REST Resource: v8.customers.displayKeywordViews

Methods
get GET /v8/{resourceName=customers/*/displayKeywordViews/*}
Returns the requested display keyword view in full detail.

REST Resource: v8.customers.distanceViews

Methods
get GET /v8/{resourceName=customers/*/distanceViews/*}
Returns the attributes of the requested distance view.

REST Resource: v8.customers.domainCategories

Methods
get GET /v8/{resourceName=customers/*/domainCategories/*}
Returns the requested domain category.

REST Resource: v8.customers.dynamicSearchAdsSearchTermViews

Methods
get GET /v8/{resourceName=customers/*/dynamicSearchAdsSearchTermViews/*}
Returns the requested dynamic search ads search term view in full detail.

REST Resource: v8.customers.expandedLandingPageViews

Methods
get GET /v8/{resourceName=customers/*/expandedLandingPageViews/*}
Returns the requested expanded landing page view in full detail.

REST Resource: v8.customers.extensionFeedItems

Methods
get GET /v8/{resourceName=customers/*/extensionFeedItems/*}
Returns the requested extension feed item in full detail.
mutate POST /v8/customers/{customerId}/extensionFeedItems:mutate
Creates, updates, or removes extension feed items.

REST Resource: v8.customers.feedItemSets

Methods
get GET /v8/{resourceName=customers/*/feedItemSets/*}
Returns the requested feed item set in full detail.
mutate POST /v8/customers/{customerId}/feedItemSets:mutate
Creates, updates or removes feed item sets.

REST Resource: v8.customers.feedItemTargets

Methods
get GET /v8/{resourceName=customers/*/feedItemTargets/*}
Returns the requested feed item targets in full detail.
mutate POST /v8/customers/{customerId}/feedItemTargets:mutate
Creates or removes feed item targets.

REST Resource: v8.customers.feedItems

Methods
get GET /v8/{resourceName=customers/*/feedItems/*}
Returns the requested feed item in full detail.
mutate POST /v8/customers/{customerId}/feedItems:mutate
Creates, updates, or removes feed items.

REST Resource: v8.customers.feedMappings

Methods
get GET /v8/{resourceName=customers/*/feedMappings/*}
Returns the requested feed mapping in full detail.
mutate POST /v8/customers/{customerId}/feedMappings:mutate
Creates or removes feed mappings.

REST Resource: v8.customers.feedPlaceholderViews

Methods
get GET /v8/{resourceName=customers/*/feedPlaceholderViews/*}
Returns the requested feed placeholder view in full detail.

REST Resource: v8.customers.feeds

Methods
get GET /v8/{resourceName=customers/*/feeds/*}
Returns the requested feed in full detail.
mutate POST /v8/customers/{customerId}/feeds:mutate
Creates, updates, or removes feeds.

REST Resource: v8.customers.genderViews

Methods
get GET /v8/{resourceName=customers/*/genderViews/*}
Returns the requested gender view in full detail.

REST Resource: v8.customers.geographicViews

Methods
get GET /v8/{resourceName=customers/*/geographicViews/*}
Returns the requested geographic view in full detail.

REST Resource: v8.customers.googleAds

Methods
mutate POST /v8/customers/{customerId}/googleAds:mutate
Creates, updates, or removes resources.
search POST /v8/customers/{customerId}/googleAds:search
Returns all rows that match the search query.
searchStream POST /v8/customers/{customerId}/googleAds:searchStream
Returns all rows that match the search stream query.

REST Resource: v8.customers.groupPlacementViews

Methods
get GET /v8/{resourceName=customers/*/groupPlacementViews/*}
Returns the requested Group Placement view in full detail.

REST Resource: v8.customers.hotelGroupViews

Methods
get GET /v8/{resourceName=customers/*/hotelGroupViews/*}
Returns the requested Hotel Group View in full detail.

REST Resource: v8.customers.incomeRangeViews

Methods
get GET /v8/{resourceName=customers/*/incomeRangeViews/*}
Returns the requested income range view in full detail.

REST Resource: v8.customers.invoices

Methods
list GET /v8/customers/{customerId}/invoices
Returns all invoices associated with a billing setup, for a given month.

REST Resource: v8.customers.keywordPlanAdGroupKeywords

Methods
get GET /v8/{resourceName=customers/*/keywordPlanAdGroupKeywords/*}
Returns the requested Keyword Plan ad group keyword in full detail.
mutate POST /v8/customers/{customerId}/keywordPlanAdGroupKeywords:mutate
Creates, updates, or removes Keyword Plan ad group keywords.

REST Resource: v8.customers.keywordPlanAdGroups

Methods
get GET /v8/{resourceName=customers/*/keywordPlanAdGroups/*}
Returns the requested Keyword Plan ad group in full detail.
mutate POST /v8/customers/{customerId}/keywordPlanAdGroups:mutate
Creates, updates, or removes Keyword Plan ad groups.

REST Resource: v8.customers.keywordPlanCampaignKeywords

Methods
get GET /v8/{resourceName=customers/*/keywordPlanCampaignKeywords/*}
Returns the requested plan in full detail.
mutate POST /v8/customers/{customerId}/keywordPlanCampaignKeywords:mutate
Creates, updates, or removes Keyword Plan campaign keywords.

REST Resource: v8.customers.keywordPlanCampaigns

Methods
get GET /v8/{resourceName=customers/*/keywordPlanCampaigns/*}
Returns the requested Keyword Plan campaign in full detail.
mutate POST /v8/customers/{customerId}/keywordPlanCampaigns:mutate
Creates, updates, or removes Keyword Plan campaigns.

REST Resource: v8.customers.keywordPlans

Methods
generateForecastCurve POST /v8/{keywordPlan=customers/*/keywordPlans/*}:generateForecastCurve
Returns the requested Keyword Plan forecast curve.
generateForecastMetrics POST /v8/{keywordPlan=customers/*/keywordPlans/*}:generateForecastMetrics
Returns the requested Keyword Plan forecasts.
generateForecastTimeSeries POST /v8/{keywordPlan=customers/*/keywordPlans/*}:generateForecastTimeSeries
Returns a forecast in the form of a time series for the Keyword Plan over the next 52 weeks.
generateHistoricalMetrics POST /v8/{keywordPlan=customers/*/keywordPlans/*}:generateHistoricalMetrics
Returns the requested Keyword Plan historical metrics.
get GET /v8/{resourceName=customers/*/keywordPlans/*}
Returns the requested plan in full detail.
mutate POST /v8/customers/{customerId}/keywordPlans:mutate
Creates, updates, or removes keyword plans.

REST Resource: v8.customers.keywordViews

Methods
get GET /v8/{resourceName=customers/*/keywordViews/*}
Returns the requested keyword view in full detail.

REST Resource: v8.customers.labels

Methods
get GET /v8/{resourceName=customers/*/labels/*}
Returns the requested label in full detail.
mutate POST /v8/customers/{customerId}/labels:mutate
Creates, updates, or removes labels.

REST Resource: v8.customers.landingPageViews

Methods
get GET /v8/{resourceName=customers/*/landingPageViews/*}
Returns the requested landing page view in full detail.

REST Resource: v8.customers.lifeEvents

Methods
get GET /v8/{resourceName=customers/*/lifeEvents/*}
Returns the requested life event in full detail.

REST Resource: v8.customers.locationViews

Methods
get GET /v8/{resourceName=customers/*/locationViews/*}
Returns the requested location view in full detail.

REST Resource: v8.customers.managedPlacementViews

Methods
get GET /v8/{resourceName=customers/*/managedPlacementViews/*}
Returns the requested Managed Placement view in full detail.

REST Resource: v8.customers.mediaFiles

Methods
get GET /v8/{resourceName=customers/*/mediaFiles/*}
Returns the requested media file in full detail.
mutate POST /v8/customers/{customerId}/mediaFiles:mutate
Creates media files.

REST Resource: v8.customers.offlineUserDataJobs

Methods
addOperations POST /v8/{resourceName=customers/*/offlineUserDataJobs/*}:addOperations
Adds operations to the offline user data job.
create POST /v8/customers/{customerId}/offlineUserDataJobs:create
Creates an offline user data job.
get GET /v8/{resourceName=customers/*/offlineUserDataJobs/*}
Returns the offline user data job.
run POST /v8/{resourceName=customers/*/offlineUserDataJobs/*}:run
Runs the offline user data job.

REST Resource: v8.customers.operations

Methods
cancel POST /v8/{name=customers/*/operations/*}:cancel
Starts asynchronous cancellation on a long-running operation.
delete DELETE /v8/{name=customers/*/operations/*}
Deletes a long-running operation.
get GET /v8/{name=customers/*/operations/*}
Gets the latest state of a long-running operation.
list GET /v8/{name=customers/*/operations}
Lists operations that match the specified filter in the request.
wait POST /v8/{name=customers/*/operations/*}:wait
Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state.

REST Resource: v8.customers.paidOrganicSearchTermViews

Methods
get GET /v8/{resourceName=customers/*/paidOrganicSearchTermViews/*}
Returns the requested paid organic search term view in full detail.

REST Resource: v8.customers.parentalStatusViews

Methods
get GET /v8/{resourceName=customers/*/parentalStatusViews/*}
Returns the requested parental status view in full detail.

REST Resource: v8.customers.paymentsAccounts

Methods
list GET /v8/customers/{customerId}/paymentsAccounts
Returns all payments accounts associated with all managers between the login customer ID and specified serving customer in the hierarchy, inclusive.

REST Resource: v8.customers.productGroupViews

Methods
get GET /v8/{resourceName=customers/*/productGroupViews/*}
Returns the requested product group view in full detail.

REST Resource: v8.customers.recommendations

Methods
apply POST /v8/customers/{customerId}/recommendations:apply
Applies given recommendations with corresponding apply parameters.
dismiss POST /v8/customers/{customerId}/recommendations:dismiss
Dismisses given recommendations.
get GET /v8/{resourceName=customers/*/recommendations/*}
Returns the requested recommendation in full detail.

REST Resource: v8.customers.remarketingActions

Methods
get GET /v8/{resourceName=customers/*/remarketingActions/*}
Returns the requested remarketing action in full detail.
mutate POST /v8/customers/{customerId}/remarketingActions:mutate
Creates or updates remarketing actions.

REST Resource: v8.customers.searchTermViews

Methods
get GET /v8/{resourceName=customers/*/searchTermViews/*}
Returns the attributes of the requested search term view.

REST Resource: v8.customers.sharedCriteria

Methods
get GET /v8/{resourceName=customers/*/sharedCriteria/*}
Returns the requested shared criterion in full detail.
mutate POST /v8/customers/{customerId}/sharedCriteria:mutate
Creates or removes shared criteria.

REST Resource: v8.customers.sharedSets

Methods
get GET /v8/{resourceName=customers/*/sharedSets/*}
Returns the requested shared set in full detail.
mutate POST /v8/customers/{customerId}/sharedSets:mutate
Creates, updates, or removes shared sets.

REST Resource: v8.customers.smartCampaignSearchTermViews

Methods
get GET /v8/{resourceName=customers/*/smartCampaignSearchTermViews/*}
Returns the attributes of the requested Smart campaign search term view.

REST Resource: v8.customers.smartCampaignSettings

Methods
get GET /v8/{resourceName=customers/*/smartCampaignSettings/*}
Returns the requested Smart campaign setting in full detail.
mutate POST /v8/customers/{customerId}/smartCampaignSettings:mutate
Updates Smart campaign settings for campaigns.

REST Resource: v8.customers.topicViews

Methods
get GET /v8/{resourceName=customers/*/topicViews/*}
Returns the requested topic view in full detail.

REST Resource: v8.customers.userInterests

Methods
get GET /v8/{resourceName=customers/*/userInterests/*}

Returns the requested user interest in full detail

List of thrown errors: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

REST Resource: v8.customers.userLists

Methods
get GET /v8/{resourceName=customers/*/userLists/*}
Returns the requested user list.
mutate POST /v8/customers/{customerId}/userLists:mutate
Creates or updates user lists.

REST Resource: v8.customers.userLocationViews

Methods
get GET /v8/{resourceName=customers/*/userLocationViews/*}
Returns the requested user location view in full detail.

REST Resource: v8.customers.videos

Methods
get GET /v8/{resourceName=customers/*/videos/*}
Returns the requested video in full detail.

REST Resource: v8.customers.webpageViews

Methods
get GET /v8/{resourceName=customers/*/webpageViews/*}
Returns the requested webpage view in full detail.

REST Resource: v8.geoTargetConstants

Methods
get GET /v8/{resourceName=geoTargetConstants/*}
Returns the requested geo target constant in full detail.
suggest POST /v8/geoTargetConstants:suggest
Returns GeoTargetConstant suggestions by location name or by resource name.

REST Resource: v8.googleAdsFields

Methods
get GET /v8/{resourceName=googleAdsFields/*}
Returns just the requested field.
search POST /v8/googleAdsFields:search
Returns all fields that match the search query.

REST Resource: v8.keywordThemeConstants

Methods
get GET /v8/{resourceName=keywordThemeConstants/*}
Returns the requested keyword theme constant in full detail.
suggest POST /v8/keywordThemeConstants:suggest
Returns KeywordThemeConstant suggestions by keyword themes.

REST Resource: v8.languageConstants

Methods
get GET /v8/{resourceName=languageConstants/*}
Returns the requested language constant.

REST Resource: v8.mobileAppCategoryConstants

Methods
get GET /v8/{resourceName=mobileAppCategoryConstants/*}
Returns the requested mobile app category constant.

REST Resource: v8.mobileDeviceConstants

Methods
get GET /v8/{resourceName=mobileDeviceConstants/*}
Returns the requested mobile device constant in full detail.

REST Resource: v8.operatingSystemVersionConstants

Methods
get GET /v8/{resourceName=operatingSystemVersionConstants/*}
Returns the requested OS version constant in full detail.

REST Resource: v8.productBiddingCategoryConstants

Methods
get GET /v8/{resourceName=productBiddingCategoryConstants/*}
Returns the requested Product Bidding Category in full detail.

REST Resource: v8.topicConstants

Methods
get GET /v8/{resourceName=topicConstants/*}
Returns the requested topic constant in full detail.

REST Resource: v7

Methods
listPlannableLocations POST /v7:listPlannableLocations
Returns the list of plannable locations (for example, countries & DMAs).
listPlannableProducts POST /v7:listPlannableProducts
Returns the list of per-location plannable YouTube ad formats with allowed targeting.

REST Resource: v7.carrierConstants

Methods
get GET /v7/{resourceName=carrierConstants/*}
Returns the requested carrier constant in full detail.

REST Resource: v7.currencyConstants

Methods
get GET /v7/{resourceName=currencyConstants/*}
Returns the requested currency constant.

REST Resource: v7.customers

Methods
createCustomerClient POST /v7/customers/{customerId}:createCustomerClient
Creates a new client under manager.
generateKeywordIdeas POST /v7/customers/{customerId}:generateKeywordIdeas
Returns a list of keyword ideas.
generateProductMixIdeas POST /v7/customers/{customerId}:generateProductMixIdeas
Generates a product mix ideas given a set of preferences.
generateReachForecast POST /v7/customers/{customerId}:generateReachForecast
Generates a reach forecast for a given targeting / product mix.
get GET /v7/{resourceName=customers/*}
Returns the requested customer in full detail.
getHotelPerformanceView GET /v7/{resourceName=customers/*/hotelPerformanceView}
Returns the requested Hotel Performance View in full detail.
getShoppingPerformanceView GET /v7/{resourceName=customers/*/shoppingPerformanceView}
Returns the requested Shopping performance view in full detail.
listAccessibleCustomers GET /v7/customers:listAccessibleCustomers
Returns resource names of customers directly accessible by the user authenticating the call.
mutate POST /v7/customers/{customerId}:mutate
Updates a customer.
uploadCallConversions POST /v7/customers/{customerId}:uploadCallConversions
Processes the given call conversions.
uploadClickConversions POST /v7/customers/{customerId}:uploadClickConversions
Processes the given click conversions.
uploadConversionAdjustments POST /v7/customers/{customerId}:uploadConversionAdjustments
Processes the given conversion adjustments.
uploadUserData POST /v7/customers/{customerId}:uploadUserData
Uploads the given user data.

REST Resource: v7.customers.accountBudgetProposals

Methods
get GET /v7/{resourceName=customers/*/accountBudgetProposals/*}
Returns an account-level budget proposal in full detail.
mutate POST /v7/customers/{customerId}/accountBudgetProposals:mutate
Creates, updates, or removes account budget proposals.

REST Resource: v7.customers.accountBudgets

Methods
get GET /v7/{resourceName=customers/*/accountBudgets/*}
Returns an account-level budget in full detail.

REST Resource: v7.customers.adGroupAdAssetViews

Methods
get GET /v7/{resourceName=customers/*/adGroupAdAssetViews/*}
Returns the requested ad group ad asset view in full detail.

REST Resource: v7.customers.adGroupAdLabels

Methods
get GET /v7/{resourceName=customers/*/adGroupAdLabels/*}
Returns the requested ad group ad label in full detail.
mutate POST /v7/customers/{customerId}/adGroupAdLabels:mutate
Creates and removes ad group ad labels.

REST Resource: v7.customers.adGroupAds

Methods
get GET /v7/{resourceName=customers/*/adGroupAds/*}
Returns the requested ad in full detail.
mutate POST /v7/customers/{customerId}/adGroupAds:mutate
Creates, updates, or removes ads.

REST Resource: v7.customers.adGroupAssets

Methods
get GET /v7/{resourceName=customers/*/adGroupAssets/*}
Returns the requested ad group asset in full detail.
mutate POST /v7/customers/{customerId}/adGroupAssets:mutate
Creates, updates, or removes ad group assets.

REST Resource: v7.customers.adGroupAudienceViews

Methods
get GET /v7/{resourceName=customers/*/adGroupAudienceViews/*}
Returns the requested ad group audience view in full detail.

REST Resource: v7.customers.adGroupBidModifiers

Methods
get GET /v7/{resourceName=customers/*/adGroupBidModifiers/*}
Returns the requested ad group bid modifier in full detail.
mutate POST /v7/customers/{customerId}/adGroupBidModifiers:mutate
Creates, updates, or removes ad group bid modifiers.

REST Resource: v7.customers.adGroupCriteria

Methods
get GET /v7/{resourceName=customers/*/adGroupCriteria/*}
Returns the requested criterion in full detail.
mutate POST /v7/customers/{customerId}/adGroupCriteria:mutate
Creates, updates, or removes criteria.

REST Resource: v7.customers.adGroupCriterionLabels

Methods
get GET /v7/{resourceName=customers/*/adGroupCriterionLabels/*}
Returns the requested ad group criterion label in full detail.
mutate POST /v7/customers/{customerId}/adGroupCriterionLabels:mutate
Creates and removes ad group criterion labels.

REST Resource: v7.customers.adGroupCriterionSimulations

Methods
get GET /v7/{resourceName=customers/*/adGroupCriterionSimulations/*}
Returns the requested ad group criterion simulation in full detail.

REST Resource: v7.customers.adGroupExtensionSettings

Methods
get GET /v7/{resourceName=customers/*/adGroupExtensionSettings/*}
Returns the requested ad group extension setting in full detail.
mutate POST /v7/customers/{customerId}/adGroupExtensionSettings:mutate
Creates, updates, or removes ad group extension settings.

REST Resource: v7.customers.adGroupFeeds

Methods
get GET /v7/{resourceName=customers/*/adGroupFeeds/*}
Returns the requested ad group feed in full detail.
mutate POST /v7/customers/{customerId}/adGroupFeeds:mutate
Creates, updates, or removes ad group feeds.

REST Resource: v7.customers.adGroupLabels

Methods
get GET /v7/{resourceName=customers/*/adGroupLabels/*}
Returns the requested ad group label in full detail.
mutate POST /v7/customers/{customerId}/adGroupLabels:mutate
Creates and removes ad group labels.

REST Resource: v7.customers.adGroupSimulations

Methods
get GET /v7/{resourceName=customers/*/adGroupSimulations/*}
Returns the requested ad group simulation in full detail.

REST Resource: v7.customers.adGroups

Methods
get GET /v7/{resourceName=customers/*/adGroups/*}
Returns the requested ad group in full detail.
mutate POST /v7/customers/{customerId}/adGroups:mutate
Creates, updates, or removes ad groups.

REST Resource: v7.customers.adParameters

Methods
get GET /v7/{resourceName=customers/*/adParameters/*}
Returns the requested ad parameter in full detail.
mutate POST /v7/customers/{customerId}/adParameters:mutate
Creates, updates, or removes ad parameters.

REST Resource: v7.customers.adScheduleViews

Methods
get GET /v7/{resourceName=customers/*/adScheduleViews/*}
Returns the requested ad schedule view in full detail.

REST Resource: v7.customers.ads

Methods
get GET /v7/{resourceName=customers/*/ads/*}
Returns the requested ad in full detail.
mutate POST /v7/customers/{customerId}/ads:mutate
Updates ads.

REST Resource: v7.customers.ageRangeViews

Methods
get GET /v7/{resourceName=customers/*/ageRangeViews/*}
Returns the requested age range view in full detail.

REST Resource: v7.customers.assets

Methods
get GET /v7/{resourceName=customers/*/assets/*}
Returns the requested asset in full detail.
mutate POST /v7/customers/{customerId}/assets:mutate
Creates assets.

REST Resource: v7.customers.batchJobs

Methods
addOperations POST /v7/{resourceName=customers/*/batchJobs/*}:addOperations
Add operations to the batch job.
get GET /v7/{resourceName=customers/*/batchJobs/*}
Returns the batch job.
listResults GET /v7/{resourceName=customers/*/batchJobs/*}:listResults
Returns the results of the batch job.
mutate POST /v7/customers/{customerId}/batchJobs:mutate
Mutates a batch job.
run POST /v7/{resourceName=customers/*/batchJobs/*}:run
Runs the batch job.

REST Resource: v7.customers.biddingStrategies

Methods
get GET /v7/{resourceName=customers/*/biddingStrategies/*}
Returns the requested bidding strategy in full detail.
mutate POST /v7/customers/{customerId}/biddingStrategies:mutate
Creates, updates, or removes bidding strategies.

REST Resource: v7.customers.biddingStrategySimulations

Methods
get GET /v7/{resourceName=customers/*/biddingStrategySimulations/*}
Returns the requested bidding strategy simulation in full detail.

REST Resource: v7.customers.billingSetups

Methods
get GET /v7/{resourceName=customers/*/billingSetups/*}
Returns a billing setup.
mutate POST /v7/customers/{customerId}/billingSetups:mutate
Creates a billing setup, or cancels an existing billing setup.

REST Resource: v7.customers.campaignAssets

Methods
get GET /v7/{resourceName=customers/*/campaignAssets/*}
Returns the requested campaign asset in full detail.
mutate POST /v7/customers/{customerId}/campaignAssets:mutate
Creates, updates, or removes campaign assets.

REST Resource: v7.customers.campaignAudienceViews

Methods
get GET /v7/{resourceName=customers/*/campaignAudienceViews/*}
Returns the requested campaign audience view in full detail.

REST Resource: v7.customers.campaignBidModifiers

Methods
get GET /v7/{resourceName=customers/*/campaignBidModifiers/*}
Returns the requested campaign bid modifier in full detail.
mutate POST /v7/customers/{customerId}/campaignBidModifiers:mutate
Creates, updates, or removes campaign bid modifiers.

REST Resource: v7.customers.campaignBudgets

Methods
get GET /v7/{resourceName=customers/*/campaignBudgets/*}
Returns the requested Campaign Budget in full detail.
mutate POST /v7/customers/{customerId}/campaignBudgets:mutate
Creates, updates, or removes campaign budgets.

REST Resource: v7.customers.campaignCriteria

Methods
get GET /v7/{resourceName=customers/*/campaignCriteria/*}
Returns the requested criterion in full detail.
mutate POST /v7/customers/{customerId}/campaignCriteria:mutate
Creates, updates, or removes criteria.

REST Resource: v7.customers.campaignCriterionSimulations

Methods
get GET /v7/{resourceName=customers/*/campaignCriterionSimulations/*}
Returns the requested campaign criterion simulation in full detail.

REST Resource: v7.customers.campaignDrafts

Methods
get GET /v7/{resourceName=customers/*/campaignDrafts/*}
Returns the requested campaign draft in full detail.
listAsyncErrors GET /v7/{resourceName=customers/*/campaignDrafts/*}:listAsyncErrors
Returns all errors that occurred during CampaignDraft promote.
mutate POST /v7/customers/{customerId}/campaignDrafts:mutate
Creates, updates, or removes campaign drafts.
promote POST /v7/{campaignDraft=customers/*/campaignDrafts/*}:promote
Promotes the changes in a draft back to the base campaign.

REST Resource: v7.customers.campaignExperiments

Methods
create POST /v7/customers/{customerId}/campaignExperiments:create
Creates a campaign experiment based on a campaign draft.
end POST /v7/{campaignExperiment=customers/*/campaignExperiments/*}:end
Immediately ends a campaign experiment, changing the experiment's scheduled end date and without waiting for end of day.
get GET /v7/{resourceName=customers/*/campaignExperiments/*}
Returns the requested campaign experiment in full detail.
graduate POST /v7/{campaignExperiment=customers/*/campaignExperiments/*}:graduate
Graduates a campaign experiment to a full campaign.
listAsyncErrors GET /v7/{resourceName=customers/*/campaignExperiments/*}:listAsyncErrors
Returns all errors that occurred during CampaignExperiment create or promote (whichever occurred last).
mutate POST /v7/customers/{customerId}/campaignExperiments:mutate
Updates campaign experiments.
promote POST /v7/{campaignExperiment=customers/*/campaignExperiments/*}:promote
Promotes the changes in a experiment campaign back to the base campaign.

REST Resource: v7.customers.campaignExtensionSettings

Methods
get GET /v7/{resourceName=customers/*/campaignExtensionSettings/*}
Returns the requested campaign extension setting in full detail.
mutate POST /v7/customers/{customerId}/campaignExtensionSettings:mutate
Creates, updates, or removes campaign extension settings.

REST Resource: v7.customers.campaignFeeds

Methods
get GET /v7/{resourceName=customers/*/campaignFeeds/*}
Returns the requested campaign feed in full detail.
mutate POST /v7/customers/{customerId}/campaignFeeds:mutate
Creates, updates, or removes campaign feeds.

REST Resource: v7.customers.campaignLabels

Methods
get GET /v7/{resourceName=customers/*/campaignLabels/*}
Returns the requested campaign-label relationship in full detail.
mutate POST /v7/customers/{customerId}/campaignLabels:mutate
Creates and removes campaign-label relationships.

REST Resource: v7.customers.campaignSharedSets

Methods
get GET /v7/{resourceName=customers/*/campaignSharedSets/*}
Returns the requested campaign shared set in full detail.
mutate POST /v7/customers/{customerId}/campaignSharedSets:mutate
Creates or removes campaign shared sets.

REST Resource: v7.customers.campaignSimulations

Methods
get GET /v7/{resourceName=customers/*/campaignSimulations/*}
Returns the requested campaign simulation in full detail.

REST Resource: v7.customers.campaigns

Methods
get GET /v7/{resourceName=customers/*/campaigns/*}
Returns the requested campaign in full detail.
mutate POST /v7/customers/{customerId}/campaigns:mutate
Creates, updates, or removes campaigns.

REST Resource: v7.customers.changeStatus

Methods
get GET /v7/{resourceName=customers/*/changeStatus/*}
Returns the requested change status in full detail.

REST Resource: v7.customers.clickViews

Methods
get GET /v7/{resourceName=customers/*/clickViews/*}
Returns the requested click view in full detail.

REST Resource: v7.customers.combinedAudiences

Methods
get GET /v7/{resourceName=customers/*/combinedAudiences/*}
Returns the requested combined audience in full detail.

REST Resource: v7.customers.conversionActions

Methods
get GET /v7/{resourceName=customers/*/conversionActions/*}
Returns the requested conversion action.
mutate POST /v7/customers/{customerId}/conversionActions:mutate
Creates, updates or removes conversion actions.

REST Resource: v7.customers.conversionCustomVariables

Methods
get GET /v7/{resourceName=customers/*/conversionCustomVariables/*}
Returns the requested conversion custom variable.
mutate POST /v7/customers/{customerId}/conversionCustomVariables:mutate
Creates or updates conversion custom variables.

REST Resource: v7.customers.customAudiences

Methods
get GET /v7/{resourceName=customers/*/customAudiences/*}
Returns the requested custom audience in full detail.
mutate POST /v7/customers/{customerId}/customAudiences:mutate
Creates or updates custom audiences.

REST Resource: v7.customers.customInterests

Methods
get GET /v7/{resourceName=customers/*/customInterests/*}
Returns the requested custom interest in full detail.
mutate POST /v7/customers/{customerId}/customInterests:mutate
Creates or updates custom interests.

REST Resource: v7.customers.customerAssets

Methods
get GET /v7/{resourceName=customers/*/customerAssets/*}
Returns the requested customer asset in full detail.
mutate POST /v7/customers/{customerId}/customerAssets:mutate
Creates, updates, or removes customer assets.

REST Resource: v7.customers.customerClients

Methods
get GET /v7/{resourceName=customers/*/customerClients/*}
Returns the requested client in full detail.

REST Resource: v7.customers.customerExtensionSettings

Methods
get GET /v7/{resourceName=customers/*/customerExtensionSettings/*}
Returns the requested customer extension setting in full detail.
mutate POST /v7/customers/{customerId}/customerExtensionSettings:mutate
Creates, updates, or removes customer extension settings.

REST Resource: v7.customers.customerFeeds

Methods
get GET /v7/{resourceName=customers/*/customerFeeds/*}
Returns the requested customer feed in full detail.
mutate POST /v7/customers/{customerId}/customerFeeds:mutate
Creates, updates, or removes customer feeds.

REST Resource: v7.customers.customerLabels

Methods
get GET /v7/{resourceName=customers/*/customerLabels/*}
Returns the requested customer-label relationship in full detail.
mutate POST /v7/customers/{customerId}/customerLabels:mutate
Creates and removes customer-label relationships.

REST Resource: v7.customers.customerNegativeCriteria

Methods
get GET /v7/{resourceName=customers/*/customerNegativeCriteria/*}
Returns the requested criterion in full detail.
mutate POST /v7/customers/{customerId}/customerNegativeCriteria:mutate
Creates or removes criteria.

REST Resource: v7.customers.customerUserAccessInvitations

Methods
get GET /v7/{resourceName=customers/*/customerUserAccessInvitations/*}
Returns the requested access invitation in full detail.
mutate POST /v7/customers/{customerId}/customerUserAccessInvitations:mutate
Creates or removes an access invitation.

REST Resource: v7.customers.customerUserAccesses

Methods
get GET /v7/{resourceName=customers/*/customerUserAccesses/*}
Returns the CustomerUserAccess in full detail.
mutate POST /v7/customers/{customerId}/customerUserAccesses:mutate
Updates, removes permission of a user on a given customer.

REST Resource: v7.customers.detailPlacementViews

Methods
get GET /v7/{resourceName=customers/*/detailPlacementViews/*}
Returns the requested Detail Placement view in full detail.

REST Resource: v7.customers.displayKeywordViews

Methods
get GET /v7/{resourceName=customers/*/displayKeywordViews/*}
Returns the requested display keyword view in full detail.

REST Resource: v7.customers.distanceViews

Methods
get GET /v7/{resourceName=customers/*/distanceViews/*}
Returns the attributes of the requested distance view.

REST Resource: v7.customers.domainCategories

Methods
get GET /v7/{resourceName=customers/*/domainCategories/*}
Returns the requested domain category.

REST Resource: v7.customers.dynamicSearchAdsSearchTermViews

Methods
get GET /v7/{resourceName=customers/*/dynamicSearchAdsSearchTermViews/*}
Returns the requested dynamic search ads search term view in full detail.

REST Resource: v7.customers.expandedLandingPageViews

Methods
get GET /v7/{resourceName=customers/*/expandedLandingPageViews/*}
Returns the requested expanded landing page view in full detail.

REST Resource: v7.customers.extensionFeedItems

Methods
get GET /v7/{resourceName=customers/*/extensionFeedItems/*}
Returns the requested extension feed item in full detail.
mutate POST /v7/customers/{customerId}/extensionFeedItems:mutate
Creates, updates, or removes extension feed items.

REST Resource: v7.customers.feedItemSets

Methods
get GET /v7/{resourceName=customers/*/feedItemSets/*}
Returns the requested feed item set in full detail.
mutate POST /v7/customers/{customerId}/feedItemSets:mutate
Creates, updates or removes feed item sets.

REST Resource: v7.customers.feedItemTargets

Methods
get GET /v7/{resourceName=customers/*/feedItemTargets/*}
Returns the requested feed item targets in full detail.
mutate POST /v7/customers/{customerId}/feedItemTargets:mutate
Creates or removes feed item targets.

REST Resource: v7.customers.feedItems

Methods
get GET /v7/{resourceName=customers/*/feedItems/*}
Returns the requested feed item in full detail.
mutate POST /v7/customers/{customerId}/feedItems:mutate
Creates, updates, or removes feed items.

REST Resource: v7.customers.feedMappings

Methods
get GET /v7/{resourceName=customers/*/feedMappings/*}
Returns the requested feed mapping in full detail.
mutate POST /v7/customers/{customerId}/feedMappings:mutate
Creates or removes feed mappings.

REST Resource: v7.customers.feedPlaceholderViews

Methods
get GET /v7/{resourceName=customers/*/feedPlaceholderViews/*}
Returns the requested feed placeholder view in full detail.

REST Resource: v7.customers.feeds

Methods
get GET /v7/{resourceName=customers/*/feeds/*}
Returns the requested feed in full detail.
mutate POST /v7/customers/{customerId}/feeds:mutate
Creates, updates, or removes feeds.

REST Resource: v7.customers.genderViews

Methods
get GET /v7/{resourceName=customers/*/genderViews/*}
Returns the requested gender view in full detail.

REST Resource: v7.customers.geographicViews

Methods
get GET /v7/{resourceName=customers/*/geographicViews/*}
Returns the requested geographic view in full detail.

REST Resource: v7.customers.googleAds

Methods
mutate POST /v7/customers/{customerId}/googleAds:mutate
Creates, updates, or removes resources.
search POST /v7/customers/{customerId}/googleAds:search
Returns all rows that match the search query.
searchStream POST /v7/customers/{customerId}/googleAds:searchStream
Returns all rows that match the search stream query.

REST Resource: v7.customers.groupPlacementViews

Methods
get GET /v7/{resourceName=customers/*/groupPlacementViews/*}
Returns the requested Group Placement view in full detail.

REST Resource: v7.customers.hotelGroupViews

Methods
get GET /v7/{resourceName=customers/*/hotelGroupViews/*}
Returns the requested Hotel Group View in full detail.

REST Resource: v7.customers.incomeRangeViews

Methods
get GET /v7/{resourceName=customers/*/incomeRangeViews/*}
Returns the requested income range view in full detail.

REST Resource: v7.customers.invoices

Methods
list GET /v7/customers/{customerId}/invoices
Returns all invoices associated with a billing setup, for a given month.

REST Resource: v7.customers.keywordPlanAdGroupKeywords

Methods
get GET /v7/{resourceName=customers/*/keywordPlanAdGroupKeywords/*}
Returns the requested Keyword Plan ad group keyword in full detail.
mutate POST /v7/customers/{customerId}/keywordPlanAdGroupKeywords:mutate
Creates, updates, or removes Keyword Plan ad group keywords.

REST Resource: v7.customers.keywordPlanAdGroups

Methods
get GET /v7/{resourceName=customers/*/keywordPlanAdGroups/*}
Returns the requested Keyword Plan ad group in full detail.
mutate POST /v7/customers/{customerId}/keywordPlanAdGroups:mutate
Creates, updates, or removes Keyword Plan ad groups.

REST Resource: v7.customers.keywordPlanCampaignKeywords

Methods
get GET /v7/{resourceName=customers/*/keywordPlanCampaignKeywords/*}
Returns the requested plan in full detail.
mutate POST /v7/customers/{customerId}/keywordPlanCampaignKeywords:mutate
Creates, updates, or removes Keyword Plan campaign keywords.

REST Resource: v7.customers.keywordPlanCampaigns

Methods
get GET /v7/{resourceName=customers/*/keywordPlanCampaigns/*}
Returns the requested Keyword Plan campaign in full detail.
mutate POST /v7/customers/{customerId}/keywordPlanCampaigns:mutate
Creates, updates, or removes Keyword Plan campaigns.

REST Resource: v7.customers.keywordPlans

Methods
generateForecastCurve POST /v7/{keywordPlan=customers/*/keywordPlans/*}:generateForecastCurve
Returns the requested Keyword Plan forecast curve.
generateForecastMetrics POST /v7/{keywordPlan=customers/*/keywordPlans/*}:generateForecastMetrics
Returns the requested Keyword Plan forecasts.
generateForecastTimeSeries POST /v7/{keywordPlan=customers/*/keywordPlans/*}:generateForecastTimeSeries
Returns a forecast in the form of a time series for the Keyword Plan over the next 52 weeks.
generateHistoricalMetrics POST /v7/{keywordPlan=customers/*/keywordPlans/*}:generateHistoricalMetrics
Returns the requested Keyword Plan historical metrics.
get GET /v7/{resourceName=customers/*/keywordPlans/*}
Returns the requested plan in full detail.
mutate POST /v7/customers/{customerId}/keywordPlans:mutate
Creates, updates, or removes keyword plans.

REST Resource: v7.customers.keywordViews

Methods
get GET /v7/{resourceName=customers/*/keywordViews/*}
Returns the requested keyword view in full detail.

REST Resource: v7.customers.labels

Methods
get GET /v7/{resourceName=customers/*/labels/*}
Returns the requested label in full detail.
mutate POST /v7/customers/{customerId}/labels:mutate
Creates, updates, or removes labels.

REST Resource: v7.customers.landingPageViews

Methods
get GET /v7/{resourceName=customers/*/landingPageViews/*}
Returns the requested landing page view in full detail.

REST Resource: v7.customers.lifeEvents

Methods
get GET /v7/{resourceName=customers/*/lifeEvents/*}
Returns the requested life event in full detail.

REST Resource: v7.customers.locationViews

Methods
get GET /v7/{resourceName=customers/*/locationViews/*}
Returns the requested location view in full detail.

REST Resource: v7.customers.managedPlacementViews

Methods
get GET /v7/{resourceName=customers/*/managedPlacementViews/*}
Returns the requested Managed Placement view in full detail.

REST Resource: v7.customers.mediaFiles

Methods
get GET /v7/{resourceName=customers/*/mediaFiles/*}
Returns the requested media file in full detail.
mutate POST /v7/customers/{customerId}/mediaFiles:mutate
Creates media files.

REST Resource: v7.customers.offlineUserDataJobs

Methods
addOperations POST /v7/{resourceName=customers/*/offlineUserDataJobs/*}:addOperations
Adds operations to the offline user data job.
create POST /v7/customers/{customerId}/offlineUserDataJobs:create
Creates an offline user data job.
get GET /v7/{resourceName=customers/*/offlineUserDataJobs/*}
Returns the offline user data job.
run POST /v7/{resourceName=customers/*/offlineUserDataJobs/*}:run
Runs the offline user data job.

REST Resource: v7.customers.operations

Methods
cancel POST /v7/{name=customers/*/operations/*}:cancel
Starts asynchronous cancellation on a long-running operation.
delete DELETE /v7/{name=customers/*/operations/*}
Deletes a long-running operation.
get GET /v7/{name=customers/*/operations/*}
Gets the latest state of a long-running operation.
list GET /v7/{name=customers/*/operations}
Lists operations that match the specified filter in the request.
wait POST /v7/{name=customers/*/operations/*}:wait
Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state.

REST Resource: v7.customers.paidOrganicSearchTermViews

Methods
get GET /v7/{resourceName=customers/*/paidOrganicSearchTermViews/*}
Returns the requested paid organic search term view in full detail.

REST Resource: v7.customers.parentalStatusViews

Methods
get GET /v7/{resourceName=customers/*/parentalStatusViews/*}
Returns the requested parental status view in full detail.

REST Resource: v7.customers.paymentsAccounts

Methods
list GET /v7/customers/{customerId}/paymentsAccounts
Returns all payments accounts associated with all managers between the login customer ID and specified serving customer in the hierarchy, inclusive.

REST Resource: v7.customers.productGroupViews

Methods
get GET /v7/{resourceName=customers/*/productGroupViews/*}
Returns the requested product group view in full detail.

REST Resource: v7.customers.recommendations

Methods
apply POST /v7/customers/{customerId}/recommendations:apply
Applies given recommendations with corresponding apply parameters.
dismiss POST /v7/customers/{customerId}/recommendations:dismiss
Dismisses given recommendations.
get GET /v7/{resourceName=customers/*/recommendations/*}
Returns the requested recommendation in full detail.

REST Resource: v7.customers.remarketingActions

Methods
get GET /v7/{resourceName=customers/*/remarketingActions/*}
Returns the requested remarketing action in full detail.
mutate POST /v7/customers/{customerId}/remarketingActions:mutate
Creates or updates remarketing actions.

REST Resource: v7.customers.searchTermViews

Methods
get GET /v7/{resourceName=customers/*/searchTermViews/*}
Returns the attributes of the requested search term view.

REST Resource: v7.customers.sharedCriteria

Methods
get GET /v7/{resourceName=customers/*/sharedCriteria/*}
Returns the requested shared criterion in full detail.
mutate POST /v7/customers/{customerId}/sharedCriteria:mutate
Creates or removes shared criteria.

REST Resource: v7.customers.sharedSets

Methods
get GET /v7/{resourceName=customers/*/sharedSets/*}
Returns the requested shared set in full detail.
mutate POST /v7/customers/{customerId}/sharedSets:mutate
Creates, updates, or removes shared sets.

REST Resource: v7.customers.topicViews

Methods
get GET /v7/{resourceName=customers/*/topicViews/*}
Returns the requested topic view in full detail.

REST Resource: v7.customers.userInterests

Methods
get GET /v7/{resourceName=customers/*/userInterests/*}

Returns the requested user interest in full detail

List of thrown errors: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

REST Resource: v7.customers.userLists

Methods
get GET /v7/{resourceName=customers/*/userLists/*}
Returns the requested user list.
mutate POST /v7/customers/{customerId}/userLists:mutate
Creates or updates user lists.

REST Resource: v7.customers.userLocationViews

Methods
get GET /v7/{resourceName=customers/*/userLocationViews/*}
Returns the requested user location view in full detail.

REST Resource: v7.customers.videos

Methods
get GET /v7/{resourceName=customers/*/videos/*}
Returns the requested video in full detail.

REST Resource: v7.customers.webpageViews

Methods
get GET /v7/{resourceName=customers/*/webpageViews/*}
Returns the requested webpage view in full detail.

REST Resource: v7.geoTargetConstants

Methods
get GET /v7/{resourceName=geoTargetConstants/*}
Returns the requested geo target constant in full detail.
suggest POST /v7/geoTargetConstants:suggest
Returns GeoTargetConstant suggestions by location name or by resource name.

REST Resource: v7.googleAdsFields

Methods
get GET /v7/{resourceName=googleAdsFields/*}
Returns just the requested field.
search POST /v7/googleAdsFields:search
Returns all fields that match the search query.

REST Resource: v7.languageConstants

Methods
get GET /v7/{resourceName=languageConstants/*}
Returns the requested language constant.

REST Resource: v7.mobileAppCategoryConstants

Methods
get GET /v7/{resourceName=mobileAppCategoryConstants/*}
Returns the requested mobile app category constant.

REST Resource: v7.mobileDeviceConstants

Methods
get GET /v7/{resourceName=mobileDeviceConstants/*}
Returns the requested mobile device constant in full detail.

REST Resource: v7.operatingSystemVersionConstants

Methods
get GET /v7/{resourceName=operatingSystemVersionConstants/*}
Returns the requested OS version constant in full detail.

REST Resource: v7.productBiddingCategoryConstants

Methods
get GET /v7/{resourceName=productBiddingCategoryConstants/*}
Returns the requested Product Bidding Category in full detail.

REST Resource: v7.topicConstants

Methods
get GET /v7/{resourceName=topicConstants/*}
Returns the requested topic constant in full detail.