Package google.ads.googleads.v0.services

Index

AccountBudgetProposalService

A service for managing account-level budgets via proposals.

A proposal is a request to create a new budget or make changes to an existing one.

Reads for account-level budgets managed by these proposals will be supported in a future version. Please use BudgetOrderService until then: https://developers.google.com/adwords/api/docs/guides/budget-order

Mutates: The CREATE operation creates a new proposal. UPDATE operations aren't supported. The REMOVE operation cancels a pending proposal.

GetAccountBudgetProposal

rpc GetAccountBudgetProposal(GetAccountBudgetProposalRequest) returns (AccountBudgetProposal)

Returns an account-level budget proposal in full detail.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

MutateAccountBudgetProposal

rpc MutateAccountBudgetProposal(MutateAccountBudgetProposalRequest) returns (MutateAccountBudgetProposalResponse)

Creates, updates, or removes account budget proposals. Operation statuses are returned.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

AdGroupAdService

Service to manage ads in an ad group.

GetAdGroupAd

rpc GetAdGroupAd(GetAdGroupAdRequest) returns (AdGroupAd)

Returns the requested ad in full detail.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

MutateAdGroupAds

rpc MutateAdGroupAds(MutateAdGroupAdsRequest) returns (MutateAdGroupAdsResponse)

Creates, updates, or removes ads. Operation statuses are returned.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

AdGroupBidModifierService

Service to manage ad group bid modifiers.

GetAdGroupBidModifier

rpc GetAdGroupBidModifier(GetAdGroupBidModifierRequest) returns (AdGroupBidModifier)

Returns the requested ad group bid modifier in full detail.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

MutateAdGroupBidModifiers

rpc MutateAdGroupBidModifiers(MutateAdGroupBidModifiersRequest) returns (MutateAdGroupBidModifiersResponse)

Creates, updates, or removes ad group bid modifiers. Operation statuses are returned.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

AdGroupCriterionService

Service to manage ad group criteria.

GetAdGroupCriterion

rpc GetAdGroupCriterion(GetAdGroupCriterionRequest) returns (AdGroupCriterion)

Returns the requested criterion in full detail.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

MutateAdGroupCriteria

rpc MutateAdGroupCriteria(MutateAdGroupCriteriaRequest) returns (MutateAdGroupCriteriaResponse)

Creates, updates, or removes criteria. Operation statuses are returned.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

AdGroupService

Service to manage ad groups.

GetAdGroup

rpc GetAdGroup(GetAdGroupRequest) returns (AdGroup)

Returns the requested ad group in full detail.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

MutateAdGroups

rpc MutateAdGroups(MutateAdGroupsRequest) returns (MutateAdGroupsResponse)

Creates, updates, or removes ad groups. Operation statuses are returned.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

BiddingStrategyService

Service to manage bidding strategies.

GetBiddingStrategy

rpc GetBiddingStrategy(GetBiddingStrategyRequest) returns (BiddingStrategy)

Returns the requested bidding strategy in full detail.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

MutateBiddingStrategies

rpc MutateBiddingStrategies(MutateBiddingStrategiesRequest) returns (MutateBiddingStrategiesResponse)

Creates, updates, or removes bidding strategies. Operation statuses are returned.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

BillingSetupService

A service for designating the business entity responsible for accrued costs.

A billing setup is associated with a Payments account. Billing-related activity for all billing setups associated with a particular Payments account will appear on a single invoice generated monthly.

Mutates: The REMOVE operation cancels a pending billing setup. Functionality for creating new billing setups will be supported in a future version.

GetBillingSetup

rpc GetBillingSetup(GetBillingSetupRequest) returns (BillingSetup)

Returns a billing setup.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

MutateBillingSetup

rpc MutateBillingSetup(MutateBillingSetupRequest) returns (MutateBillingSetupResponse)

Cancels a pending billing setup.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

CampaignBidModifierService

Service to manage campaign bid modifiers.

GetCampaignBidModifier

rpc GetCampaignBidModifier(GetCampaignBidModifierRequest) returns (CampaignBidModifier)

Returns the requested campaign bid modifier in full detail.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

MutateCampaignBidModifiers

rpc MutateCampaignBidModifiers(MutateCampaignBidModifiersRequest) returns (MutateCampaignBidModifiersResponse)

Creates, updates, or removes campaign bid modifiers. Operation statuses are returned.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

CampaignBudgetService

Service to manage campaign budgets.

GetCampaignBudget

rpc GetCampaignBudget(GetCampaignBudgetRequest) returns (CampaignBudget)

Returns the requested Campaign Budget in full detail.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

MutateCampaignBudgets

