Operations

• addCampaign
• addCampaigns
• deleteCampaign
• deleteCampaigns
• deleteGeographicLocationFromCampaign
• getCampaign
• getCampaignAdGroupCount
• getCampaignKeywordCount
• getCampaigns
• getCampaignsByAccountID
• getCampaignsByAccountIDByCampaignStatus
• getGeographicLocationForCampaign
• getMinBidForCampaignOptimizationGuidelines  (added in Version 4.0.0)
• getOptimizationGuidelinesForCampaign
• getStatusForCampaign
• setCampaignOptimizationON
• setGeographicLocationForCampaign
• setOptimizationGuidelinesForCampaign
• updateCampaign
• updateCampaigns
• updateStatusForCampaign
• updateStatusForCampaigns

addCampaign

Create a campaign.

Capability required: CampaignWrite
License command group: Marketing

Parameters

Parameter	Data Type	Description
campaign	Campaign	The new campaign.

Response

CampaignResponse - The response, which indicates if the operation succeeded or failed.

addCampaigns

Create one or more campaigns.

Capability required: CampaignWrite
License command group: Marketing

Parameters

Parameter	Data Type	Description
campaigns	Campaign[]	A list of campaigns.

Response

CampaignResponse[] - A list of responses, which indicate if the operations succeeded or failed.

deleteCampaign

Delete the campaign (specified by campaignID).

Capability required: CampaignWrite
License command group: Marketing

Parameters

Parameter	Data Type	Description
campaignID	long	The campaign ID.

Response

BasicResponse - The response, which indicates if the operation succeeded or failed.

deleteCampaigns

Delete one or more campaigns (specified by the list of campaignIDs).

Capability required: CampaignWrite
License command group: Marketing

Parameters

Parameter	Data Type	Description
campaignIDs	long[]	A list of campaign IDs.

Response

BasicResponse[] - A list of responses, which indicate if the operations succeeded or failed.

deleteGeographicLocationFromCampaign

Delete the geographic location for the campaign (specified by campaignID).

Capability required: CampaignWrite
License command group: Marketing

Parameters

Parameter	Data Type	Description
campaignID	long	The campaign ID.

Response

BasicResponse - The response, which indicates if the operation succeeded or failed.

getCampaign

Return the campaign (specified by campaignID).

Capability required: CampaignRead
License command group: Marketing

Parameters

Parameter	Data Type	Description
campaignID	long	The campaign ID.

Response

Campaign - The campaign.

getCampaignAdGroupCount

Return the number of ad groups for the campaign (specified by campaignID).

Capability required: CampaignRead
License command group: Marketing

Parameters

Parameter	Data Type	Description
campaignID	long	The campaign ID.
includeDeleted	boolean	If true, include deleted ad groups in the count.

Response

long - The number of ad groups for the campaign.

getCampaignKeywordCount

Return the number of keywords for the campaign (specified by campaignID).

Capability required: CampaignRead
License command group: Marketing

Parameters

Parameter	Data Type	Description
campaignID	long	The campaign ID.
includeDeleted	boolean	If true, include deleted keywords in the count.

Response

long - The number of keywords for the campaign.

getCampaigns

Return one or more campaigns (specified by a list of campaignIDs).

Capability required: CampaignRead
License command group: Marketing

Parameters

Parameter	Data Type	Description
campaignIDs	long[]	A list of campaign IDs.

Response

Campaign[] - A list of campaigns.

getCampaignsByAccountID

Return the campaigns for the account (specified by accountID).

Capability required: CampaignRead
License command group: Marketing

Parameters

Parameter	Data Type	Description
accountID	string	The account ID.
includeDeleted	boolean	If true, include deleted campaigns.

Response

Campaign[] - A list of all campaigns for the account.

getCampaignsByAccountIDByCampaignStatus

Return the campaigns with the indicated status for the account (specified by accountID).

Capability required: CampaignRead
License command group: Marketing

Parameters

Parameter	Data Type	Description
accountID	string	The account ID.
status	CampaignStatus	The campaign status.

Response

Campaign[] - A list of campaigns with the indicated status for the specified account.

getGeographicLocationForCampaign

Return the geographic location for the campaign (specified by campaignID).

Capability required: CampaignRead
License command group: Marketing

Parameters

Parameter	Data Type	Description
campaignID	long	The campaign ID.

Response

string[] - The list of geographic locations for the campaign or, if you did not set any geographic locations, an empty list.

getMinBidForCampaignOptimizationGuidelines

