市场活动管理服务操作
市场活动管理服务定义以下服务操作。
服务操作 | 说明 | 请求限制 |
---|---|---|
AddAdExtensions | 将一个或多个广告扩展添加到帐户的广告扩展库。 | 1 AccountId 100 个 AdExtensions |
AddAdGroupCriterions | 添加一个或多个广告组条件。 | 1 AccountId 1,000 个 AdGroupCriterions |
AddAdGroups | 向指定的市场活动添加新广告组。 | 1,000 个 AdGroups 1 CampaignId |
AddAds | 将一个或多个广告添加到广告组。 | 1 AdGroupId 50 个广告 |
AddAssetGroups | 将资产组数组添加到指定的市场活动。 | 不适用。 |
AddAudienceGroups | 向帐户添加访问群体数组。 | 不适用。 |
AddAudiences | 添加一个或多个访问群体。 | 100 个受众 |
AddBidStrategies | 将出价策略添加到帐户的项目组合出价策略库。 | 100 BidStrategies |
AddBudgets | 将新预算添加到帐户的共享预算库。 | 100 预算 |
AddCampaignConversionGoals | 将新的市场活动转换目标添加到帐户的共享市场活动转换目标库。 | 不适用。 |
AddCampaignCriterions | 添加一个或多个市场活动条件,以帮助确定每个市场活动中的广告是否得到投放。 | 100 CampaignCriterions |
AddCampaigns | 将一个或多个市场活动添加到指定的帐户。 | 1 AccountId 100 个市场活动 |
AddConversionGoals | 向帐户的共享转换目标库添加新的转换目标。 | 100 ConversionGoals |
AddConversionValueRules | 创建新的转换值规则。 | 不适用。 |
AddDataExclusions | 向指定的帐户添加数据排除。 | 不适用。 |
AddExperiments | 添加试验,并根据帐户中的现有市场活动创建试验市场活动。 | 100 个试验 |
AddImportJobs | 创建新的导入作业。 | 1 个 ImportJobs |
AddKeywords | 向广告组添加一个或多个关键字。 | 1 AdGroupId 1,000 个关键字 |
AddLabels | 向帐户添加一个或多个标签。 | 100 个标签 |
AddListItemsToSharedList | 将负面关键字添加到负面关键字 (keyword) 列表,或将负面网站添加到网站排除列表。 | 1 SharedList 5,000 ListItems |
AddMedia | 将指定的媒体添加到帐户的资产库。 | 1 AccountId 10 媒体 |
AddNegativeKeywordsToEntities | 将否定关键字添加到指定的市场活动或广告组。 | 1 EntityNegativeKeywords 每个 EntityNegativeKeyword 元素最多可以包含 20,000 个否定关键字。 |
AddSeasonalityAdjustments | 向指定帐户添加季节性调整。 | 不适用。 |
AddSharedEntity | 将负面关键字 (keyword) 列表添加到广告帐户库,或将网站排除列表添加到经理帐户 (客户) 库。 | 1 SharedEntity 5,000 ListItems |
AddUetTags | 添加新的通用事件跟踪 (UET) 标记,这些标记可以添加到网站,以允许Microsoft广告收集用户在你的网站上执行的操作。 | 100 UetTags |
AddVideos | 将一个或多个视频添加到帐户。 | 100 个视频 |
AppealEditorialRejections | 对未通过编辑评审的广告或关键字提出上诉。 | 1,000 EntityIdToParentIdAssociations |
ApplyAssetGroupListingGroupActions | 将操作应用于资产组列表组。 | 不适用。 |
ApplyCustomerListItems | 定义 ApplyCustomerListItems 服务操作。 | 不适用。 |
ApplyCustomerListUserData | 定义 ApplyCustomerListUserData 服务操作。 | 不适用。 |
ApplyHotelGroupActions | 将添加、更新或删除操作应用于每个指定的 BiddableAdGroupCriterion 或 NegativeAdGroupCriterion,其中每个都包含 一个 HotelGroup。 | 不适用。 |
ApplyOfflineConversionAdjustments | 应用脱机转换调整。 | 1,000 OfflineConversionAdjustments |
ApplyOfflineConversions | 在其他脱机转换数据Microsoft单击 ID 的帐户应用脱机转换。 | 1,000 OfflineConversions |
ApplyOnlineConversionAdjustments | 应用联机转换调整。 | 不适用。 |
ApplyProductPartitionActions | 将添加、更新或删除操作应用于每个指定的 BiddableAdGroupCriterion 或 NegativeAdGroupCriterion,每个操作都包含 一个 ProductPartition。 | 5,000 CriterionActions |
CreateAssetGroupRecommendation | 创建资产组建议。 | 不适用。 |
CreateResponsiveAdRecommendation | 创建响应式广告建议。 | 不适用。 |
CreateResponsiveSearchAdRecommendation | 创建响应式搜索广告建议。 | 不适用。 |
DeleteAdExtensions | 从帐户的广告扩展库中删除一个或多个广告扩展。 | 1 AccountId 100 AdExtensionIds |
DeleteAdExtensionsAssociations | 从相应的市场活动或广告组中删除指定的关联。 | 1 AccountId 100 AdExtensionIdToEntityIdAssociations |
DeleteAdGroupCriterions | 删除指定的广告组条件。 | 1 AccountId 1,000 AdGroupCriterionIds |
DeleteAdGroups | 从指定的市场活动中删除一个或多个广告组。 | 1,000 个 AdGroupId 1 CampaignId |
DeleteAds | 从指定的广告组中删除一个或多个广告。 | 1 AdGroupId 50 AdIds |
DeleteAssetGroups | 删除一个或多个 AssetGroup。 | 不适用。 |
DeleteAudienceGroupAssetGroupAssociations | 删除一个或多个 AudienceGroupAssetGroupAssociations。 | 不适用。 |
DeleteAudienceGroups | 删除一个或多个 AudienceGroup。 | 不适用。 |
DeleteAudiences | 删除指定的访问群体。 | 100 AudienceIds |
DeleteBidStrategies | 从帐户的项目组合出价策略库中删除出价策略。 | 100 BidStrategyIds |
DeleteBudgets | 从帐户的共享预算库中删除预算。 | 100 BudgetIds |
DeleteCampaignConversionGoals | 删除市场活动转换目标。 | 不适用。 |
DeleteCampaignCriterions | 删除一个或多个市场活动条件。 | 100 CampaignCriterionIds |
DeleteCampaigns | 删除指定帐户中的一个或多个市场活动。 | 1 AccountId 100 CampaignIds |
DeleteDataExclusions | 从指定帐户中删除指定的数据排除项。 | 不适用。 |
DeleteExperiments | 删除一个或多个试验。 | 100 ExperimentIds |
DeleteImportJobs | 删除导入作业。 | 1 个 ImportJobs |
DeleteKeywords | 删除指定广告组中的一个或多个关键字。 | 1 AdGroupId 1,000 KeywordIds |
DeleteLabelAssociations | 删除标签关联。 | 100 LabelAssociations |
DeleteLabels | 从帐户中删除一个或多个标签。 | 100 LabelIds |
DeleteListItemsFromSharedList | 从负面关键字 (keyword) 列表中删除负面关键字,或从网站排除列表中删除负面网站。 | 1 SharedList 5,000 ListItemIds |
DeleteMedia | 从帐户的媒体库中删除指定的媒体。 | 1 AccountId 100MediaIds |
DeleteNegativeKeywordsFromEntities | 从指定的市场活动或广告组中删除否定关键字。 | 1 EntityNegativeKeywords 每个 EntityNegativeKeyword 元素最多可以包含 20,000 个否定关键字。 |
DeleteSeasonalityAdjustments | 从指定的帐户中删除指定的季节性调整。 | 不适用。 |
DeleteSharedEntities | 从广告帐户库中删除负面关键字 (keyword) 列表,或从经理帐户 (客户) 库中删除网站排除列表。 | 20 SharedEntities |
DeleteSharedEntityAssociations | 删除市场活动关联或广告帐户关联的网站排除列表的负面关键字 (keyword) 列表。 | 10,000 个关联 |
DeleteVideos | 从帐户中删除一个或多个视频。 | 100 VideoIds |
GetAccountMigrationStatuses | 获取指定帐户的迁移状态信息。 | 1,000 AccountIds |
GetAccountProperties | 按名称获取帐户级别属性。 | 不适用 |
GetAdExtensionIdsByAccountId | 从帐户的广告扩展库获取广告扩展。 | 1 AccountId |
GetAdExtensionsAssociations | 按指定的市场活动标识符和广告组标识符获取相应的广告扩展关联。 | 1 AccountId 100 EntityIds |
GetAdExtensionsByIds | 从帐户的广告扩展库获取指定的广告扩展。 | 1 AccountId 100 AdExtensionIds |
GetAdExtensionsEditorialReasons | 获取广告扩展插件编辑问题的原因。 | 1 AccountId 100 AdExtensionIdToEntityIdAssociations |
GetAdGroupCriterionsByIds | 按标识符和类型获取广告组条件。 | 1 AccountId 1,000 AdGroupCriterionIds |
GetAdGroupsByCampaignId | 获取指定市场活动中的广告组。 | 1 CampaignId |
GetAdGroupsByIds | 获取指定市场活动中的指定广告组。 | 1,000 个 AdGroupId 1 CampaignId |
GetAdsByAdGroupId | 检索广告组中的广告。 | 1 AdGroupId |
GetAdsByEditorialStatus | 检索属于指定广告组并具有指定编辑评审状态的广告。 | 1 AdGroupId |
GetAdsByIds | 从指定的广告组检索指定的广告。 | 1 AdGroupId 20 个 AdId |
GetAssetGroupListingGroupsByIds | 检索指定的 AssetGroupListingGroup。 | 不适用。 |
GetAssetGroupsByCampaignId | 检索指定的 AssetGroup。 | 不适用。 |
GetAssetGroupsByIds | 检索指定的 AssetGroup。 | 不适用。 |
GetAssetGroupsEditorialReasons | 获取资产组编辑问题的原因。 | 不适用。 |
GetAudienceGroupAssetGroupAssociationsByAssetGroupIds | 按资产组 ID 检索指定的 AudienceGroupAssetGroupAssociations。 | 不适用。 |
GetAudienceGroupAssetGroupAssociationsByAudienceGroupIds | 按访问群体组 ID 检索指定的 AudienceGroupAssetGroupAssociations。 | 不适用。 |
GetAudienceGroupsByIds | 检索指定的 AudienceGroup。 | 不适用。 |
GetAudiencesByIds | 从指定帐户检索指定的访问群体。 | 100 AudienceIds |
GetBidStrategiesByIds | 获取帐户的项目组合出价策略库中的出价策略。 | 100 BidStrategyIds |
GetBMCStoresByCustomerId | 获取指定客户的Microsoft商家中心商店。 | 不适用。 |
GetBSCCountries | 获取Microsoft购物市场活动支持的销售国家/地区代码列表。 | 不适用。 |
GetBudgetsByIds | 从帐户的共享预算库中获取指定的预算。 | 100 BudgetIds |
GetCampaignCriterionsByIds | 获取指定的市场活动条件。 | 100 CampaignCriterionIds 1 CampaignId |
GetCampaignIdsByBidStrategyIds | 获取与指定的项目组合出价策略关联的市场活动标识符。 | 100 BidStrategyIds |
GetCampaignIdsByBudgetIds | 获取共享每个指定预算的市场活动标识符。 | 100 BudgetIds |
GetCampaignsByAccountId | 获取帐户中的市场活动。 | 1 AccountId |
GetCampaignsByIds | 获取帐户中的指定市场活动。 | 1 AccountId 100 CampaignIds |
GetConversionGoalsByIds | 获取指定的转换目标。 | 100 ConversionGoalIds |
GetConversionGoalsByTagIds | 获取使用指定 UET 标记的转换目标。 | 100 TagIds |
GetConversionValueRulesByAccountId | 按帐户 ID 获取转换值规则。 | 不适用。 |
GetConversionValueRulesByIds | 按其 ID 获取转换值规则。 | 不适用。 |
GetDataExclusionsByAccountId | 获取与帐户关联的数据排除项。 | 不适用。 |
GetDataExclusionsByIds | 获取与帐户关联的指定数据排除项。 | 不适用。 |
GetEditorialReasonsByIds | 获取指定实体未通过编辑评审的原因以及问题是否可上诉。 | 1 AccountId 1,000 EntityIdToParentIdAssociations |
GetExperimentsByIds | 按试验标识符获取试验。 | 5,000 ExperimentIds |
GetFileImportUploadUrl | GetFileImportUploadUrl 保留供将来使用。 | 不适用。 |
GetGeoLocationsFileUrl | 获取一个临时 URL,可用于下载包含可定位或排除的地理位置的标识符的文件。 | 不适用。 |
GetImportEntityIdsMapping | 获取源实体 ID 到Microsoft广告实体 ID 的映射。 | 100 个 SourceEntityIds |
GetImportJobsByIds | 按类型和标识符获取导入作业。 | 100 ImportJobIds |
GetImportResults | 获取过去 90 天内完成的导入作业的结果。 | 100 ImportJobIds |
GetKeywordsByAdGroupId | 获取广告组中的关键字。 | 1 AdGroupId |
GetKeywordsByEditorialStatus | 检索具有指定编辑评审状态的关键字。 | 1 AdGroupId |
GetKeywordsByIds | 检索指定的关键字。 | 1 AdGroupId 1,000 KeywordIds |
GetLabelAssociationsByEntityIds | 按实体标识符获取标签关联。 | 100 EntityIds |
GetLabelAssociationsByLabelIds | 按标签标识符获取标签关联。 | 1 LabelIds |
GetLabelsByIds | 按标签标识符获取标签。 | 1,000 LabelIds |
GetListItemsBySharedList | 获取负面关键字 (keyword) 列表或网站排除列表的负面网站的负面关键字。 | 1 SharedList |
GetMediaAssociations | 从帐户的媒体库获取指定实体类型的媒体关联。 | 1 AccountId 100 MediaIds |
GetMediaMetaDataByAccountId | 从帐户的媒体库获取指定实体类型的媒体元数据。 | 不适用。 |
GetMediaMetaDataByIds | 从帐户的媒体库获取指定的媒体元数据。 | 100 MediaIds |
GetNegativeKeywordsByEntityIds | 获取直接分配给市场活动或广告组的负关键字。 | 1 ParentEntityId 1 EntityIds |
GetNegativeSitesByAdGroupIds | 获取直接分配给广告组的负网站 URL。 | 15 个 AdGroupIds 1 CampaignId |
GetNegativeSitesByCampaignIds | 获取直接分配给市场活动的负网站 URL。 | 1 AccountId 15 CampaignIds |
GetOfflineConversionReports | 获取所请求日期范围内的脱机转换报告。 | 不适用。 |
GetProfileDataFileUrl | 获取可用于下载行业或工作职能配置文件数据的临时 URL。 | 1 ProfileType |
GetSeasonalityAdjustmentsByAccountId | 获取与帐户关联的季节性调整。 | 不适用。 |
GetSeasonalityAdjustmentsByIds | 获取与帐户关联的指定季节性调整。 | 不适用。 |
GetSharedEntities | 获取负面关键字 (keyword) 列表或网站排除列表。 | 不适用。 |
GetSharedEntitiesByAccountId | 获取负关键字 (keyword) 列表。 | 不适用。 |
GetSharedEntityAssociationsByEntityIds | 按市场活动 ID 获取市场活动关联负关键字 (keyword) 列表,或按广告帐户 ID 获取网站排除列表到广告帐户关联。 | 100 EntityIds |
GetSharedEntityAssociationsBySharedEntityIds | 按负关键字 (keyword) 列表 ID 获取广告帐户关联的负面关键字 (keyword) 列表,或按网站排除列表 ID 获取广告帐户关联的网站排除列表。 | 1 个 SharedEntityIds |
GetUetTagsByIds | 获取指定的通用事件跟踪 (UET) 标记。 | 100 TagIds |
GetVideosByIds | 按视频标识符获取视频。 | 1,000 VideoIds |
RefineAssetGroupRecommendation | 优化资产组建议。 | 不适用。 |
RefineResponsiveAdRecommendation | 优化响应式广告建议。 | 不适用。 |
RefineResponsiveSearchAdRecommendation | 优化响应式搜索广告建议。 | 不适用。 |
SearchCompanies | 按公司名称搜索个人资料数据。 | 1 CompanyNameFilter |
SetAccountProperties | 按名称设置帐户级别属性。 | 不适用 |
SetAdExtensionsAssociations | 将指定的广告扩展插件与相应的市场活动或广告组相关联。 | 1 AccountId 100 AdExtensionIdToEntityIdAssociations |
SetAudienceGroupAssetGroupAssociations | 设置 AudienceGroupAssetGroupAssociations。 | 不适用。 |
SetLabelAssociations | 设置标签关联。 | 100 LabelAssociations |
SetNegativeSitesToAdGroups | 将负网站 URL 直接设置为广告组。 | 5,000 个 AdGroupNegativeSites 1 CampaignId |
SetNegativeSitesToCampaigns | 将负网站 URL 直接设置为市场活动。 | 1 AccountId 5,000 个 CampaignNegativeSites |
SetSharedEntityAssociations | 将负关键字 (keyword) 列表设置为市场活动关联,或将网站排除列表设置为广告帐户关联。 | 10,000 个关联 |
UpdateAdExtensions | 汇报帐户的广告扩展库中的一个或多个广告扩展。 | 1 AccountId 100 个 AdExtensions |
UpdateAdGroupCriterions | 汇报一个或多个广告组条件。 | 1 AccountId 1,000 个 AdGroupCriterions |
UpdateAdGroups | 汇报市场活动中的指定广告组。 | 1,000 个 AdGroups 1 CampaignId |
UpdateAds | 汇报广告组中的指定广告。 | 1 AdGroupId 50 个广告 |
UpdateAssetGroups | 汇报指定的资产组。 | 不适用。 |
UpdateAudienceGroups | 汇报指定的访问群体组。 | 不适用。 |
UpdateAudiences | 汇报指定的访问群体。 | 100 个受众 |
UpdateBidStrategies | 汇报帐户的项目组合出价策略库中的出价策略。 | 100 BidStrategies |
UpdateBudgets | 汇报帐户的共享预算库中的指定预算。 | 100 预算 |
UpdateCampaignCriterions | 汇报一个或多个市场活动条件。 | 100 CampaignCriterions |
UpdateCampaigns | 汇报指定帐户中的指定市场活动。 | 1 AccountId 100 个市场活动 |
UpdateConversionGoals | 汇报帐户的共享转换目标库中的转换目标。 | 100 ConversionGoals |
UpdateConversionValueRules | 更新现有转换值规则。 | 不适用。 |
UpdateConversionValueRulesStatus | 更新指定转换值规则的状态。 | 不适用。 |
UpdateDataExclusions | 对指定的数据排除项进行更新。 | 不适用。 |
UpdateExperiments | 汇报指定的试验。 | 100 个试验 |
UpdateImportJobs | 将指定的导入作业替换为新的导入作业。 | 1 个 ImportJobs |
UpdateKeywords | 汇报指定广告组中的关键字。 | 1 AdGroupId 1,000 个关键字 |
UpdateLabels | 汇报帐户中的标签。 | 100 个标签 |
UpdateSeasonalityAdjustments | 对指定的季节性调整进行更新。 | 不适用。 |
UpdateSharedEntities | 汇报负面关键字 (keyword) 列表或网站排除列表。 | 20 SharedEntities |
UpdateUetTags | 汇报指定的通用事件跟踪 (UET) 标记。 | 100 UetTags |
UpdateVideos | 汇报帐户中的视频。 | 100 个视频 |