rpc MutateCampaignBudgets(MutateCampaignBudgetsRequest) returns (MutateCampaignBudgetsResponse)

Creates, updates, or removes campaign budgets. Operation statuses are returned.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

CampaignCriterionService

Service to manage campaign criteria.

GetCampaignCriterion

rpc GetCampaignCriterion(GetCampaignCriterionRequest) returns (CampaignCriterion)

Returns the requested criterion in full detail.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

MutateCampaignCriteria

rpc MutateCampaignCriteria(MutateCampaignCriteriaRequest) returns (MutateCampaignCriteriaResponse)

Creates, updates, or removes criteria. Operation statuses are returned.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

CampaignGroupService

Service to manage campaign groups.

GetCampaignGroup

rpc GetCampaignGroup(GetCampaignGroupRequest) returns (CampaignGroup)

Returns the requested campaign group in full detail.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

MutateCampaignGroups

rpc MutateCampaignGroups(MutateCampaignGroupsRequest) returns (MutateCampaignGroupsResponse)

Creates, updates, or removes campaign groups. Operation statuses are returned.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

CampaignService

Service to manage campaigns.

GetCampaign

rpc GetCampaign(GetCampaignRequest) returns (Campaign)

Returns the requested campaign in full detail.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

MutateCampaigns

rpc MutateCampaigns(MutateCampaignsRequest) returns (MutateCampaignsResponse)

Creates, updates, or removes campaigns. Operation statuses are returned.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

CampaignSharedSetService

Service to manage campaign shared sets.

GetCampaignSharedSet

rpc GetCampaignSharedSet(GetCampaignSharedSetRequest) returns (CampaignSharedSet)

Returns the requested campaign shared set in full detail.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

MutateCampaignSharedSets

rpc MutateCampaignSharedSets(MutateCampaignSharedSetsRequest) returns (MutateCampaignSharedSetsResponse)

Creates or removes campaign shared sets. Operation statuses are returned.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

ChangeStatusService

Service to fetch change statuses.

GetChangeStatus

rpc GetChangeStatus(GetChangeStatusRequest) returns (ChangeStatus)

Returns the requested change status in full detail.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

ConversionActionService

Service to manage conversion actions.

GetConversionAction

rpc GetConversionAction(GetConversionActionRequest) returns (ConversionAction)

Returns the requested conversion action.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

MutateConversionActions

rpc MutateConversionActions(MutateConversionActionsRequest) returns (MutateConversionActionsResponse)

Creates, updates or removes conversion actions. Operation statuses are returned.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

CustomerService

Service to manage customers.

GetCustomer

rpc GetCustomer(GetCustomerRequest) returns (Customer)

Returns the requested customer in full detail.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

GeoTargetConstantService

Service to fetch geo target constants.

GetGeoTargetConstant

rpc GetGeoTargetConstant(GetGeoTargetConstantRequest) returns (GeoTargetConstant)

Returns the requested geo target constant in full detail.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

GoogleAdsFieldService

Service to fetch Google Ads API fields.

GetGoogleAdsField

rpc GetGoogleAdsField(GetGoogleAdsFieldRequest) returns (GoogleAdsField)

Returns just the requested field.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

SearchGoogleAdsFields

rpc SearchGoogleAdsFields(SearchGoogleAdsFieldsRequest) returns (SearchGoogleAdsFieldsResponse)

Returns all fields that match the search query.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

GoogleAdsService

Service to fetch data and metrics across resources.

Search

rpc Search(SearchGoogleAdsRequest) returns (SearchGoogleAdsResponse)

Returns all rows that match the search query.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

KeywordViewService

Service to manage keyword views.

GetKeywordView

rpc GetKeywordView(GetKeywordViewRequest) returns (KeywordView)

Returns the requested keyword view in full detail.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

RecommendationService

Service to manage recommendations.

ApplyRecommendation

rpc ApplyRecommendation(ApplyRecommendationRequest) returns (ApplyRecommendationResponse)

Applies given recommendations with corresponding apply parameters.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

GetRecommendation

rpc GetRecommendation(GetRecommendationRequest) returns (Recommendation)

Returns the requested recommendation in full detail.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

SharedCriterionService

Service to manage shared criteria.

GetSharedCriterion

rpc GetSharedCriterion(GetSharedCriterionRequest) returns (SharedCriterion)

Returns the requested shared criterion in full detail.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

MutateSharedCriteria

rpc MutateSharedCriteria(MutateSharedCriteriaRequest) returns (MutateSharedCriteriaResponse)

Creates or removes shared criteria. Operation statuses are returned.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

SharedSetService

Service to manage shared sets.

GetSharedSet

rpc GetSharedSet(GetSharedSetRequest) returns (SharedSet)