Return the minimum bid for the optimization guidelines and the campaign (specified by campaignID).

Added in: Version 4.0.0
Capability required: CampaignRead
License command group: CampaignOptimization

Parameters

Parameter	Data Type	Description
campaignID	long	The campaign ID.

Response

double - The minimum bid.

getOptimizationGuidelinesForCampaign

Return the optimization guidelines for the campaign (specified by campaignID).

Capability required: CampaignRead
License command group: CampaignOptimization

Parameters

Parameter	Data Type	Description
campaignID	long	The campaign ID.

Response

CampaignOptimizationGuidelines - The optimization guidelines for the campaign.

getStatusForCampaign

Return the status of the campaign (specified by campaignID).

Capability required: CampaignRead
License command group: AdvancedTools

Parameters

Parameter	Data Type	Description
campaignID	long	The campaign ID.

Response

CampaignStatus - The status of the campaign.

setCampaignOptimizationON

Enable or disable optimization for the campaign (specified by campaignID).

Before you can enable campaign optimization, you must create a campaign and set up the campaign optimization guidelines. Optionally, you may also set up the ad group and keyword optimization guidelines (see Campaign Optimization).

To set up the optimization guidelines, use setOptimizationGuidelinesForCampaign, setOptimizationGuidelinesForAdGroup, and setOptimizationGuidelinesForKeyword.

Capability required: CampaignWrite
License command group: CampaignOptimization

Parameters

Parameter	Data Type	Description
campaignID	long	The campaign ID.
campaignOptimizationON	boolean	If true, campaign optimization is enabled.

Response

BasicResponse - The response, which indicates if the operation succeeded or failed.

setGeographicLocationForCampaign

Set the geographic location for the campaign (specified by campaignID). If you do not set a geographic location, the campaign defaults to the market-level geographic location.

Capability required: CampaignWrite
License command group: Marketing

Parameters

Parameter	Data Type	Description
campaignID	long	The campaign ID.
geoStrings	string[]	A list of geographic locations.

Response

SetGeographicLocationResponse - The response, which indicates if the locations you submitted were recognized and successfully set.

setOptimizationGuidelinesForCampaign

Set the optimization guidelines for the campaign.

Capability required: CampaignWrite
License command group: CampaignOptimization

Parameters

Parameter	Data Type	Description
optimizationGuidelines	CampaignOptimizationGuidelines	The optimization guidelines for the campaign.

Response

CampaignOptimizationGuidelinesResponse - The response, which indicates if the operation succeeded or failed.

updateCampaign

Update a campaign.

Capability required: CampaignWrite
License command group: Marketing

Parameters

Parameter	Data Type	Description
campaign	Campaign	A campaign.
updateAll	boolean	If true, the system performs a full update. All elements are updated. If you pass in the null value or omit an element, the current value is cleared. If false, the system performs a partial update. Only those elements you specify are updated. If you pass in the null value or omit an element, the current value is not changed.

Response

CampaignResponse - The response, which indicates if the operation succeeded or failed.

updateCampaigns

Update one or more campaigns.

Capability required: CampaignWrite
License command group: Marketing

Parameters

Parameter	Data Type	Description
campaigns	Campaign[]	A list of campaigns.
updateAll	boolean	If true, the system performs a full update. All elements are updated. If you pass in the null value or omit an element, the current value is cleared. If false, the system performs a partial update. Only those elements you specify are updated. If you pass in the null value or omit an element, the current value is not changed.

Response

CampaignResponse[] - A list of responses, which indicate if the operations succeeded or failed.

updateStatusForCampaign

Update the status of the campaign (specified by campaignID).

Capability required: CampaignWrite
License command group: AdvancedTools

Parameters

Parameter	Data Type	Description
campaignID	long	The campaign ID.
status	CampaignStatus	The new campaign status. You can set the status to On or Off, but not Deleted. (To delete a campaign, use the deleteCampaign operation.)

Response

CampaignResponse - The response, which indicates if the operation succeeded or failed.

updateStatusForCampaigns

Update the status of one or more campaigns (specified by a list of campaignIDs).

Capability required: CampaignWrite
License command group: AdvancedTools

Parameters

Parameter	Data Type	Description
campaignIDs	long[]	A list of campaign IDs.
status	CampaignStatus	The new campaign status. You can set the status to On or Off, but not Deleted. (To delete a campaign, use the deleteCampaigns operation.)

Response

CampaignResponse[] - A list of responses, which indicate if the operations succeeded or failed.