Important

The Bing Ads API Version 13 preview documentation is subject to change. To view version 12 content, use the version selector near the table of contents at the top and left side of the page.

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. 1 AccountId

1,000 AdGroupCriterions
AddAdGroups Adds new 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
AddAudiences Adds one or more audiences. 100 Audiences
AddBudgets Adds new budgets to the account's shared budget library. 100 Budgets
AddCampaignCriterions Adds one or more campaign criterions that help determine whether ads in each campaign get served. 100 CampaignCriterions
AddCampaigns Adds one or more campaigns to the specified account. 1 AccountId

100 Campaigns
AddConversionGoals Adds new conversion goals to the account's shared conversion goal library. 100 ConversionGoals
AddExperiments Adds experiments and creates experiment campaigns based on existing campaigns in an account. 100 Experiments
AddKeywords Adds one or more keywords to an ad group. 1 AdGroupId

1,000 Keywords
AddLabels Adds one or more labels to an account. 100 Labels
AddListItemsToSharedList Adds negative keywords to the shared negative keyword 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. 1 EntityNegativeKeywords

Each EntityNegativeKeyword element can contain up to 20,000 negative keywords.
AddSharedEntity Adds a negative keyword list to the account's library. 1 SharedEntity

5,000 ListItems
AddUetTags Adds 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
AppealEditorialRejections Appeals ads or keywords that failed editorial review. 1,000 EntityIdToParentIdAssociations
ApplyOfflineConversions Applies offline conversions for the account with Microsoft Click Id among other offline conversion data. 1,000 OfflineConversions
ApplyProductPartitionActions Applies an add, update, or delete action to each of the specified BiddableAdGroupCriterion or NegativeAdGroupCriterion, which each contain a ProductPartition. 5,000 CriterionActions
DeleteAdExtensions Deletes 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 from the specified campaign. 1,000 AdGroupIds

1 CampaignId
DeleteAds Deletes one or more ads from the specified ad group. 1 AdGroupId

50 AdIds
DeleteAudiences Deletes the specified audiences. 100 AudienceIds
DeleteBudgets Deletes budgets from the account's shared budget library. 100 BudgetIds
DeleteCampaignCriterions Deletes one or more campaign criterions. 100 CampaignCriterionIds
DeleteCampaigns Deletes one or more campaigns in a specified account. 1 AccountId

100 CampaignIds
DeleteExperiments Deletes one or more experiments. 100 ExperimentIds
DeleteKeywords Deletes one or more keywords in a specified ad group. 1 AdGroupId

1,000 KeywordIds
DeleteLabelAssociations Deletes label associations. 100 LabelAssociations
DeleteLabels Deletes one or more labels from the account. 100 LabelIds
DeleteListItemsFromSharedList Deletes negative keywords from a negative keyword 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. 1 EntityNegativeKeywords

Each EntityNegativeKeyword element can contain up to 20,000 negative keywords.
DeleteSharedEntities Deletes negative keyword lists from the account's library. 20 SharedEntities
DeleteSharedEntityAssociations Removes the association between a negative keyword list and an entity such as a campaign. 10,000 Associations
GetAccountMigrationStatuses Gets the migration status info for the specified accounts. 1,000 AccountIds
GetAccountProperties Gets account level properties by name. Not applicable
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 reasons for ad extension editorial issues. 1 AccountId

100 AdExtensionIdToEntityIdAssociations
GetAdGroupCriterionsByIds Gets ad group criterions by identifiers and types. 1 AccountId

1,000 AdGroupCriterionIds
GetAdGroupsByCampaignId Gets the ad groups within the specified campaign. 1 CampaignId
GetAdGroupsByIds Gets the specified ad groups within the specified campaign. 1,000 AdGroupIds