Returns the requested shared set in full detail.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

MutateSharedSets

rpc MutateSharedSets(MutateSharedSetsRequest) returns (MutateSharedSetsResponse)

Creates, updates, or removes shared sets. Operation statuses are returned.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

VideoService

Service to manage videos.

GetVideo

rpc GetVideo(GetVideoRequest) returns (Video)

Returns the requested video in full detail.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.

AccountBudgetProposalOperation

A single operation to propose the creation of a new account-level budget or edit/end/remove an existing one.

Fields
update_mask

FieldMask

FieldMask that determines which budget fields are modified. While budgets may be modified, proposals that propose such modifications are final. Therefore, update operations are not supported for proposals.

Proposals that modify budgets have the 'update' proposal type. Specifying a mask for any other proposal type is considered an error.

Union field operation. The mutate operation. operation can be only one of the following:
create

AccountBudgetProposal

Create operation: A new proposal to create a new budget, edit an existing budget, end an actively running budget, or remove an approved budget scheduled to start in the future. No resource name is expected for the new proposal.

remove

string

Remove operation: A resource name for the removed proposal is expected, in this format:

customers/{customer_id}/accountBudgetProposals/{account_budget_proposal_id} A request may be cancelled iff it is pending.

AdGroupAdOperation

A single operation (create, update, remove) on an ad group ad.

Fields
update_mask

FieldMask

FieldMask that determines which resource fields are modified in an update.

policy_validation_parameter

PolicyValidationParameter

Configuration for how policies are validated.

Union field operation. The mutate operation. operation can be only one of the following:
create

AdGroupAd

Create operation: No resource name is expected for the new ad.

update

AdGroupAd

Update operation: The ad is expected to have a valid resource name.

remove

string

Remove operation: A resource name for the removed ad is expected, in this format:

customers/{customer_id}/adGroupAds/{ad_group_id}_{ad_id}

AdGroupBidModifierOperation

A single operation (create, remove, update) on an ad group bid modifier.

Fields
update_mask

FieldMask

FieldMask that determines which resource fields are modified in an update.

Union field operation. The mutate operation. operation can be only one of the following:
create

AdGroupBidModifier

Create operation: No resource name is expected for the new ad group bid modifier.

update

AdGroupBidModifier

Update operation: The ad group bid modifier is expected to have a valid resource name.

remove

string

Remove operation: A resource name for the removed ad group bid modifier is expected, in this format:

customers/{customer_id}/adGroupBidModifiers/{ad_group_id}_{criterion_id}

AdGroupCriterionOperation

A single operation (create, remove, update) on an ad group criterion.

Fields
update_mask

FieldMask

FieldMask that determines which resource fields are modified in an update.

Union field operation. The mutate operation. operation can be only one of the following:
create

AdGroupCriterion

Create operation: No resource name is expected for the new criterion.

update

AdGroupCriterion

Update operation: The criterion is expected to have a valid resource name.

remove

string

Remove operation: A resource name for the removed criterion is expected, in this format:

customers/{customer_id}/adGroupCriteria/{ad_group_id}_{criterion_id}

AdGroupOperation

A single operation (create, update, remove) on an ad group.

Fields
update_mask

FieldMask

FieldMask that determines which resource fields are modified in an update.

Union field operation. The mutate operation. operation can be only one of the following:
create

AdGroup

Create operation: No resource name is expected for the new ad group.

update

AdGroup

Update operation: The ad group is expected to have a valid resource name.

remove

string

Remove operation: A resource name for the removed ad group is expected, in this format:

customers/{customer_id}/adGroups/{ad_group_id}

ApplyRecommendationOperation

Information about the operation to apply a recommendation and any parameters to customize it.

Fields
resource_name

string

The resource name of the recommendation to apply.

Union field apply_parameters. Parameters to use when applying the recommendation. apply_parameters can be only one of the following:
campaign_budget

CampaignBudgetParameters

Optional parameters to use when applying a campaign budget recommendation.

text_ad

TextAdParameters

Optional parameters to use when applying a text ad recommendation.

keyword

KeywordParameters

Optional parameters to use when applying keyword recommendation.

target_cpa_opt_in

TargetCpaOptInParameters

Optional parameters to use when applying target CPA opt-in recommendation.

CampaignBudgetParameters

Parameters to use when applying a campaign budget recommendation.

Fields
new_budget_amount_micros

Int64Value

New budget amount to set for target budget resource. This is a required field.

KeywordParameters

Parameters to use when applying keyword recommendation.

Fields
ad_group

StringValue

The ad group resource to add keyword to. This is a required field.

match_type

KeywordMatchType

The match type of the keyword. This is a required field.

