Export (0) Print
Expand All
Expand Minimize

Campaign Management Service Operations

The Campaign Management service defines the following service operations.

Service Operation

Description

Request Limits

AddAdExtensions

Adds one or more ad extensions to an account’s ad extension library.

1 AccountId

100 AdExtensions

AddAdGroupCriterions

Adds one or more ad group criterions that determine whether ads in the ad group get served.

1 AccountId

1,000 AdGroupCriterions

AddAdGroups

Adds one or more ad groups to a specified campaign.

1,000 AdGroups

1 CampaignId

AddAds

Adds one or more ads to an ad group.

1 AdGroupId

50 Ads

AddCampaigns

Adds one or more campaigns to an account.

1 AccountId

100 Campaigns

AddKeywords

Adds one or more keywords to an ad group.

1 AdGroupId

1,000 Keywords

AddListItemsToSharedList

Adds list items such as negative keywords to the corresponding list.

1 SharedList

5,000 ListItems

AddMedia

Adds the specified media to an account’s media library.

1 AccountId

10 Media

AddNegativeKeywordsToEntities

Adds negative keywords to the specified campaign or ad group.

10,000 EntityNegativeKeywords

AddSharedEntity

Adds a shared entity such as a negative keyword list to the account's library. Items in the account's library can be associated with any campaign within the account.

1 SharedEntity

5,000 ListItems

AddSitePlacements

Adds one or more website placement bids to an ad group.

1 AdGroupId

1,000 SitePlacementIds

AddTargetsToLibrary

Adds the specified Target to your target library.

1 Target

AddTargetsToLibrary2

Adds the specified Target2 to your target library.

1 Target

AppealEditorialRejections

Appeals the editorial rejections of one or more ads or keywords that failed editorial review.

1,000 EntityIds

DeleteAdExtensions

Delete one or more ad extensions from the account’s ad extension library.

1 AccountId

100 AdExtensionIds

DeleteAdExtensionsAssociations

Removes the specified association from the respective campaigns or ad groups.

1 AccountId

100 AdExtensionIdToEntityIdAssociations

DeleteAdGroupCriterions

Deletes the specified ad group criterions.

1 AccountId

1,000 AdGroupCriterionIds

DeleteAdGroups

Deletes one or more ad groups in a specified campaign.

1,000 AdGroupIds

1 CampaignId

DeleteAds

Deletes one or more ads in a specified ad group.

1 AdGroupId

50 AdIds

DeleteCampaigns

Deletes one or more campaigns in a specified account.

1 AccountId

100 CampaignIds

DeleteKeywords

Deletes one or more keywords in a specified ad group.

1 AdGroupId

1,000 KeywordIds

DeleteListItemsFromSharedList

Deletes list items such as negative keywords from the corresponding list.

1 SharedList

5,000 ListItemIds

DeleteMedia

Deletes the specified media from an account’s media library.

1 AccountId

100MediaIds

DeleteNegativeKeywordsFromEntities

Deletes negative keywords from the specified campaign or ad group.

10,000 EntityNegativeKeywords

DeleteSharedEntities

Deletes shared entities such as negative keyword lists from the account's library.

20 SharedEntities

DeleteSharedEntityAssociations

Removes the association between a shared entity such as a negative keyword list and an entity such as a campaign.

1,000 Associations

DeleteSitePlacements

Deletes one or more website-placement bids from an ad group.

1 AdGroupId

2,000 SitePlacementIds

DeleteTargetFromAdGroup

Removes the target association for the specified ad group.

1 AdGroupId

DeleteTargetFromCampaign

Removes the target association for the specified campaign.

1 CampaignId

DeleteTargetsFromLibrary

Removes targets from your target library.

1 TargetId

GetAdExtensionIdsByAccountId

Gets the ad extensions from the account’s ad extension library.

1 AccountId

GetAdExtensionsAssociations

Gets the respective ad extension associations by the specified campaign and ad group identifiers.

1 AccountId

100 EntityIds

GetAdExtensionsByIds

Gets the specified ad extensions from the account’s ad extension library.

1 AccountId

100 AdExtensionIds

GetAdExtensionsEditorialReasons

Gets editorial rejection reasons for the respective ad extension and entity associations.

1 AccountId

100 AdExtensionIdToEntityIdAssociations

GetAdGroupCriterionsByAdGroupId

Gets the specified types of criterions from the specified ad group.

1 AccountId

1 AdGroupId

GetAdGroupCriterionsByIds

Gets the specified criterions.

1 AccountId

1,000 AdGroupCriterionIds

GetAdGroupsByCampaignId

Gets the ad groups that exist within a specified campaign.

1 CampaignId

GetAdGroupsByIds

Gets the specified ad groups that exist within a specified campaign.

1,000 AdGroupIds

1 CampaignId

GetAdsByAdGroupId

Retrieves the ads that are associated with an ad group.

1 AdGroupId

GetAdsByEditorialStatus

Retrieves the ads that belong to the specified ad group and have the specified editorial review status.

1 AdGroupId

GetAdsByIds

Retrieves the specified ads from the specified ad group.

1 AdGroupId

20 AdIds

GetBMCStoresByCustomerId

Gets the Bing Merchant Center stores for the specified customer.

Not applicable.

GetCampaignsByAccountId

Retrieves all the campaigns that exist within a specified account.

1 AccountId

GetCampaignsByIds

Retrieves the specified campaigns from the specified account.

1 AccountId

100 CampaignIds

GetEditorialReasonsByIds

Gets the reasons why the specified entities failed editorial review and whether the rejection is appealable.

1 AccountId

1,000 EntityIds

GetKeywordsByAdGroupId

Retrieves the keywords for an ad group.

1 AdGroupId

GetKeywordsByEditorialStatus

Retrieves the keywords with the specified editorial review status.

1 AdGroupId

GetKeywordsByIds

Retrieves the specified keywords.

1 AdGroupId

1,000 KeywordIds

GetListItemsBySharedList

Gets the list items such as the negative keywords of a negative keyword list.

1 SharedList

GetMediaAssociations

Gets the media associations of the specified entity type from an account’s media library.

1 AccountId

10 MediaIds

GetMediaByIds

Gets the specified media from an account’s media library.

1 AccountId

10 MediaIds

GetMediaMetaDataByAccountId

Gets the media meta data of the specified entity type from an account’s media library.

Not applicable.

GetMediaMetaDataByIds

Gets the specified media meta data from an account’s media library.

100 MediaIds

GetNegativeKeywordsByAdGroupIds

Retrieves the negative keywords that are only associated to the specified ad group.

25 AdGroupIds

1 CampaignId

GetNegativeKeywordsByCampaignIds

Retrieves the negative keywords that are only associated to the specified campaign.

1 AccountId

25 CampaignIds

GetNegativeKeywordsByEntityIds

Gets the negative keywords that are only associated with the specified campaigns or ad groups.

1 ParentEntityId

25 EntityIds

GetNegativeSitesByAdGroupIds

Gets the negative site URLs of the specified ad groups.

15 AdGroupIds

1 CampaignId

GetNegativeSitesByCampaignIds

Gets the negative site URLs of the specified campaigns.

1 AccountId

15 CampaignIds

GetPlacementDetailsForUrls

Retrieves placement information for the specified URLs.

10 Urls

GetSitePlacementsByAdGroupId

Retrieves all the website-placement bids from the specified ad group.

1 AdGroupId

GetSharedEntitiesByAccountId

Gets the shared entities such as negative keyword lists from the account's library.

Not applicable.

GetSharedEntityAssociationsByEntityIds

Gets associations between a campaign and a shared entity such as a negative keyword list. You can request associations by associated entity identifiers.

1 EntityIds

GetSharedEntityAssociationsBySharedEntityIds

Gets associations between a campaign and a shared entity such as a negative keyword list. You can request associations by shared entity identifiers.

1 SharedEntityIds

GetSitePlacementsByIds

Retrieves the specified website-placement bids from the specified ad group.

1 AdGroupId

1,000 SitePlacementIds

GetTargetsByAdGroupIds

Retrieves detailed information about the Target objects that are associated with the specified ad groups.

100 AdGroupIds

GetTargetsByAdGroupIds2

Retrieves detailed information about the Target2 objects that are associated with the specified ad groups.

100 AdGroupIds

GetTargetsByCampaignIds

Retrieves detailed information about the Target objects that are associated with the specified campaigns.

100 CampaignIds

GetTargetsByCampaignIds2

Retrieves detailed information about the Target2 objects that are associated with the specified campaigns.

100 CampaignIds

GetTargetsByIds

Retrieves detailed information about the specified Target objects.

100 TargetIds

GetTargetsByIds2

Retrieves detailed information about the specified Target2 objects.

100 TargetIds

GetTargetsInfoFromLibrary

Retrieves identifier information about all the targets in your target library.

Not applicable.

SetAdExtensionsAssociations

Associates the specified ad extensions with the respective campaigns or ad groups.

1 AccountId

100 AdExtensionIdToEntityIdAssociations

SetNegativeKeywordsToAdGroups

Sets the negative keywords of the specified ad groups.

25 AdGroupNegativeKeywords

1 CampaignId

SetNegativeKeywordsToCampaigns

Sets the negative keywords of the specified campaigns.

1 AccountId

25 CampaignNegativeKeywords

SetNegativeSitesToAdGroups

Sets the negative site URLs of the specified ad groups.

5,000 AdGroupNegativeSites

1 CampaignId

SetNegativeSitesToCampaigns

Sets the negative site URLs of the specified campaigns.

1 AccountId

5,000 CampaignNegativeSites

SetSharedEntityAssociations

Sets the association between a campaign and a shared entity such as a negative keyword list.

10,000 Associations

SetTargetToAdGroup

Associates the specified target with the specified ad group.

1 AdGroupId

1 TargetId

SetTargetToCampaign

Associates the specified target with the specified campaign.

1 CampaignId

1 TargetId

SubmitAdGroupForApproval

Submits an ad group for editorial review.

1 AdGroupId

UpdateAdExtensions

Updates one or more ad extensions within an account’s ad extension library.

1 AccountId

100 AdExtensions

UpdateAdGroupCriterions

Updates one or more ad group criterions.

1 AccountId

1,000 AdGroupCriterions

UpdateAdGroups

Updates the specified ad groups in a specified campaign.

1,000 AdGroups

1 CampaignId

UpdateAds

Updates the specified ads within a particular ad group.

1 AdGroupId

50 Ads

UpdateCampaigns

Updates specified campaigns in a specified account.

1 AccountId

100 Campaigns

UpdateKeywords

Updates the keywords within a specified ad group.

1 AdGroupId

1,000 Keywords

UpdateSharedEntities

Updates shared entities such as negative keyword lists within the account's library.

20 SharedEntities

UpdateSitePlacements

Updates one or more website-placement bids in an ad group.

1 AdGroupId

1,000 SitePlacements

UpdateTargetsInLibrary

Updates Target objects in your target library.

1 Target

UpdateTargetsInLibrary2

Updates Target2 objects in your target library.

1 Target

Community Additions

ADD
Show:
© 2014 Microsoft