Campaign Management Service Operations

 

The Campaign Management service defines the following service operations.

Service OperationDescriptionRequest Limits
AddAdExtensionsAdds ad extensions to an account’s ad extension library.1 AccountId

100 AdExtensions
AddAdGroupCriterionsAdds ad group criterions.1 AccountId

1,000 AdGroupCriterions
AddAdGroupsAdds ad groups to a specified campaign.1,000 AdGroups

1 CampaignId
AddAdsAdds ads to an ad group.1 AdGroupId

50 Ads
AddBudgetsAdds new budgets to the account's shared budget library.100 Budgets
AddCampaignCriterionsAdds campaign criterions.100 CampaignCriterions
AddCampaignsAdds campaigns to an account.1 AccountId

100 Campaigns
AddConversionGoalsAdds new conversion goals to the account's shared conversion goal library.100 ConversionGoals
AddKeywordsAdds keywords to an ad group.1 AdGroupId

1,000 Keywords
AddListItemsToSharedListAdds negative keywords to the shared negative keyword list.1 SharedList

5,000 ListItems
AddMediaAdds the specified media to an account’s media library.1 AccountId

10 Media
AddNegativeKeywordsToEntitiesAdds negative keywords to the corresponding campaign or ad group entity.1 EntityNegativeKeywords

Note: Each EntityNegativeKeyword element can contain up to 20,000 negative keywords.
AddSharedEntityAdds 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
AddUetTagsAdds new Universal Event Tracking (UET) tags that you can add to your website to allow Bing Ads to collect actions people take on your website.100 UetTags
AppealEditorialRejectionsAppeals the editorial rejections of ads or keywords that failed editorial review.1,000 EntityIdToParentIdAssociations
ApplyProductPartitionActionsApplies an add, update, or delete action to the respective BiddableAdGroupCriterion or NegativeAdGroupCriterion, which each contain a ProductPartition.5,000 CriterionActions
DeleteAdExtensionsDelete ad extensions from the account’s ad extension library.1 AccountId

100 AdExtensionIds
DeleteAdExtensionsAssociationsRemoves the ad extension association from the respective campaigns or ad groups.1 AccountId

100 AdExtensionIdToEntityIdAssociations
DeleteAdGroupCriterionsDeletes the list of ad group criterions.1 AccountId

1,000 AdGroupCriterionIds
DeleteAdGroupsDeletes ad groups in a specified campaign.1,000 AdGroupIds

1 CampaignId
DeleteAdsDeletes ads in a specified ad group.1 AdGroupId

50 AdIds
DeleteBudgetsDeletes budgets from the account's shared budget library.100 BudgetIds
DeleteCampaignCriterionsDeletes campaign criterions.100 CampaignCriterionIds
DeleteCampaignsDeletes campaigns in a specified account.1 AccountId

100 CampaignIds
DeleteKeywordsDeletes keywords in a specified ad group.1 AdGroupId

1,000 KeywordIds
DeleteListItemsFromSharedListDeletes negative keywords from the shared negative keyword list.1 SharedList

5,000 ListItemIds
DeleteMediaDeletes the specified media from an account’s media library.

Note: This service operation is not yet supported.
1 AccountId

100MediaIds
DeleteNegativeKeywordsFromEntitiesDeletes negative keywords from the corresponding campaign or ad group entity.1 EntityNegativeKeywords

Note: Each EntityNegativeKeyword element can contain up to 20,000 negative keywords.
DeleteSharedEntitiesDeletes negative keyword lists from the account's library.20 SharedEntities
DeleteSharedEntityAssociationsRemoves the association between a negative keyword list and an entity such as a campaign.10,000 Associations
GetAccountMigrationStatusesRetrieves the account migration status info.1,000 AccountIds
GetAdExtensionIdsByAccountIdRetrieves the ad extensions from the account’s ad extension library.1 AccountId
GetAdExtensionsAssociationsRetrieves the ad extension associations for the respective campaign and ad group identifiers.1 AccountId

100 EntityIds
GetAdExtensionsByIdsRetrieves the specified ad extensions from the account’s ad extension library.1 AccountId

100 AdExtensionIds
GetAdExtensionsEditorialReasonsGets editorial rejection reasons for the respective ad extension and entity associations.1 AccountId

100 AdExtensionIdToEntityIdAssociations
GetAdGroupCriterionsByIdsRetrieves the specified ad group criterions.1 AccountId

1,000 AdGroupCriterionIds
GetAdGroupsByCampaignIdRetrieves the ad groups that exist within a specified campaign.1 CampaignId
GetAdGroupsByIdsRetrieves the campaign's ad groups.1,000 AdGroupIds

1 CampaignId
GetAdsByAdGroupIdRetrieves the ads that are associated with an ad group.1 AdGroupId
GetAdsByEditorialStatusRetrieves the ad group's ads that have the requested editorial review status.1 AdGroupId
GetAdsByIdsRetrieves the ad group's ads.1 AdGroupId