cpc_bid_micros

Int64Value

Optional, CPC bid to set for the keyword. If not set, keyword will use bid based on bidding strategy used by target ad group.

TargetCpaOptInParameters

Parameters to use when applying Target CPA recommendation.

Fields
target_cpa_micros

Int64Value

Average CPA to use for Target CPA bidding strategy. This is a required field.

new_campaign_budget_amount_micros

Int64Value

Optional, budget amount to set for the campaign.

TextAdParameters

Parameters to use when applying a text ad recommendation.

Fields
ad

Ad

New ad to add to recommended ad group. All necessary fields need to be set in this message. This is a required field.

ApplyRecommendationRequest

Request message for RecommendationService.ApplyRecommendation.

Fields
customer_id

string

The ID of the customer with the recommendation.

operations[]

ApplyRecommendationOperation

The list of operations to apply recommendations.

ApplyRecommendationResponse

Response message for RecommendationService.ApplyRecommendation.

Fields
results[]

ApplyRecommendationResult

Results of operations to apply recommendations.

ApplyRecommendationResult

The result of applying a recommendation.

Fields
Union field result. One of the successfully applied recommendation resource name or error information will be set. result can be only one of the following:
resource_name

string

Returned for successful applies.

status

Status

Returned for failed operations.

BiddingStrategyOperation

A single operation (create, update, remove) on a bidding strategy.

Fields
update_mask

FieldMask

FieldMask that determines which resource fields are modified in an update.

Union field operation. The mutate operation. operation can be only one of the following:
create

BiddingStrategy

Create operation: No resource name is expected for the new bidding strategy.

update

BiddingStrategy

Update operation: The bidding strategy is expected to have a valid resource name.

remove

string

Remove operation: A resource name for the removed bidding strategy is expected, in this format:

customers/{customer_id}/biddingStrategies/{bidding_strategy_id}

BillingSetupOperation

A single operation on a billing setup, which describes the cancellation of an existing billing setup.

Fields
remove

string

Resource name of the billing setup to remove. A setup cannot be removed unless it is in a pending state or its scheduled start time is in the future. The resource name looks like “customers/{customer_id}/billingSetups/{billing_id}”.

CampaignBidModifierOperation

A single operation (create, remove, update) on a campaign bid modifier.

Fields
update_mask

FieldMask

FieldMask that determines which resource fields are modified in an update.

Union field operation. The mutate operation. operation can be only one of the following:
create

CampaignBidModifier

Create operation: No resource name is expected for the new campaign bid modifier.

update

CampaignBidModifier

Update operation: The campaign bid modifier is expected to have a valid resource name.

remove

string

Remove operation: A resource name for the removed campaign bid modifier is expected, in this format:

customers/{customer_id}/CampaignBidModifiers/{campaign_id}_{criterion_id}

CampaignBudgetOperation

A single operation (create, update, remove) on a campaign budget.

Fields
update_mask

FieldMask

FieldMask that determines which resource fields are modified in an update.

Union field operation. The mutate operation. operation can be only one of the following:
create

CampaignBudget

Create operation: No resource name is expected for the new budget.

update

CampaignBudget

Update operation: The campaign budget is expected to have a valid resource name.

remove

string

Remove operation: A resource name for the removed budget is expected, in this format:

customers/{customer_id}/campaignBudgets/{budget_id}

CampaignCriterionOperation

A single operation (create, update, remove) on a campaign criterion.

Fields
update_mask

FieldMask

FieldMask that determines which resource fields are modified in an update.

Union field operation. The mutate operation. operation can be only one of the following:
create

CampaignCriterion

Create operation: No resource name is expected for the new criterion.

update

CampaignCriterion

Update operation: The criterion is expected to have a valid resource name.

remove

string

Remove operation: A resource name for the removed criterion is expected, in this format:

customers/{customer_id}/campaignCriteria/{campaign_id}_{criterion_id}

CampaignGroupOperation

A single operation (create, update, remove) on a campaign group.

Fields
update_mask

FieldMask

FieldMask that determines which resource fields are modified in an update.

Union field operation. The mutate operation. operation can be only one of the following:
create

CampaignGroup

Create operation: No resource name is expected for the new campaign group.

update

CampaignGroup

Update operation: The campaign group is expected to have a valid resource name.

remove

string

Remove operation: A resource name for the removed campaign group is expected, in this format:

customers/{customer_id}/campaignGroups/{campaign_group_id}

CampaignOperation

A single operation (create, update, remove) on a campaign.

Fields
update_mask

FieldMask

FieldMask that determines which resource fields are modified in an update.

Union field operation. The mutate operation. operation can be only one of the following:
create

