UpdateCampaigns 服务操作 - 市场活动管理
汇报指定帐户中的指定市场活动。
请求元素
UpdateCampaignsRequest 对象定义服务操作请求的正文和标头元素。 元素的顺序必须与 请求 SOAP 中所示的顺序相同。
注意
除非下面另有说明,否则需要所有请求元素。
请求正文元素
元素 | 说明 | 数据类型 |
---|---|---|
AccountId | 包含要更新的活动的帐户的标识符。 | long |
活动 | 一个数组,最多可以包含 100 个要更新的 Campaign 对象。 | 市场活动 数组 |
请求标头元素
元素 | 说明 | 数据类型 |
---|---|---|
AuthenticationToken | OAuth 访问令牌,表示有权Microsoft广告帐户的用户的凭据。 有关详细信息,请参阅 使用 OAuth 进行身份验证。 |
string |
CustomerAccountId | 拥有或与请求中的实体关联的广告帐户的标识符。 如果需要这两个元素,此标头元素必须与 AccountId 正文元素具有相同的值。 此元素是大多数服务操作所必需的,作为最佳做法,应始终设置它。 有关详细信息,请参阅 获取帐户和客户 ID。 |
string |
CustomerId | 用户正在访问或操作的客户) 经理帐户 (标识符。 用户可以访问多个经理帐户。 此元素是大多数服务操作所必需的,作为最佳做法,应始终设置它。 有关详细信息,请参阅 获取帐户和客户 ID。 |
string |
DeveloperToken | 用于访问必应广告 API 的开发人员令牌。 有关详细信息,请参阅 获取开发人员令牌。 |
string |
Password | 此元素保留供内部使用,将从 API 的未来版本中删除。 必须使用 AuthenticationToken 元素来设置用户凭据。 | string |
UserName | 此元素保留供内部使用,将从 API 的未来版本中删除。 必须使用 AuthenticationToken 元素来设置用户凭据。 | string |
响应元素
UpdateCampaignsResponse 对象定义服务操作响应的正文和标头元素。 元素的返回顺序与 响应 SOAP 中所示的顺序相同。
响应正文元素
元素 | 说明 | 数据类型 |
---|---|---|
PartialErrors |
BatchError 对象的数组,其中包含未成功的任何请求项的详细信息。 错误列表与请求中的项列表不直接对应。 如果没有错误,列表可以为空,也可以包含与请求中每个不成功的列表项对应的一个或多个错误对象。 |
BatchError 数组 |
响应标头元素
元素 | 说明 | 数据类型 |
---|---|---|
跟踪 ID | 包含 API 调用详细信息的日志条目的标识符。 | string |
请求 SOAP
此模板由一个工具生成,用于显示 SOAP 请求的正文和标头元素的顺序。 有关可用于此服务操作的支持类型,请参阅上面的 请求正文元素 参考。
<s:Envelope xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
<Action mustUnderstand="1">UpdateCampaigns</Action>
<AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
<CustomerAccountId i:nil="false">ValueHere</CustomerAccountId>
<CustomerId i:nil="false">ValueHere</CustomerId>
<DeveloperToken i:nil="false">ValueHere</DeveloperToken>
</s:Header>
<s:Body>
<UpdateCampaignsRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
<AccountId>ValueHere</AccountId>
<Campaigns i:nil="false">
<Campaign>
<AudienceAdsBidAdjustment i:nil="false">ValueHere</AudienceAdsBidAdjustment>
<BiddingScheme i:nil="false" i:type="-- derived type specified here with the appropriate prefix --">
<Type i:nil="false">ValueHere</Type>
<!--This field is applicable if the derived type attribute is set to MaxClicksBiddingScheme-->
<MaxCpc i:nil="false">
<Amount i:nil="false">ValueHere</Amount>
</MaxCpc>
<!--These fields are applicable if the derived type attribute is set to MaxConversionsBiddingScheme-->
<MaxCpc i:nil="false">
<Amount i:nil="false">ValueHere</Amount>
</MaxCpc>
<TargetCpa i:nil="false">ValueHere</TargetCpa>
<!--These fields are applicable if the derived type attribute is set to TargetCpaBiddingScheme-->
<MaxCpc i:nil="false">
<Amount i:nil="false">ValueHere</Amount>
</MaxCpc>
<TargetCpa i:nil="false">ValueHere</TargetCpa>
<!--This field is applicable if the derived type attribute is set to ManualCpcBiddingScheme-->
<ManualCpc i:nil="false">ValueHere</ManualCpc>
<!--No additional fields are applicable if the derived type attribute is set to EnhancedCpcBiddingScheme-->
<!--No additional fields are applicable if the derived type attribute is set to ManualCpvBiddingScheme-->
<!--No additional fields are applicable if the derived type attribute is set to ManualCpmBiddingScheme-->
<!--This field is applicable if the derived type attribute is set to InheritFromParentBiddingScheme-->
<InheritedBidStrategyType i:nil="false">ValueHere</InheritedBidStrategyType>
<!--These fields are applicable if the derived type attribute is set to TargetRoasBiddingScheme-->
<MaxCpc i:nil="false">
<Amount i:nil="false">ValueHere</Amount>
</MaxCpc>
<TargetRoas i:nil="false">ValueHere</TargetRoas>
<!--This field is applicable if the derived type attribute is set to MaxRoasBiddingScheme-->
<MaxCpc i:nil="false">
<Amount i:nil="false">ValueHere</Amount>
</MaxCpc>
<!--This field is applicable if the derived type attribute is set to MaxConversionValueBiddingScheme-->
<TargetRoas i:nil="false">ValueHere</TargetRoas>
<!--These fields are applicable if the derived type attribute is set to TargetImpressionShareBiddingScheme-->
<MaxCpc i:nil="false">
<Amount i:nil="false">ValueHere</Amount>
</MaxCpc>
<TargetAdPosition i:nil="false">ValueHere</TargetAdPosition>
<TargetImpressionShare i:nil="false">ValueHere</TargetImpressionShare>
<!--This field is applicable if the derived type attribute is set to PercentCpcBiddingScheme-->
<MaxPercentCpc i:nil="false">ValueHere</MaxPercentCpc>
<!--This field is applicable if the derived type attribute is set to CommissionBiddingScheme-->
<CommissionRate i:nil="false">ValueHere</CommissionRate>
<!--This field is applicable if the derived type attribute is set to ManualCpaBiddingScheme-->
<ManualCpi i:nil="false">ValueHere</ManualCpi>
<!--This field is applicable if the derived type attribute is set to CostPerSaleBiddingScheme-->
<TargetCostPerSale i:nil="false">ValueHere</TargetCostPerSale>
</BiddingScheme>
<BudgetType i:nil="false">ValueHere</BudgetType>
<DailyBudget i:nil="false">ValueHere</DailyBudget>
<DealIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a1:long>ValueHere</a1:long>
</DealIds>
<EndDate i:nil="false">ValueHere</EndDate>
<ExperimentId i:nil="false">ValueHere</ExperimentId>
<FinalUrlSuffix i:nil="false">ValueHere</FinalUrlSuffix>
<ForwardCompatibilityMap xmlns:e579="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
<e579:KeyValuePairOfstringstring>
<e579:key i:nil="false">ValueHere</e579:key>
<e579:value i:nil="false">ValueHere</e579:value>
</e579:KeyValuePairOfstringstring>
</ForwardCompatibilityMap>
<GoalIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a1:long>ValueHere</a1:long>
</GoalIds>
<Id i:nil="false">ValueHere</Id>
<IsDealCampaign i:nil="false">ValueHere</IsDealCampaign>
<MultimediaAdsBidAdjustment i:nil="false">ValueHere</MultimediaAdsBidAdjustment>
<Name i:nil="false">ValueHere</Name>
<StartDate i:nil="false">ValueHere</StartDate>
<Status i:nil="false">ValueHere</Status>
<SubType i:nil="false">ValueHere</SubType>
<TimeZone i:nil="false">ValueHere</TimeZone>
<TrackingUrlTemplate i:nil="false">ValueHere</TrackingUrlTemplate>
<UrlCustomParameters i:nil="false">
<Parameters i:nil="false">
<CustomParameter>
<Key i:nil="false">ValueHere</Key>
<Value i:nil="false">ValueHere</Value>
</CustomParameter>
</Parameters>
</UrlCustomParameters>
<UseCampaignLevelDates i:nil="false">ValueHere</UseCampaignLevelDates>
<CampaignType i:nil="false">ValueHere</CampaignType>
<Settings i:nil="false">
<Setting i:type="-- derived type specified here with the appropriate prefix --">
<Type i:nil="false">ValueHere</Type>
<!--This field is applicable if the derived type attribute is set to VerifiedTrackingSetting-->
<Details xmlns:e580="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
<e580:ArrayOfKeyValuePairOfstringstring>
<e580:KeyValuePairOfstringstring>
<e580:key i:nil="false">ValueHere</e580:key>
<e580:value i:nil="false">ValueHere</e580:value>
</e580:KeyValuePairOfstringstring>
</e580:ArrayOfKeyValuePairOfstringstring>
</Details>
<!--These fields are applicable if the derived type attribute is set to ShoppingSetting-->
<FeedLabel i:nil="false">ValueHere</FeedLabel>
<LocalInventoryAdsEnabled i:nil="false">ValueHere</LocalInventoryAdsEnabled>
<Priority i:nil="false">ValueHere</Priority>
<SalesCountryCode i:nil="false">ValueHere</SalesCountryCode>
<ShoppableAdsEnabled i:nil="false">ValueHere</ShoppableAdsEnabled>
<StoreId i:nil="false">ValueHere</StoreId>
<!--This field is applicable if the derived type attribute is set to DynamicFeedSetting-->
<FeedId i:nil="false">ValueHere</FeedId>
<!--These fields are applicable if the derived type attribute is set to DynamicSearchAdsSetting-->
<DomainName i:nil="false">ValueHere</DomainName>
<DynamicDescriptionEnabled i:nil="false">ValueHere</DynamicDescriptionEnabled>
<Language i:nil="false">ValueHere</Language>
<PageFeedIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a1:long>ValueHere</a1:long>
</PageFeedIds>
<Source i:nil="false">ValueHere</Source>
<!--This field is applicable if the derived type attribute is set to TargetSetting-->
<Details i:nil="false">
<TargetSettingDetail>
<CriterionTypeGroup>ValueHere</CriterionTypeGroup>
<TargetAndBid>ValueHere</TargetAndBid>
</TargetSettingDetail>
</Details>
<!--These fields are applicable if the derived type attribute is set to CoOpSetting-->
<BidBoostValue i:nil="false">ValueHere</BidBoostValue>
<BidMaxValue i:nil="false">ValueHere</BidMaxValue>
<BidOption i:nil="false">ValueHere</BidOption>
<!--This field is applicable if the derived type attribute is set to DisclaimerSetting-->
<DisclaimerAdsEnabled>ValueHere</DisclaimerAdsEnabled>
<!--This field is applicable if the derived type attribute is set to HotelSetting-->
<HotelAdGroupType>ValueHere</HotelAdGroupType>
<!--This field is applicable if the derived type attribute is set to ResponsiveSearchAdsSetting-->
<AutoGeneratedAssetsEnabled i:nil="false">ValueHere</AutoGeneratedAssetsEnabled>
<!--These fields are applicable if the derived type attribute is set to PerformanceMaxSetting-->
<AutoGeneratedImageOptOut i:nil="false">ValueHere</AutoGeneratedImageOptOut>
<AutoGeneratedTextOptOut i:nil="false">ValueHere</AutoGeneratedTextOptOut>
<CostPerSaleOptOut i:nil="false">ValueHere</CostPerSaleOptOut>
<FinalUrlExpansionOptOut>ValueHere</FinalUrlExpansionOptOut>
<PageFeedIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a1:long>ValueHere</a1:long>
</PageFeedIds>
<!--These fields are applicable if the derived type attribute is set to CallToActionSetting-->
<AutomatedCallToActionOptOut i:nil="false">ValueHere</AutomatedCallToActionOptOut>
<CallToActionOptOut i:nil="false">ValueHere</CallToActionOptOut>
<!--These fields are applicable if the derived type attribute is set to VanityPharmaSetting-->
<DisplayUrlMode i:nil="false">ValueHere</DisplayUrlMode>
<WebsiteDescription i:nil="false">ValueHere</WebsiteDescription>
<!--These fields are applicable if the derived type attribute is set to AppSetting-->
<AppId i:nil="false">ValueHere</AppId>
<AppStore>ValueHere</AppStore>
<!--This field is applicable if the derived type attribute is set to ThirdPartyMeasurementSetting-->
<Details xmlns:e581="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
<e581:ArrayOfKeyValuePairOfstringstring>
<e581:KeyValuePairOfstringstring>
<e581:key i:nil="false">ValueHere</e581:key>
<e581:value i:nil="false">ValueHere</e581:value>
</e581:KeyValuePairOfstringstring>
</e581:ArrayOfKeyValuePairOfstringstring>
</Details>
<!--These fields are applicable if the derived type attribute is set to NewCustomerAcquisitionGoalSetting-->
<AdditionalConversionValue i:nil="false">ValueHere</AdditionalConversionValue>
<NewCustomerAcquisitionBidOnlyMode i:nil="false">ValueHere</NewCustomerAcquisitionBidOnlyMode>
<NewCustomerAcquisitionGoalId i:nil="false">ValueHere</NewCustomerAcquisitionGoalId>
</Setting>
</Settings>
<BudgetId i:nil="false">ValueHere</BudgetId>
<Languages i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a1:string>ValueHere</a1:string>
</Languages>
<AdScheduleUseSearcherTimeZone i:nil="false">ValueHere</AdScheduleUseSearcherTimeZone>
<BidStrategyId i:nil="false">ValueHere</BidStrategyId>
</Campaign>
</Campaigns>
</UpdateCampaignsRequest>
</s:Body>
</s:Envelope>
响应 SOAP
此模板由一个工具生成,用于显示 SOAP 响应的 正文 和 标头 元素的顺序。
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
<TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
</s:Header>
<s:Body>
<UpdateCampaignsResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
<PartialErrors d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
<BatchError d4p1:type="-- derived type specified here with the appropriate prefix --">
<Code>ValueHere</Code>
<Details d4p1:nil="false">ValueHere</Details>
<ErrorCode d4p1:nil="false">ValueHere</ErrorCode>
<FieldPath d4p1:nil="false">ValueHere</FieldPath>
<ForwardCompatibilityMap xmlns:e582="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
<e582:KeyValuePairOfstringstring>
<e582:key d4p1:nil="false">ValueHere</e582:key>
<e582:value d4p1:nil="false">ValueHere</e582:value>
</e582:KeyValuePairOfstringstring>
</ForwardCompatibilityMap>
<Index>ValueHere</Index>
<Message d4p1:nil="false">ValueHere</Message>
<Type d4p1:nil="false">ValueHere</Type>
<!--These fields are applicable if the derived type attribute is set to EditorialError-->
<Appealable d4p1:nil="false">ValueHere</Appealable>
<DisapprovedText d4p1:nil="false">ValueHere</DisapprovedText>
<Location d4p1:nil="false">ValueHere</Location>
<PublisherCountry d4p1:nil="false">ValueHere</PublisherCountry>
<ReasonCode>ValueHere</ReasonCode>
</BatchError>
</PartialErrors>
</UpdateCampaignsResponse>
</s:Body>
</s:Envelope>
代码语法
示例语法可用于 必应广告 SDK。 有关更多示例,请参阅 必应广告 API 代码示例 。
public async Task<UpdateCampaignsResponse> UpdateCampaignsAsync(
long accountId,
IList<Campaign> campaigns)
{
var request = new UpdateCampaignsRequest
{
AccountId = accountId,
Campaigns = campaigns
};
return (await CampaignManagementService.CallAsync((s, r) => s.UpdateCampaignsAsync(r), request));
}
static UpdateCampaignsResponse updateCampaigns(
java.lang.Long accountId,
ArrayOfCampaign campaigns) throws RemoteException, Exception
{
UpdateCampaignsRequest request = new UpdateCampaignsRequest();
request.setAccountId(accountId);
request.setCampaigns(campaigns);
return CampaignManagementService.getService().updateCampaigns(request);
}
static function UpdateCampaigns(
$accountId,
$campaigns)
{
$GLOBALS['Proxy'] = $GLOBALS['CampaignManagementProxy'];
$request = new UpdateCampaignsRequest();
$request->AccountId = $accountId;
$request->Campaigns = $campaigns;
return $GLOBALS['CampaignManagementProxy']->GetService()->UpdateCampaigns($request);
}
response=campaignmanagement_service.UpdateCampaigns(
AccountId=AccountId,
Campaigns=Campaigns)
要求
服务: CampaignManagementService.svc v13
命名空间: https://bingads.microsoft.com/CampaignManagement/v13
请求 URL
请求元素
UpdateCampaignsRequest 对象定义服务操作请求的正文和标头元素。
注意
除非下面另有说明,否则需要所有请求元素。
请求正文元素
元素 | 说明 | 数据类型 |
---|---|---|
AccountId | 包含要更新的活动的帐户的标识符。 | long |
活动 | 一个数组,最多可以包含 100 个要更新的 Campaign 对象。 | 市场活动 数组 |
请求标头元素
元素 | 说明 | 数据类型 |
---|---|---|
Authorization | OAuth 访问令牌,表示有权Microsoft广告帐户的用户的凭据。 请确保令牌的前缀为“持有者”,这是正确身份验证所必需的。 有关详细信息,请参阅 使用 OAuth 进行身份验证。 |
string |
CustomerAccountId | 拥有或与请求中的实体关联的广告帐户的标识符。 如果需要这两个元素,此标头元素必须与 AccountId 正文元素具有相同的值。 此元素是大多数服务操作所必需的,作为最佳做法,应始终设置它。 有关详细信息,请参阅 获取帐户和客户 ID。 |
string |
CustomerId | 用户正在访问或操作的客户) 经理帐户 (标识符。 用户可以访问多个经理帐户。 此元素是大多数服务操作所必需的,作为最佳做法,应始终设置它。 有关详细信息,请参阅 获取帐户和客户 ID。 |
string |
DeveloperToken | 用于访问必应广告 API 的开发人员令牌。 有关详细信息,请参阅 获取开发人员令牌。 |
string |
Password | 此元素保留供内部使用,将从 API 的未来版本中删除。 必须使用 AuthenticationToken 元素来设置用户凭据。 | string |
UserName | 此元素保留供内部使用,将从 API 的未来版本中删除。 必须使用 AuthenticationToken 元素来设置用户凭据。 | string |
响应元素
UpdateCampaignsResponse 对象定义服务操作响应的正文和标头元素。 元素的返回顺序与 响应 JSON 中所示的顺序相同。
响应正文元素
元素 | 说明 | 数据类型 |
---|---|---|
PartialErrors |
BatchError 对象的数组,其中包含未成功的任何请求项的详细信息。 错误列表与请求中的项列表不直接对应。 如果没有错误,列表可以为空,也可以包含与请求中每个不成功的列表项对应的一个或多个错误对象。 |
BatchError 数组 |
响应标头元素
元素 | 说明 | 数据类型 |
---|---|---|
跟踪 ID | 包含 API 调用详细信息的日志条目的标识符。 | string |
请求 JSON
此模板由显示 JSON 请求的 正文 和 标头 元素的工具生成。 有关可用于此服务操作的支持类型,请参阅上面的 请求正文元素 参考。
下面是一个示例,如果 BiddingScheme 的类型为 CommissionBiddingScheme, 设置 为 AppSetting,则适用。
{
"AccountId": "LongValueHere",
"Campaigns": [
{
"AdScheduleUseSearcherTimeZone": "ValueHere",
"AudienceAdsBidAdjustment": IntValueHere,
"BiddingScheme": {
"Type": "CommissionBiddingScheme",
"CommissionRate": DoubleValueHere
},
"BidStrategyId": "LongValueHere",
"BudgetId": "LongValueHere",
"BudgetType": "ValueHere",
"CampaignType": "ValueHere",
"DailyBudget": DoubleValueHere,
"DealIds": [
"LongValueHere"
],
"EndDate": "ValueHere",
"ExperimentId": "LongValueHere",
"FinalUrlSuffix": "ValueHere",
"ForwardCompatibilityMap": [
{
"key": "ValueHere",
"value": "ValueHere"
}
],
"GoalIds": [
"LongValueHere"
],
"Id": "LongValueHere",
"IsDealCampaign": "ValueHere",
"Languages": [
"ValueHere"
],
"MultimediaAdsBidAdjustment": IntValueHere,
"Name": "ValueHere",
"Settings": [
{
"Type": "AppSetting",
"AppId": "ValueHere",
"AppStore": "ValueHere"
}
],
"StartDate": "ValueHere",
"Status": "ValueHere",
"SubType": "ValueHere",
"TimeZone": "ValueHere",
"TrackingUrlTemplate": "ValueHere",
"UrlCustomParameters": {
"Parameters": [
{
"Key": "ValueHere",
"Value": "ValueHere"
}
]
},
"UseCampaignLevelDates": "ValueHere"
}
]
}
响应 JSON
此模板由一个工具生成,用于显示 JSON 响应的 正文 和 标头 元素。
以下示例适用于 BatchError 的类型为 EditorialError。
{
"PartialErrors": [
{
"Code": IntValueHere,
"Details": "ValueHere",
"ErrorCode": "ValueHere",
"FieldPath": "ValueHere",
"ForwardCompatibilityMap": [
{
"key": "ValueHere",
"value": "ValueHere"
}
],
"Index": IntValueHere,
"Message": "ValueHere",
"Type": "EditorialError",
"Appealable": "ValueHere",
"DisapprovedText": "ValueHere",
"Location": "ValueHere",
"PublisherCountry": "ValueHere",
"ReasonCode": IntValueHere
}
]
}
代码语法
若要通过 SDK 调用 REST API,需要将 SDK 升级到特定版本并配置系统参数。示例语法可用于 必应广告 SDK。 有关更多示例,请参阅 必应广告 API 代码示例 。
public async Task<UpdateCampaignsResponse> UpdateCampaignsAsync(
long accountId,
IList<Campaign> campaigns)
{
var request = new UpdateCampaignsRequest
{
AccountId = accountId,
Campaigns = campaigns
};
return (await CampaignManagementService.CallAsync((s, r) => s.UpdateCampaignsAsync(r), request));
}
static UpdateCampaignsResponse updateCampaigns(
java.lang.Long accountId,
ArrayOfCampaign campaigns) throws RemoteException, Exception
{
UpdateCampaignsRequest request = new UpdateCampaignsRequest();
request.setAccountId(accountId);
request.setCampaigns(campaigns);
return CampaignManagementService.getService().updateCampaigns(request);
}
static function UpdateCampaigns(
$accountId,
$campaigns)
{
$GLOBALS['Proxy'] = $GLOBALS['CampaignManagementProxy'];
$request = new UpdateCampaignsRequest();
$request->AccountId = $accountId;
$request->Campaigns = $campaigns;
return $GLOBALS['CampaignManagementProxy']->GetService()->UpdateCampaigns($request);
}
response=campaignmanagement_service.UpdateCampaigns(
AccountId=AccountId,
Campaigns=Campaigns)