1 CampaignId
GetAdsByAdGroupId Retrieves the ads within 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
GetAudiencesByIds Retrieves the specified audiences from the specified account. 100 AudienceIds
GetBMCStoresByCustomerId Gets the Bing Merchant Center stores for the specified customer. Not applicable.
GetBSCCountries Gets the list of supported sales country codes for Bing Shopping campaigns. Not applicable.
GetBudgetsByIds Gets the specified budgets from the account's shared budget library. 100 BudgetIds
GetCampaignCriterionsByIds Gets the specified campaign criterions. 100 CampaignCriterionIds

1 CampaignId
GetCampaignIdsByBudgetIds Gets the campaign identifiers that share each specified budget. 100 BudgetIds
GetCampaignsByAccountId Gets the campaigns within an account. 1 AccountId
GetCampaignsByIds Gets the specified campaigns within an account. 1 AccountId

100 CampaignIds
GetConversionGoalsByIds Gets the specified conversion goals. 100 ConversionGoalIds
GetConversionGoalsByTagIds Gets the conversion goals that use the specified UET tags. 100 TagIds
GetEditorialReasonsByIds Gets the reasons why the specified entities failed editorial review and whether the issue is appealable. 1 AccountId

1,000 EntityIdToParentIdAssociations
GetExperimentsByIds Gets experiments by experiment identifiers. 1,000 ExperimentIds
GetGeoLocationsFileUrl Gets a temporary URL that you can use to download a file that contains identifiers for the geographical locations that you can target or exclude. Not applicable.
GetKeywordsByAdGroupId Gets the keywords within 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
GetLabelAssociationsByEntityIds Gets label associations by entity identifiers. 100 EntityIds
GetLabelAssociationsByLabelIds Gets label associations by label identifiers. 1 LabelIds
GetLabelsByIds Gets labels by label identifiers. 1,000 LabelIds
GetListItemsBySharedList Gets 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

100 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
GetNegativeKeywordsByEntityIds Gets the negative keywords that are only associated with the specified campaigns or ad groups. 1 ParentEntityId

1 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
GetProfileDataFileUrl Gets a temporary URL that you can use to download company name, industry, or job function profile data. Not applicable.
GetSharedEntitiesByAccountId Gets the negative keyword lists from the account's library. Not applicable.
GetSharedEntityAssociationsByEntityIds Gets negative keyword list associations for the specified campaigns. 100 EntityIds
GetSharedEntityAssociationsBySharedEntityIds Gets shared entity associations for the specified negative keyword lists. 1 SharedEntityIds
GetUetTagsByIds Gets the specified Universal Event Tracking (UET) tags. 100 TagIds
SetAccountProperties Sets account level properties by name. Not applicable
SetAdExtensionsAssociations Associates the specified ad extensions with the respective campaigns or ad groups. 1 AccountId

100 AdExtensionIdToEntityIdAssociations
SetLabelAssociations Sets label associations. 100 LabelAssociations
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 negative keyword list. 10,000 Associations
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 campaign. 1,000 AdGroups

1 CampaignId
UpdateAds Updates the specified ads within an ad group. 1 AdGroupId

50 Ads
UpdateAudiences Updates the specified audiences. 100 Audiences
UpdateBudgets Updates the specified budgets in the account's shared budget library. 100 Budgets
UpdateCampaignCriterions Updates one or more campaign criterions. 100 CampaignCriterions
UpdateCampaigns Updates specified campaigns in a specified account. 1 AccountId

100 Campaigns
UpdateConversionGoals Updates conversion goals within the account's shared conversion goal library. 100 ConversionGoals
UpdateExperiments Updates the specified experiments. 100 Experiments
UpdateKeywords Updates the keywords within a specified ad group. 1 AdGroupId

1,000 Keywords
UpdateLabels Updates the labels within the account. 100 Labels
UpdateSharedEntities Updates negative keyword lists within the account's library. 20 SharedEntities
UpdateUetTags Updates the specified Universal Event Tracking (UET) tags. 100 UetTags