Campaign

Create operation: No resource name is expected for the new campaign.

update

Campaign

Update operation: The campaign is expected to have a valid resource name.

remove

string

Remove operation: A resource name for the removed campaign is expected, in this format:

customers/{customer_id}/campaigns/{campaign_id}

CampaignSharedSetOperation

A single operation (create, remove) on an campaign shared set.

Fields
Union field operation. The mutate operation. operation can be only one of the following:
create

CampaignSharedSet

Create operation: No resource name is expected for the new campaign shared set.

remove

string

Remove operation: A resource name for the removed campaign shared set is expected, in this format:

customers/{customer_id}/campaignSharedSets/{campaign_id}_{shared_set_id}

ConversionActionOperation

A single operation (create, update, remove) on a conversion action.

Fields
update_mask

FieldMask

FieldMask that determines which resource fields are modified in an update.

Union field operation. The mutate operation. operation can be only one of the following:
create

ConversionAction

Create operation: No resource name is expected for the new conversion action.

update

ConversionAction

Update operation: The conversion action is expected to have a valid resource name.

remove

string

Remove operation: A resource name for the removed conversion action is expected, in this format:

customers/{customer_id}/conversionActions/{conversion_action_id}

GetAccountBudgetProposalRequest

Request message for AccountBudgetProposalService.GetAccountBudgetProposal.

Fields
resource_name

string

The resource name of the account-level budget proposal to fetch.

GetAdGroupAdRequest

Request message for AdGroupAdService.GetAdGroupAd.

Fields
resource_name

string

The resource name of the ad to fetch.

GetAdGroupBidModifierRequest

Request message for AdGroupBidModifierService.GetAdGroupBidModifier.

Fields
resource_name

string

The resource name of the ad group bid modifier to fetch.

GetAdGroupCriterionRequest

Request message for AdGroupCriterionService.GetAdGroupCriterion.

Fields
resource_name

string

The resource name of the criterion to fetch.

GetAdGroupRequest

Request message for AdGroupService.GetAdGroup.

Fields
resource_name

string

The resource name of the ad group to fetch.

GetBiddingStrategyRequest

Request message for BiddingStrategyService.GetBiddingStrategy.

Fields
resource_name

string

The resource name of the bidding strategy to fetch.

GetBillingSetupRequest

Request message for BillingSetupService.GetBillingSetup.

Fields
resource_name

string

The resource name of the billing setup to fetch.

GetCampaignBidModifierRequest

Request message for CampaignBidModifierService.GetCampaignBidModifier.

Fields
resource_name

string

The resource name of the campaign bid modifier to fetch.

GetCampaignBudgetRequest

Request message for CampaignBudgetService.GetCampaignBudget.

Fields
resource_name

string

The resource name of the campaign budget to fetch.

GetCampaignCriterionRequest

Request message for CampaignCriterionService.GetCampaignCriterion.

Fields
resource_name

string

The resource name of the criterion to fetch.

GetCampaignGroupRequest

Request message for CampaignGroupService.GetCampaignGroup.

Fields
resource_name

string

The resource name of the campaign group to fetch.

GetCampaignRequest

Request message for CampaignService.GetCampaign.

Fields
resource_name

string

The resource name of the campaign to fetch.

GetCampaignSharedSetRequest

Request message for CampaignSharedSetService.GetCampaignSharedSet.

Fields
resource_name

string

The resource name of the campaign shared set to fetch.

GetChangeStatusRequest

Request message for 'ChangeStatusService.GetChangeStatus'.

Fields
resource_name

string

The resource name of the change status to fetch.

GetConversionActionRequest

Request message for [ConversionActionService.GetConversionAction].

Fields
resource_name

string

The resource name of the conversion action to fetch.

GetCustomerRequest

Request message for CustomerService.GetCustomer.

Fields
resource_name

string

The resource name of the customer to fetch.

GetGeoTargetConstantRequest

Request message for GeoTargetConstantService.GetGeoTargetConstant.

Fields
resource_name

string

The resource name of the geo target constant to fetch.

GetGoogleAdsFieldRequest

Request message for GoogleAdsFieldService.GetGoogleAdsField.

Fields
resource_name

string

The resource name of the field to get.

GetKeywordViewRequest

Request message for KeywordViewService.GetKeywordView.

Fields
resource_name

string

The resource name of the keyword view to fetch.

GetRecommendationRequest

Request message for RecommendationService.GetRecommendation.

Fields
resource_name

string

The resource name of the recommendation to fetch.

GetSharedCriterionRequest

Request message for SharedCriterionService.GetSharedCriterion.

Fields
resource_name

string

The resource name of the shared criterion to fetch.

GetSharedSetRequest

Request message for SharedSetService.GetSharedSet.

Fields
resource_name

string

The resource name of the shared set to fetch.

GetVideoRequest

Request message for VideoService.GetVideo.

Fields
resource_name

string

The resource name of the video to fetch.

GoogleAdsRow

A returned row from the query.

Fields
account_budget

AccountBudget

The account budget in the query.

account_budget_proposal

AccountBudgetProposal

The account budget proposal referenced in the query.

ad_group

AdGroup

The ad group referenced in the query.

ad_group_ad

AdGroupAd

The ad referenced in the query.

ad_group_bid_modifier

AdGroupBidModifier

The bid modifier referenced in the query.

ad_group_criterion

AdGroupCriterion

The criterion referenced in the query.

bidding_strategy

BiddingStrategy

The bidding strategy referenced in the query.

billing_setup

BillingSetup

The billing setup referenced in the query.

campaign_budget

CampaignBudget

The campaign budget referenced in the query.

campaign

Campaign

The campaign referenced in the query.

campaign_bid_modifier

CampaignBidModifier

The campaign bid modifier referenced in the query.

campaign_criterion

CampaignCriterion

The campaign criterion referenced in the query.

campaign_group

CampaignGroup

Campaign Group referenced in AWQL query.

campaign_shared_set

CampaignSharedSet

Campaign Shared Set referenced in AWQL query.

change_status

ChangeStatus

The ChangeStatus referenced in the query.

customer

Customer

The customer referenced in the query.

geo_target_constant

GeoTargetConstant

The geo target constant referenced in the query.

keyword_view

KeywordView

The keyword view referenced in the query.

recommendation

Recommendation

The recommendation referenced in the query.

shared_criterion

SharedCriterion

The shared set referenced in the query.

shared_set

SharedSet

The shared set referenced in the query.

video

Video

The video referenced in the query.

metrics

Metrics

The metrics.

ad_network_type

AdNetworkType

Ad network type.

date

StringValue

Date to which metrics apply. YYYY-MM-DD format, e.g., 2018-04-17.

day_of_week

DayOfWeek

Day of the week, e.g., MONDAY.

device

Device

Device to which metrics apply.

hour

Int32Value

Hour of day as a number between 0 and 23, inclusive.

month

StringValue

Month as represented by the date of the first day of a month.

month_of_year

MonthOfYear

Month of the year, e.g., January.

quarter

StringValue

Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, e.g., the second quarter of 2018 starts on 2018-04-01.

slot

Slot

Position of the ad.

week

StringValue

Week as defined as Monday through Sunday, and represented by the date of Monday.

year

Int32Value

Year, formatted as yyyy.

MutateAccountBudgetProposalRequest

Request message for AccountBudgetProposalService.MutateAccountBudgetProposal.

Fields
customer_id

string

The ID of the customer.

operation

AccountBudgetProposalOperation

The operation to perform on an individual account-level budget proposal.

MutateAccountBudgetProposalResponse

Response message for account-level budget mutate operations.

Fields
result

MutateAccountBudgetProposalResult

The result of the mutate.

MutateAccountBudgetProposalResult

The result for the account budget proposal mutate.

Fields
resource_name

string

Returned for successful operations.

MutateAdGroupAdResult

The result for the ad mutate.

Fields
resource_name

string

The resource name returned for successful operations.

MutateAdGroupAdsRequest

Request message for AdGroupAdService.MutateAdGroupAds.

Fields
customer_id

string

The ID of the customer whose ads are being modified.

operations[]

AdGroupAdOperation

The list of operations to perform on individual ads.

MutateAdGroupAdsResponse

Response message for an ad group ad mutate.

Fields
results[]

MutateAdGroupAdResult

All results for the mutate.

MutateAdGroupBidModifierResult

The result for the criterion mutate.

Fields
resource_name

string

Returned for successful operations.

MutateAdGroupBidModifiersRequest

Request message for AdGroupBidModifierService.MutateAdGroupBidModifiers.

Fields
customer_id

string

ID of the customer whose ad group bid modifiers are being modified.

operations[]

AdGroupBidModifierOperation

The list of operations to perform on individual ad group bid modifiers.

MutateAdGroupBidModifiersResponse

Response message for ad group bid modifiers mutate.

Fields
results[]

MutateAdGroupBidModifierResult

All results for the mutate.

MutateAdGroupCriteriaRequest

Request message for AdGroupCriterionService.MutateAdGroupCriteria.

Fields
customer_id

string

ID of the customer whose criteria are being modified.

operations[]

AdGroupCriterionOperation

The list of operations to perform on individual criteria.

MutateAdGroupCriteriaResponse