20 AdIds
GetBMCStoresByCustomerIdRetrieves the customer's Bing Merchant Center store details.Not applicable.
GetBSCCountriesRetrieves the list of supported sales country codes for Bing Shopping campaigns.Not applicable.
GetBudgetsByIdsRetrieves the specified budgets from the account's shared budget library.100 BudgetIds
GetCampaignCriterionsByIdsRetrieves the specified campaign criterions.100 CampaignCriterionIds

1 CampaignId
GetCampaignIdsByBudgetIdsRetrieves the campaign identifiers that share each specified budget.100 BudgetIds
GetCampaignsByAccountIdRetrieves all the campaigns that exist within a specified account.1 AccountId
GetCampaignsByIdsRetrieves the the account's campaigns.1 AccountId

100 CampaignIds
GetConversionGoalsByIdsRetrieves the requested conversion goals.100 ConversionGoalIds
GetConversionGoalsByTagIdsRetrieves the conversion goals that use the specified UET tags.100 TagIds
GetEditorialReasonsByIdsRetrieves the reasons why the specified entities failed editorial review and whether the rejection is appealable.1 AccountId

1,000 EntityIdToParentIdAssociations
GetGeoLocationsFileUrlGets a temporary URL that you can use to download a file that contains the supported geographical location criterion codes.Not applicable.
GetKeywordsByAdGroupIdRetrieves the keywords for an ad group.1 AdGroupId
GetKeywordsByEditorialStatusRetrieves the keywords that have the requested editorial review status.1 AdGroupId
GetKeywordsByIdsRetrieves the specified keywords.1 AdGroupId

1,000 KeywordIds
GetListItemsBySharedListGets the negative keywords of a negative keyword list.1 SharedList
GetMediaAssociationsRetrieves the media associations of the specified entity type from an account’s media library.1 AccountId

10 MediaIds
GetMediaByIdsRetrieves the specified media from an account’s media library.1 AccountId

10 MediaIds
GetMediaMetaDataByAccountIdRetrieves the media meta data of the specified entity type from an account’s media library.Not applicable.
GetMediaMetaDataByIdsRetrieves the specified media meta data from an account’s media library.100 MediaIds
GetNegativeKeywordsByEntityIdsRetrieves the negative keywords that are only associated with the specified campaigns or ad groups.1 ParentEntityId

1 EntityIds
GetNegativeSitesByAdGroupIdsRetrieves the negative site URLs of the specified ad groups.15 AdGroupIds

1 CampaignId
GetNegativeSitesByCampaignIdsRetrieves the negative site URLs of the specified campaigns.1 AccountId

15 CampaignIds
GetSharedEntitiesByAccountIdGets the negative keyword lists from the account's library.Not applicable.
GetSharedEntityAssociationsByEntityIdsGets negative keyword list associations for the specified campaigns.100 EntityIds
GetSharedEntityAssociationsBySharedEntityIdsGets shared entity associations for the specified negative keyword lists.1 SharedEntityIds
GetUetTagsByIdsRetrieves the specified Universal Event Tracking (UET) tags.100 TagIds
SetAdExtensionsAssociationsAssociates the specified ad extensions with the respective campaigns or ad groups.1 AccountId

100 AdExtensionIdToEntityIdAssociations
SetNegativeSitesToAdGroupsSets the negative site URLs of the specified ad groups.5,000 AdGroupNegativeSites

1 CampaignId
SetNegativeSitesToCampaignsSets the negative site URLs of the specified campaigns.1 AccountId

5,000 CampaignNegativeSites
SetSharedEntityAssociationsSets the association between a campaign and a negative keyword list.10,000 Associations
UpdateAdExtensionsUpdates ad extensions within an account’s ad extension library.1 AccountId

100 AdExtensions
UpdateAdGroupCriterionsUpdates ad group criterions.1 AccountId

1,000 AdGroupCriterions
UpdateAdGroupsUpdates the specified ad groups in a specified campaign.1,000 AdGroups

1 CampaignId
UpdateAdsUpdates the specified ads within a particular ad group.1 AdGroupId

50 Ads
UpdateBudgetsUpdates budgets in the account's shared budget library.100 Budgets
UpdateCampaignCriterionsUpdates campaign criterions.100 CampaignCriterions
UpdateCampaignsUpdates specified campaigns in a specified account.1 AccountId

100 Campaigns
UpdateConversionGoalsUpdates conversion goals within the account's shared conversion goal library.100 ConversionGoals
UpdateKeywordsUpdates the keywords within a specified ad group.1 AdGroupId

1,000 Keywords
UpdateSharedEntitiesUpdates negative keyword lists within the account's library.20 SharedEntities
UpdateUetTagsUpdates the specified Universal Event Tracking (UET) tags.100 UetTags
Show: