Google

Search Ads 360 Reporting API

The Search Ads 360 API allows developers to automate downloading reports from Search Ads 360.

E-commerce#openapi#analytics#media

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

The Search Ads 360 API allows developers to automate downloading reports from Search Ads 360.

Endpoints 158

audienceInsights

  • POSTLists date ranges for which audience insights data can be requested/v23/audienceInsights:listInsightsEligibleDatesLists date ranges for which audience insights data can be requested. List of thrown errors: AuthenticationError AuthorizationError FieldError HeaderError…

customers

  • POSTCreates a new client under manager/v23/customers/:customerId:createCustomerClientCreates a new client under manager. The new client customer is returned. List of thrown errors: AccessInvitationError AuthenticationError AuthorizationError…
  • POSTReturns a list of suggested AdGroups and suggested modifications (text, match type) for the given keywords/v23/customers/:customerId:generateAdGroupThemesReturns a list of suggested AdGroups and suggested modifications (text, match type) for the given keywords. List of thrown errors: AuthenticationError…
  • POSTReturns a collection of attributes that are represented in an audience of interest, with metrics that compare each…/v23/customers/:customerId:generateAudienceCompositionInsightsReturns a collection of attributes that are represented in an audience of interest, with metrics that compare each attribute's share of the audience with its…
  • POSTReturns a collection of audience attributes using generative AI based on the provided audience description/v23/customers/:customerId:generateAudienceDefinitionReturns a collection of audience attributes using generative AI based on the provided audience description. List of thrown errors: AudienceInsightsError…
  • POSTReturns a collection of audience attributes along with estimates of the overlap between their potential YouTube reach…/v23/customers/:customerId:generateAudienceOverlapInsightsReturns a collection of audience attributes along with estimates of the overlap between their potential YouTube reach and that of a given input attribute.…
  • POSTReturns YouTube advertisement metrics for the given client against industry benchmarks/v23/customers/:customerId:generateBenchmarksMetricsReturns YouTube advertisement metrics for the given client against industry benchmarks. List of thrown errors: AuthenticationError AuthorizationError…
  • POSTCreates a saved report that can be viewed in the Insights Finder tool/v23/customers/:customerId:generateInsightsFinderReportCreates a saved report that can be viewed in the Insights Finder tool. List of thrown errors: AuthenticationError AuthorizationError FieldError HeaderError…
  • POSTReturns metrics (such as impressions, clicks, total cost) of a keyword forecast for the given campaign/v23/customers/:customerId:generateKeywordForecastMetricsReturns metrics (such as impressions, clicks, total cost) of a keyword forecast for the given campaign. List of thrown errors: AuthenticationError…
  • POSTReturns a list of keyword historical metrics/v23/customers/:customerId:generateKeywordHistoricalMetricsReturns a list of keyword historical metrics. List of thrown errors: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError…
  • POSTReturns a list of keyword ideas/v23/customers/:customerId:generateKeywordIdeasReturns a list of keyword ideas. List of thrown errors: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError…
  • POSTGenerates a reach forecast for a given targeting / product mix/v23/customers/:customerId:generateReachForecastGenerates a reach forecast for a given targeting / product mix. List of thrown errors: AuthenticationError AuthorizationError FieldError HeaderError…
  • POSTReturns a collection of targeting insights (e.g/v23/customers/:customerId:generateSuggestedTargetingInsightsReturns a collection of targeting insights (e.g. targetable audiences) that are relevant to the requested audience. List of thrown errors:…
  • POSTReturns potential reach metrics for targetable audiences/v23/customers/:customerId:generateTargetingSuggestionMetricsReturns potential reach metrics for targetable audiences. This method helps answer questions like "How many Men aged 18+ interested in Camping can be reached…
  • GETReturns Identity Verification information/v23/customers/:customerId/getIdentityVerificationReturns Identity Verification information. List of thrown errors: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError
  • GETReturns resource names of customers directly accessible by the user authenticating the call/v23/customers:listAccessibleCustomersReturns resource names of customers directly accessible by the user authenticating the call. List of thrown errors: AuthenticationError AuthorizationError…
  • POSTUpdates a customer/v23/customers/:customerId:mutateUpdates a customer. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError DatabaseError FieldMaskError HeaderError…
  • POSTRemoves automatically created assets from a campaign/v23/customers/:customerId:removeCampaignAutomaticallyCreatedAssetRemoves automatically created assets from a campaign. List of thrown errors: AuthenticationError AuthorizationError ContextError FieldError InternalError…
  • POSTSearches for audience attributes that can be used to generate insights/v23/customers/:customerId:searchAudienceInsightsAttributesSearches for audience attributes that can be used to generate insights. List of thrown errors: AuthenticationError AuthorizationError FieldError HeaderError…
  • POSTStarts Identity Verification for a given verification program type/v23/customers/:customerId:startIdentityVerificationStarts Identity Verification for a given verification program type. Statuses are returned. List of thrown errors: AuthenticationError AuthorizationError…
  • POSTSuggests keyword themes to advertise on./v23/customers/:customerId:suggestKeywordThemesSuggests keyword themes to advertise on.
  • POSTSuggests a Smart campaign ad compatible with the Ad family of resources, based on data points such as targeting and…/v23/customers/:customerId:suggestSmartCampaignAdSuggests a Smart campaign ad compatible with the Ad family of resources, based on data points such as targeting and the business to advertise.
  • POSTReturns BudgetOption suggestions./v23/customers/:customerId:suggestSmartCampaignBudgetOptionsReturns BudgetOption suggestions.
  • POSTReturns Travel Asset suggestions/v23/customers/:customerId:suggestTravelAssetsReturns Travel Asset suggestions. Asset suggestions are returned on a best-effort basis. There are no guarantees that all possible asset types will be…
  • POSTProcesses the given call conversions/v23/customers/:customerId:uploadCallConversionsProcesses the given call conversions. List of thrown errors: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError…
  • POSTProcesses the given click conversions/v23/customers/:customerId:uploadClickConversionsProcesses the given click conversions. List of thrown errors: AuthenticationError AuthorizationError ConversionUploadError HeaderError InternalError…
  • POSTProcesses the given conversion adjustments/v23/customers/:customerId:uploadConversionAdjustmentsProcesses the given conversion adjustments. List of thrown errors: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError…
  • POSTUploads the given user data/v23/customers/:customerId:uploadUserDataUploads the given user data. List of thrown errors: AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError InternalError…

customers.AdGroupCriterionCustomizers

  • POSTCreates, updates or removes ad group criterion customizers/v23/customers/:customerId/AdGroupCriterionCustomizers:mutateCreates, updates or removes ad group criterion customizers. Operation statuses are returned.

customers.CampaignGoalConfigs

  • POSTCreate or update campaign goal configs/v23/customers/:customerId/CampaignGoalConfigs:mutateCreate or update campaign goal configs. List of thrown errors: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError…

customers.CustomerCustomizers

  • POSTCreates, updates or removes customer customizers/v23/customers/:customerId/CustomerCustomizers:mutateCreates, updates or removes customer customizers. Operation statuses are returned.

customers.Goals

  • POSTCreate or update goals/v23/customers/:customerId/Goals:mutateCreate or update goals. List of thrown errors: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError GoalError…

customers.accountBudgetProposals

  • POSTCreates, updates, or removes account budget proposals/v23/customers/:customerId/accountBudgetProposals:mutateCreates, updates, or removes account budget proposals. Operation statuses are returned. List of thrown errors: AccountBudgetProposalError AuthenticationError…

customers.accountLinks

  • POSTCreates an account link/v23/customers/:customerId/accountLinks:createCreates an account link. List of thrown errors: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError MutateError…
  • POSTCreates or removes an account link/v23/customers/:customerId/accountLinks:mutateCreates or removes an account link. From V5, create is not supported through AccountLinkService.MutateAccountLink. Use AccountLinkService.CreateAccountLink…

customers.adGroupAdLabels

  • POSTCreates and removes ad group ad labels/v23/customers/:customerId/adGroupAdLabels:mutateCreates and removes ad group ad labels. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError DatabaseError…

customers.adGroupAds

  • POSTCreates, updates, or removes ads/v23/customers/:customerId/adGroupAds:mutateCreates, updates, or removes ads. Operation statuses are returned. List of thrown errors: AdCustomizerError AdError AdGroupAdError AdSharingError AdxError…
  • POSTRemove automatically created assets from an ad/v23/:adGroupAd:removeAutomaticallyCreatedAssetsRemove automatically created assets from an ad. List of thrown errors: AdError AuthenticationError AuthorizationError AutomaticallyCreatedAssetRemovalError…

customers.adGroupAssetSets

  • POSTCreates, or removes ad group asset sets/v23/customers/:customerId/adGroupAssetSets:mutateCreates, or removes ad group asset sets. Operation statuses are returned.

customers.adGroupAssets

  • POSTCreates, updates, or removes ad group assets/v23/customers/:customerId/adGroupAssets:mutateCreates, updates, or removes ad group assets. Operation statuses are returned. List of thrown errors: AssetLinkError AuthenticationError AuthorizationError…

customers.adGroupBidModifiers

  • POSTCreates, updates, or removes ad group bid modifiers/v23/customers/:customerId/adGroupBidModifiers:mutateCreates, updates, or removes ad group bid modifiers. Operation statuses are returned. List of thrown errors: AdGroupBidModifierError AuthenticationError…

customers.adGroupCriteria

  • POSTCreates, updates, or removes criteria/v23/customers/:customerId/adGroupCriteria:mutateCreates, updates, or removes criteria. Operation statuses are returned. List of thrown errors: AdGroupCriterionError AdxError AuthenticationError…

customers.adGroupCriterionLabels

  • POSTCreates and removes ad group criterion labels/v23/customers/:customerId/adGroupCriterionLabels:mutateCreates and removes ad group criterion labels. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError DatabaseError…

customers.adGroupCustomizers

  • POSTCreates, updates or removes ad group customizers/v23/customers/:customerId/adGroupCustomizers:mutateCreates, updates or removes ad group customizers. Operation statuses are returned.

customers.adGroupLabels

  • POSTCreates and removes ad group labels/v23/customers/:customerId/adGroupLabels:mutateCreates and removes ad group labels. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError DatabaseError FieldError…

customers.adGroups

  • POSTCreates, updates, or removes ad groups/v23/customers/:customerId/adGroups:mutateCreates, updates, or removes ad groups. Operation statuses are returned. List of thrown errors: AdGroupError AdxError AuthenticationError AuthorizationError…

customers.adParameters

  • POSTCreates, updates, or removes ad parameters/v23/customers/:customerId/adParameters:mutateCreates, updates, or removes ad parameters. Operation statuses are returned. List of thrown errors: AdParameterError AuthenticationError AuthorizationError…

customers.ads

  • POSTUpdates ads/v23/customers/:customerId/ads:mutateUpdates ads. Operation statuses are returned. Updating ads is not supported for TextAd, ExpandedDynamicSearchAd, GmailAd and ImageAd. List of thrown errors:…

customers.assetGroupAssets

  • POSTCreates, updates or removes asset group assets/v23/customers/:customerId/assetGroupAssets:mutateCreates, updates or removes asset group assets. Operation statuses are returned.

customers.assetGroupListingGroupFilters

  • POSTCreates, updates or removes asset group listing group filters/v23/customers/:customerId/assetGroupListingGroupFilters:mutateCreates, updates or removes asset group listing group filters. Operation statuses are returned.

customers.assetGroupSignals

  • POSTCreates or removes asset group signals/v23/customers/:customerId/assetGroupSignals:mutateCreates or removes asset group signals. Operation statuses are returned.

customers.assetGroups

  • POSTCreates, updates or removes asset groups/v23/customers/:customerId/assetGroups:mutateCreates, updates or removes asset groups. Operation statuses are returned.

customers.assetSetAssets

  • POSTCreates, updates or removes asset set assets/v23/customers/:customerId/assetSetAssets:mutateCreates, updates or removes asset set assets. Operation statuses are returned.

customers.assetSets

  • POSTCreates, updates or removes asset sets/v23/customers/:customerId/assetSets:mutateCreates, updates or removes asset sets. Operation statuses are returned.

customers.assets

  • POSTCreates assets/v23/customers/:customerId/assets:mutateCreates assets. Operation statuses are returned. List of thrown errors: AssetError AuthenticationError AuthorizationError CollectionSizeError…

customers.audiences

  • POSTCreates audiences/v23/customers/:customerId/audiences:mutateCreates audiences. Operation statuses are returned. List of thrown errors: AudienceError

customers.offlineUserDataJobs

  • POSTAdds operations to the offline user data job/v23/:resourceName:addOperationsAdds operations to the offline user data job. List of thrown errors: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError…
  • POSTRuns the offline user data job/v23/:resourceName:runRuns the offline user data job. When finished, the long running operation will contain the processing result or failure information, if any. List of thrown…
  • POSTCreates an offline user data job/v23/customers/:customerId/offlineUserDataJobs:createCreates an offline user data job. List of thrown errors: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError…

customers.batchJobs

  • GETReturns the results of the batch job/v23/:resourceName:listResults?pageSize=0&pageToken=string&responseContentType=UNSPECIFIEDReturns the results of the batch job. The job must be done. Supports standard list paging. List of thrown errors: AuthenticationError AuthorizationError…
  • POSTMutates a batch job/v23/customers/:customerId/batchJobs:mutateMutates a batch job. List of thrown errors: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError…

customers.biddingDataExclusions

  • POSTCreates, updates, or removes data exclusions/v23/customers/:customerId/biddingDataExclusions:mutateCreates, updates, or removes data exclusions. Operation statuses are returned.

customers.biddingSeasonalityAdjustments

  • POSTCreates, updates, or removes seasonality adjustments/v23/customers/:customerId/biddingSeasonalityAdjustments:mutateCreates, updates, or removes seasonality adjustments. Operation statuses are returned.

customers.biddingStrategies

  • POSTCreates, updates, or removes bidding strategies/v23/customers/:customerId/biddingStrategies:mutateCreates, updates, or removes bidding strategies. Operation statuses are returned. List of thrown errors: AdxError AuthenticationError AuthorizationError…

customers.billingSetups

  • POSTCreates a billing setup, or cancels an existing billing setup/v23/customers/:customerId/billingSetups:mutateCreates a billing setup, or cancels an existing billing setup. List of thrown errors: AuthenticationError AuthorizationError BillingSetupError DateError…

customers.campaignAssetSets

  • POSTCreates, updates or removes campaign asset sets/v23/customers/:customerId/campaignAssetSets:mutateCreates, updates or removes campaign asset sets. Operation statuses are returned.

customers.campaignAssets

  • POSTCreates or removes campaign assets/v23/customers/:customerId/campaignAssets:mutateCreates or removes campaign assets. Operation statuses are returned. List of thrown errors: AssetLinkError AuthenticationError AuthorizationError ContextError…

customers.campaignBidModifiers

  • POSTCreates, updates, or removes campaign bid modifiers/v23/customers/:customerId/campaignBidModifiers:mutateCreates, updates, or removes campaign bid modifiers. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError…

customers.campaignBudgets

  • POSTCreates, updates, or removes campaign budgets/v23/customers/:customerId/campaignBudgets:mutateCreates, updates, or removes campaign budgets. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError…

customers.campaignConversionGoals

  • POSTCreates, updates or removes campaign conversion goals/v23/customers/:customerId/campaignConversionGoals:mutateCreates, updates or removes campaign conversion goals. Operation statuses are returned.

customers.campaignCriteria

  • POSTCreates, updates, or removes criteria/v23/customers/:customerId/campaignCriteria:mutateCreates, updates, or removes criteria. Operation statuses are returned. List of thrown errors: AdxError AuthenticationError AuthorizationError…

customers.campaignCustomizers

  • POSTCreates, updates or removes campaign customizers/v23/customers/:customerId/campaignCustomizers:mutateCreates, updates or removes campaign customizers. Operation statuses are returned.

customers.campaignDrafts

  • GETReturns all errors that occurred during CampaignDraft promote/v23/:resourceName:listAsyncErrors?pageSize=0&pageToken=stringReturns all errors that occurred during CampaignDraft promote. Throws an error if called before campaign draft is promoted. Supports standard list paging.…
  • POSTCreates, updates, or removes campaign drafts/v23/customers/:customerId/campaignDrafts:mutateCreates, updates, or removes campaign drafts. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError…
  • POSTPromotes the changes in a draft back to the base campaign/v23/:campaignDraft:promotePromotes the changes in a draft back to the base campaign. This method returns a Long Running Operation (LRO) indicating if the Promote is done. Use…

customers.campaignGroups

  • POSTCreates, updates, or removes campaign groups/v23/customers/:customerId/campaignGroups:mutateCreates, updates, or removes campaign groups. Operation statuses are returned.

customers.campaignLabels

  • POSTCreates and removes campaign-label relationships/v23/customers/:customerId/campaignLabels:mutateCreates and removes campaign-label relationships. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError DatabaseError…

customers.campaignLifecycleGoal

  • POSTProcess the given campaign lifecycle configurations/v23/customers/:customerId/campaignLifecycleGoal:configureCampaignLifecycleGoalsProcess the given campaign lifecycle configurations. List of thrown errors: AuthenticationError AuthorizationError CampaignLifecycleGoalConfigError…

customers.campaignSharedSets

  • POSTCreates or removes campaign shared sets/v23/customers/:customerId/campaignSharedSets:mutateCreates or removes campaign shared sets. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError CampaignSharedSetError…

customers.campaigns

  • POSTEnables Brand Guidelines for Performance Max campaigns/v23/customers/:customerId/campaigns:enablePMaxBrandGuidelinesEnables Brand Guidelines for Performance Max campaigns. List of thrown errors: AuthenticationError AssetError AssetLinkError AuthorizationError…
  • POSTCreates, updates, or removes campaigns/v23/customers/:customerId/campaigns:mutateCreates, updates, or removes campaigns. Operation statuses are returned. List of thrown errors: AdxError AuthenticationError AuthorizationError BiddingError…

customers.conversionActions

  • POSTCreates, updates or removes conversion actions/v23/customers/:customerId/conversionActions:mutateCreates, updates or removes conversion actions. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError…

customers.conversionCustomVariables

  • POSTCreates or updates conversion custom variables/v23/customers/:customerId/conversionCustomVariables:mutateCreates or updates conversion custom variables. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError…

customers.conversionGoalCampaignConfigs

  • POSTCreates, updates or removes conversion goal campaign config/v23/customers/:customerId/conversionGoalCampaignConfigs:mutateCreates, updates or removes conversion goal campaign config. Operation statuses are returned.

customers.conversionValueRuleSets

  • POSTCreates, updates or removes conversion value rule sets/v23/customers/:customerId/conversionValueRuleSets:mutateCreates, updates or removes conversion value rule sets. Operation statuses are returned.

customers.conversionValueRules

  • POSTCreates, updates, or removes conversion value rules/v23/customers/:customerId/conversionValueRules:mutateCreates, updates, or removes conversion value rules. Operation statuses are returned.

customers.customAudiences

  • POSTCreates or updates custom audiences/v23/customers/:customerId/customAudiences:mutateCreates or updates custom audiences. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError CustomAudienceError…

searchAds360Fields

  • GETReturns just the requested field/v23/:resourceNameReturns just the requested field. List of thrown errors: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError
  • POSTReturns all fields that match the search…/v23/searchAds360Fields:searchReturns all fields that match the search query. List of thrown errors: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError…

customers.customColumns

  • GETReturns all the custom columns associated with the customer in full detail./v23/customers/:customerId/customColumnsReturns all the custom columns associated with the customer in full detail.

customers.customConversionGoals

  • POSTCreates, updates or removes custom conversion goals/v23/customers/:customerId/customConversionGoals:mutateCreates, updates or removes custom conversion goals. Operation statuses are returned.

customers.customInterests

  • POSTCreates or updates custom interests/v23/customers/:customerId/customInterests:mutateCreates or updates custom interests. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError CriterionError…

customers.customerAssetSets

  • POSTCreates, or removes customer asset sets/v23/customers/:customerId/customerAssetSets:mutateCreates, or removes customer asset sets. Operation statuses are returned.

customers.customerAssets

  • POSTCreates, updates, or removes customer assets/v23/customers/:customerId/customerAssets:mutateCreates, updates, or removes customer assets. Operation statuses are returned. List of thrown errors: AssetLinkError AuthenticationError AuthorizationError…

customers.customerClientLinks

  • POSTCreates or updates a customer client link/v23/customers/:customerId/customerClientLinks:mutateCreates or updates a customer client link. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError DatabaseError…

customers.customerConversionGoals

  • POSTCreates, updates or removes customer conversion goals/v23/customers/:customerId/customerConversionGoals:mutateCreates, updates or removes customer conversion goals. Operation statuses are returned.

customers.customerLabels

  • POSTCreates and removes customer-label relationships/v23/customers/:customerId/customerLabels:mutateCreates and removes customer-label relationships. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError DatabaseError…

customers.customerLifecycleGoal

  • POSTProcess the given customer lifecycle configurations/v23/customers/:customerId/customerLifecycleGoal:configureCustomerLifecycleGoalsProcess the given customer lifecycle configurations. List of thrown errors: AuthenticationError AuthorizationError CustomerLifecycleGoalConfigError…

customers.customerManagerLinks

  • POSTMoves a client customer to a new manager customer/v23/customers/:customerId/customerManagerLinks:moveManagerLinkMoves a client customer to a new manager customer. This simplifies the complex request that requires two operations to move a client customer to a new…
  • POSTUpdates customer manager links/v23/customers/:customerId/customerManagerLinks:mutateUpdates customer manager links. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError DatabaseError FieldError…

customers.customerNegativeCriteria

  • POSTCreates or removes criteria/v23/customers/:customerId/customerNegativeCriteria:mutateCreates or removes criteria. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError CriterionError DatabaseError…

customers.customerSkAdNetworkConversionValueSchemas

  • POSTCreates or updates the CustomerSkAdNetworkConversionValueSchema/v23/customers/:customerId/customerSkAdNetworkConversionValueSchemas:mutateCreates or updates the CustomerSkAdNetworkConversionValueSchema. List of thrown errors: AuthenticationError AuthorizationError FieldError InternalError…

customers.customerUserAccessInvitations

  • POSTCreates or removes an access invitation/v23/customers/:customerId/customerUserAccessInvitations:mutateCreates or removes an access invitation. List of thrown errors: AccessInvitationError AuthenticationError AuthorizationError HeaderError InternalError…

customers.customerUserAccesses

  • POSTUpdates, removes permission of a user on a given customer/v23/customers/:customerId/customerUserAccesses:mutateUpdates, removes permission of a user on a given customer. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError…

customers.customizerAttributes

  • POSTCreates, updates or removes customizer attributes/v23/customers/:customerId/customizerAttributes:mutateCreates, updates or removes customizer attributes. Operation statuses are returned.

customers.dataLinks

  • POSTCreates a data link/v23/customers/:customerId/dataLinks:createCreates a data link. The requesting Google Ads account name and account ID will be shared with the third party (such as YouTube creators for video links) to…
  • POSTRemove a data link/v23/customers/:customerId/dataLinks:removeRemove a data link. List of thrown errors: AuthenticationError AuthorizationError DatabaseError DataLinkError FieldError HeaderError InternalError MutateError…
  • POSTUpdate a data link/v23/customers/:customerId/dataLinks:updateUpdate a data link. List of thrown errors: AuthenticationError AuthorizationError DatabaseError DataLinkError FieldError HeaderError InternalError MutateError…

customers.experimentArms

  • POSTCreates, updates, or removes experiment arms/v23/customers/:customerId/experimentArms:mutateCreates, updates, or removes experiment arms. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError…

customers.experiments

  • POSTImmediately ends an experiment, changing the experiment's scheduled end date and without waiting for end of day/v23/:experiment:endExperimentImmediately ends an experiment, changing the experiment's scheduled end date and without waiting for end of day. End date is updated to be the time of the…
  • POSTGraduates an experiment to a full campaign/v23/:experiment:graduateExperimentGraduates an experiment to a full campaign. List of thrown errors: AuthenticationError AuthorizationError ExperimentError HeaderError InternalError…
  • GETReturns all errors that occurred during the last Experiment update (either scheduling or promotion)/v23/:resourceName:listExperimentAsyncErrors?pageSize=0&pageToken=stringReturns all errors that occurred during the last Experiment update (either scheduling or promotion). Supports standard list paging. List of thrown errors:…
  • POSTCreates, updates, or removes experiments/v23/customers/:customerId/experiments:mutateCreates, updates, or removes experiments. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError ExperimentError…
  • POSTPromotes the trial campaign thus applying changes in the trial campaign to the base campaign/v23/:resourceName:promoteExperimentPromotes the trial campaign thus applying changes in the trial campaign to the base campaign. This method returns a long running operation that tracks the…
  • POSTSchedule an experiment/v23/:resourceName:scheduleExperimentSchedule an experiment. The in design campaign will be converted into a real campaign (called the experiment campaign) that will begin serving ads if…

customers.incentives

  • POSTApplies the incentive for the ads customer./v23/customers/:customerId/incentives/:selectedIncentiveId:applyIncentiveApplies the incentive for the ads customer.

customers.invoices

  • GETReturns all invoices associated with a billing setup, for a given month/v23/customers/:customerId/invoices?billingSetup=string&includeGranularLevelInvoiceDetails=true&issueMonth=UNSPECIFIED&issueYear=stringReturns all invoices associated with a billing setup, for a given month. List of thrown errors: AuthenticationError AuthorizationError FieldError HeaderError…

customers.keywordPlanAdGroupKeywords

  • POSTCreates, updates, or removes Keyword Plan ad group keywords/v23/customers/:customerId/keywordPlanAdGroupKeywords:mutateCreates, updates, or removes Keyword Plan ad group keywords. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError…

customers.keywordPlanAdGroups

  • POSTCreates, updates, or removes Keyword Plan ad groups/v23/customers/:customerId/keywordPlanAdGroups:mutateCreates, updates, or removes Keyword Plan ad groups. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError…

customers.keywordPlanCampaignKeywords

  • POSTCreates, updates, or removes Keyword Plan campaign keywords/v23/customers/:customerId/keywordPlanCampaignKeywords:mutateCreates, updates, or removes Keyword Plan campaign keywords. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError…

customers.keywordPlanCampaigns

  • POSTCreates, updates, or removes Keyword Plan campaigns/v23/customers/:customerId/keywordPlanCampaigns:mutateCreates, updates, or removes Keyword Plan campaigns. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError…

customers.keywordPlans

  • POSTCreates, updates, or removes keyword plans/v23/customers/:customerId/keywordPlans:mutateCreates, updates, or removes keyword plans. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError DatabaseError…

customers.labels

  • POSTCreates, updates, or removes labels/v23/customers/:customerId/labels:mutateCreates, updates, or removes labels. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError DatabaseError DateError…

customers.localServices

  • POSTRPC to append Local Services Lead Conversation resources to Local Services Lead resources./v23/customers/:customerId/localServices:appendLeadConversationRPC to append Local Services Lead Conversation resources to Local Services Lead resources.

customers.localServicesLeads

  • POSTRPC to provide feedback on Local Services Lead resources./v23/:resourceName:provideLeadFeedbackRPC to provide feedback on Local Services Lead resources.

customers.paymentsAccounts

  • GETReturns all payments accounts associated with all managers between the login customer ID and specified serving…/v23/customers/:customerId/paymentsAccountsReturns all payments accounts associated with all managers between the login customer ID and specified serving customer in the hierarchy, inclusive. List of…

customers.productLinkInvitations

  • POSTCreates a product link invitation./v23/customers/:customerId/productLinkInvitations:createCreates a product link invitation.
  • POSTRemove a product link invitation./v23/customers/:customerId/productLinkInvitations:removeRemove a product link invitation.
  • POSTUpdate a product link invitation./v23/customers/:customerId/productLinkInvitations:updateUpdate a product link invitation.

customers.productLinks

  • POSTCreates a product link/v23/customers/:customerId/productLinks:createCreates a product link. List of thrown errors: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError MutateError…
  • POSTRemoves a product link/v23/customers/:customerId/productLinks:removeRemoves a product link. List of thrown errors: AuthenticationError AuthorizationError FieldMaskError HeaderError InternalError MutateError QuotaError…

customers.recommendationSubscriptions

  • POSTMutates given subscription with corresponding apply parameters/v23/customers/:customerId/recommendationSubscriptions:mutateRecommendationSubscriptionMutates given subscription with corresponding apply parameters. List of thrown errors: AuthenticationError AuthorizationError DatabaseError FieldError…

customers.recommendations

  • POSTApplies given recommendations with corresponding apply parameters/v23/customers/:customerId/recommendations:applyApplies given recommendations with corresponding apply parameters. List of thrown errors: AuthenticationError AuthorizationError DatabaseError FieldError…
  • POSTDismisses given recommendations/v23/customers/:customerId/recommendations:dismissDismisses given recommendations. List of thrown errors: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RecommendationError…
  • POSTGenerates Recommendations based off the requested recommendation_types/v23/customers/:customerId/recommendations:generateGenerates Recommendations based off the requested recommendation_types. List of thrown errors: AuthenticationError AuthorizationError HeaderError…

customers.remarketingActions

  • POSTCreates or updates remarketing actions/v23/customers/:customerId/remarketingActions:mutateCreates or updates remarketing actions. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError ConversionActionError…

customers.searchAds360

  • POSTThis method is essentially a wrapper around a series of mutate methods/v23/customers/:customerId/searchAds360:mutateThis method is essentially a wrapper around a series of mutate methods. The only features it offers over calling those methods directly are: - Atomic…
  • POSTReturns all rows that match the search query/v23/customers/:customerId/searchAds360:searchReturns all rows that match the search query. List of thrown errors: AuthenticationError AuthorizationError ChangeEventError ChangeStatusError ClickViewError…

customers.searchAds360Campaigns

  • POSTUpdates Search Ads 360 campaigns/v23/customers/:customerId/searchAds360Campaigns:mutateUpdates Search Ads 360 campaigns. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError HeaderError InternalError…

customers.sharedCriteria

  • POSTCreates or removes shared criteria/v23/customers/:customerId/sharedCriteria:mutateCreates or removes shared criteria. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError CriterionError…

customers.sharedSets

  • POSTCreates, updates, or removes shared sets/v23/customers/:customerId/sharedSets:mutateCreates, updates, or removes shared sets. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError DatabaseError…

customers.smartCampaignSettings

  • GETReturns the status of the requested Smart campaign./v23/:resourceName:getSmartCampaignStatusReturns the status of the requested Smart campaign.
  • POSTUpdates Smart campaign settings for campaigns./v23/customers/:customerId/smartCampaignSettings:mutateUpdates Smart campaign settings for campaigns.

customers.thirdPartyAppAnalyticsLinks

  • POSTRegenerate ThirdPartyAppAnalyticsLink.shareable_link_id that should be provided to the third party when setting up app…/v23/:resourceName:regenerateShareableLinkIdRegenerate ThirdPartyAppAnalyticsLink.shareable_link_id that should be provided to the third party when setting up app analytics. List of thrown errors:…

customers.userListCustomerTypes

  • POSTAttach or remove user list customer types/v23/customers/:customerId/userListCustomerTypes:mutateAttach or remove user list customer types. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError…

customers.userLists

  • POSTCreates or updates user lists/v23/customers/:customerId/userLists:mutateCreates or updates user lists. Operation statuses are returned. List of thrown errors: AuthenticationError AuthorizationError CollectionSizeError…

geoTargetConstants

  • POSTReturns GeoTargetConstant suggestions by location name or by resource name/v23/geoTargetConstants:suggestReturns GeoTargetConstant suggestions by location name or by resource name. List of thrown errors: AuthenticationError AuthorizationError…

incentives

  • GETReturns incentives for a given user./v23/incentives:fetchIncentive?countryCode=string&email=string&languageCode=string&type=UNSPECIFIEDReturns incentives for a given user.

keywordThemeConstants

  • POSTReturns KeywordThemeConstant suggestions by keyword themes/v23/keywordThemeConstants:suggestReturns KeywordThemeConstant suggestions by keyword themes. List of thrown errors: AuthenticationError AuthorizationError HeaderError InternalError QuotaError…

v23

  • POSTReturns a collection of conversion rate suggestions for supported plannable products/v23:generateConversionRatesReturns a collection of conversion rate suggestions for supported plannable products. List of thrown errors: AuthenticationError AuthorizationError…
  • POSTReturns a date range that supports benchmarks/v23:listBenchmarksAvailableDatesReturns a date range that supports benchmarks. List of thrown errors: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError…
  • POSTReturns the list of locations that support benchmarks (for example, countries)/v23:listBenchmarksLocationsReturns the list of locations that support benchmarks (for example, countries). List of thrown errors: AuthenticationError AuthorizationError FieldError…
  • POSTReturns the list of products that supports benchmarks/v23:listBenchmarksProductsReturns the list of products that supports benchmarks. List of thrown errors: AuthenticationError AuthorizationError FieldError HeaderError InternalError…
  • POSTReturns the list of benchmarks sources (for example, Industry Verticals)/v23:listBenchmarksSourcesReturns the list of benchmarks sources (for example, Industry Verticals). List of thrown errors: AuthenticationError AuthorizationError FieldError HeaderError…
  • POSTReturns the list of plannable locations (for example, countries)/v23:listPlannableLocationsReturns the list of plannable locations (for example, countries). List of thrown errors: AuthenticationError AuthorizationError HeaderError InternalError…
  • POSTReturns the list of per-location plannable YouTube ad formats with allowed targeting/v23:listPlannableProductsReturns the list of per-location plannable YouTube ad formats with allowed targeting. List of thrown errors: AuthenticationError AuthorizationError…
  • POSTReturns the list of plannable user interests/v23:listPlannableUserInterestsReturns the list of plannable user interests. A plannable user interest is one that can be targeted in a reach forecast using…
  • POSTReturns the list of plannable user lists with their plannable status/v23:listPlannableUserListsReturns the list of plannable user lists with their plannable status. User lists may not be plannable for a number of reasons, including: - They are less than…

API details

Base URL
https://searchads360.googleapis.com
Authentication
OAuth 2.0 (authorization code flow) with 1 scope
An API key in the key query parameter
Operations
158 operations on 158 pathsPOST 147GET 11
Main resources
customers 27v23 9customers.experiments 6customers.campaignDrafts 3customers.dataLinks 3customers.offlineUserDataJobs 3customers.productLinkInvitations 3customers.recommendations 3customers.accountLinks 2customers.adGroupAds 2
Response formats
application/json
Description format
Google API Discovery, API version v23

How to test the Search Ads 360 Reporting API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Search Ads 360 Reporting API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses OAuth 2.0 (authorization code flow) with 1 scope. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Lists date ranges for which audience insights data can be requested” (POST /v23/audienceInsights:listInsightsEligibleDates), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Search Ads 360 Reporting API?

The Search Ads 360 API allows developers to automate downloading reports from Search Ads 360. It is listed under E-commerce and has 158 endpoints.

Who publishes the Search Ads 360 Reporting API?

It is listed from Google's public API description (an OpenAPI document), not published by Google on Swastik Codes. Anyone who controls googleapis.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Search Ads 360 Reporting API?

Requests go to https://searchads360.googleapis.com. Endpoint paths are added to this base URL.

How do I authenticate with the Search Ads 360 Reporting API?

It accepts 2 methods: OAuth 2.0 (authorization code flow) with 1 scope; an API key in the key query parameter.

How many endpoints does the Search Ads 360 Reporting API have?

158 operations on 158 paths (147 POST, 11 GET). The largest groups are customers, v23, customers.experiments, customers.campaignDrafts.

Is forking the Search Ads 360 Reporting API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.