Response message for an ad group criterion mutate.

Fields
results[]

MutateAdGroupCriterionResult

All results for the mutate.

MutateAdGroupCriterionResult

The result for the criterion mutate.

Fields
resource_name

string

Returned for successful operations.

MutateAdGroupResult

The result for the ad group mutate.

Fields
resource_name

string

Returned for successful operations.

MutateAdGroupsRequest

Request message for AdGroupService.MutateAdGroups.

Fields
customer_id

string

The ID of the customer whose ad groups are being modified.

operations[]

AdGroupOperation

The list of operations to perform on individual ad groups.

MutateAdGroupsResponse

Response message for an ad group mutate.

Fields
results[]

MutateAdGroupResult

All results for the mutate.

MutateBiddingStrategiesRequest

Request message for BiddingStrategyService.MutateBiddingStrategies.

Fields
customer_id

string

The ID of the customer whose bidding strategies are being modified.

operations[]

BiddingStrategyOperation

The list of operations to perform on individual bidding strategies.

MutateBiddingStrategiesResponse

Response message for bidding strategy mutate.

Fields
results[]

MutateBiddingStrategyResult

All results for the mutate.

MutateBiddingStrategyResult

The result for the bidding strategy mutate.

Fields
resource_name

string

Returned for successful operations.

MutateBillingSetupRequest

Request message for billing setup mutate operations.

Fields
customer_id

string

Id of the customer to apply the billing setup mutate operation to.

operation

BillingSetupOperation

The operation to perform.

MutateBillingSetupResponse

Response message for a billing setup operation.

Fields
result

MutateBillingSetupResult

A result that identifies the resource affected by the mutate request.

MutateBillingSetupResult

Result for a single billing setup mutate.

Fields
resource_name

string

Returned for successful operations.

MutateCampaignBidModifierResult

The result for the criterion mutate.

Fields
resource_name

string

Returned for successful operations.

MutateCampaignBidModifiersRequest

Request message for [CampaignBidModifierService.MutateCampaignBidModifier][].

Fields
customer_id

string

ID of the customer whose campaign bid modifiers are being modified.

operations[]

CampaignBidModifierOperation

The list of operations to perform on individual campaign bid modifiers.

MutateCampaignBidModifiersResponse

Response message for campaign bid modifiers mutate.

Fields
results[]

MutateCampaignBidModifierResult

All results for the mutate.

MutateCampaignBudgetResult

The result for the campaign budget mutate.

Fields
resource_name

string

Returned for successful operations.

MutateCampaignBudgetsRequest

Request message for CampaignBudgetService.MutateCampaignBudgets.

Fields
customer_id

string

The ID of the customer whose campaign budgets are being modified.

operations[]

CampaignBudgetOperation

The list of operations to perform on individual campaign budgets.

MutateCampaignBudgetsResponse

Response message for campaign budget mutate.

Fields
results[]

MutateCampaignBudgetResult

All results for the mutate.

MutateCampaignCriteriaRequest

Request message for CampaignCriterionService.MutateCampaignCriteria.

Fields
customer_id

string

The ID of the customer whose criteria are being modified.

operations[]

CampaignCriterionOperation

The list of operations to perform on individual criteria.

MutateCampaignCriteriaResponse

Response message for campaign criterion mutate.

Fields
results[]

MutateCampaignCriterionResult

All results for the mutate.

MutateCampaignCriterionResult

The result for the criterion mutate.

Fields
resource_name

string

Returned for successful operations.

MutateCampaignGroupResult

The result for the campaign group mutate.

Fields
resource_name

string

Returned for successful operations.

MutateCampaignGroupsRequest

Request message for CampaignGroupService.MutateCampaignGroups.

Fields
customer_id

string

The ID of the customer whose campaign groups are being modified.

operations[]

CampaignGroupOperation

The list of operations to perform on individual campaign groups.

MutateCampaignGroupsResponse

Response message for campaign group mutate.

Fields
results[]

MutateCampaignGroupResult

All results for the mutate.

MutateCampaignResult

The result for the campaign mutate.

Fields
resource_name

string

Returned for successful operations.

MutateCampaignSharedSetResult

The result for the campaign shared set mutate.

Fields
resource_name

string

Returned for successful operations.

MutateCampaignSharedSetsRequest

Request message for CampaignSharedSetService.MutateCampaignSharedSets.

Fields
customer_id

string

The ID of the customer whose campaign shared sets are being modified.

operations[]

CampaignSharedSetOperation

The list of operations to perform on individual campaign shared sets.

MutateCampaignSharedSetsResponse

Response message for a campaign shared set mutate.

Fields
results[]

MutateCampaignSharedSetResult

All results for the mutate.

MutateCampaignsRequest

Request message for CampaignService.MutateCampaigns.

Fields
customer_id

string

The ID of the customer whose campaigns are being modified.

operations[]

CampaignOperation

The list of operations to perform on individual campaigns.

MutateCampaignsResponse

Response message for campaign mutate.

Fields
results[]

MutateCampaignResult

All results for the mutate.

MutateConversionActionResult

The result for the conversion action mutate.

Fields
resource_name

string

Returned for successful operations.

MutateConversionActionsRequest

Request message for [ConversionActionService.MutateConversionActions].

Fields
customer_id

string

The ID of the customer whose conversion actions are being modified.

operations[]

ConversionActionOperation

The list of operations to perform on individual conversion actions.

MutateConversionActionsResponse

Response message for conversion action mutate.

Fields
results[]

MutateConversionActionResult

All results for the mutate.

MutateSharedCriteriaRequest

Request message for SharedCriterionService.MutateSharedCriteria.

Fields
customer_id

string

The ID of the customer whose shared criteria are being modified.

operations[]

SharedCriterionOperation

The list of operations to perform on individual shared criteria.

MutateSharedCriteriaResponse

Response message for a shared criterion mutate.

Fields
results[]

MutateSharedCriterionResult

All results for the mutate.

MutateSharedCriterionResult

The result for the shared criterion mutate.

Fields
resource_name

string

Returned for successful operations.

MutateSharedSetResult

The result for the shared set mutate.

Fields
resource_name

string

Returned for successful operations.

MutateSharedSetsRequest

Request message for SharedSetService.MutateSharedSets.

Fields
customer_id

string

The ID of the customer whose shared sets are being modified.

operations[]

SharedSetOperation

The list of operations to perform on individual shared sets.

MutateSharedSetsResponse

Response message for a shared set mutate.

Fields
results[]

MutateSharedSetResult

All results for the mutate.

SearchGoogleAdsFieldsRequest

Request message for GoogleAdsFieldService.SearchGoogleAdsFields.

Fields
query

string

The query string.

page_token

string

Token of the page to retrieve. If not specified, the first page of results will be returned. Use the value obtained from next_page_token in the previous response in order to request the next page of results.

page_size

int32

Number of elements to retrieve in a single page. When too large a page is requested, the server may decide to further limit the number of returned resources.

SearchGoogleAdsFieldsResponse

Response message for GoogleAdsFieldService.SearchGoogleAdsFields.

Fields
results[]

GoogleAdsField

The list of fields that matched the query.

next_page_token

string

Pagination token used to retrieve the next page of results. Pass the content of this string as the page_token attribute of the next request. next_page_token is not returned for the last page.

total_results_count

int64

Total number of results that match the query ignoring the LIMIT clause.

SearchGoogleAdsRequest

Request message for GoogleAdsService.Search.

Fields
customer_id

string

The ID of the customer being queried.

query

string

The query string.

page_token

string

Token of the page to retrieve. If not specified, the first page of results will be returned. Use the value obtained from next_page_token in the previous response in order to request the next page of results.

page_size

int32

Number of elements to retrieve in a single page. When too large a page is requested, the server may decide to further limit the number of returned resources.

SearchGoogleAdsResponse

Response message for GoogleAdsService.Search.

Fields
results[]

GoogleAdsRow

The list of rows that matched the query.

next_page_token

string

Pagination token used to retrieve the next page of results. Pass the content of this string as the page_token attribute of the next request. next_page_token is not returned for the last page.

total_results_count

int64

Total number of results that match the query ignoring the LIMIT clause.

field_mask

FieldMask

FieldMask that represents what fields were requested by the user.

SharedCriterionOperation

A single operation (create, remove) on an shared criterion.

Fields
Union field operation. The mutate operation. operation can be only one of the following:
create

SharedCriterion

Create operation: No resource name is expected for the new shared criterion.

remove

string

Remove operation: A resource name for the removed shared criterion is expected, in this format:

customers/{customer_id}/sharedCriteria/{shared_set_id}_{criterion_id}

SharedSetOperation

A single operation (create, update, remove) on an shared set.

Fields
update_mask

FieldMask

FieldMask that determines which resource fields are modified in an update.

Union field operation. The mutate operation. operation can be only one of the following:
create

SharedSet

Create operation: No resource name is expected for the new shared set.

update

SharedSet

Update operation: The shared set is expected to have a valid resource name.

remove

string

Remove operation: A resource name for the removed shared set is expected, in this format:

customers/{customer_id}/sharedSets/{shared_set_id}

Send feedback about...

Google Ads API Beta
Google Ads API Beta
Need help? Visit our support page.