If an adCenter API error occurs, a FaultException exception is thrown that contains an EditorialApiFaultDetail object. It contains the appropriate error information. For more information about fault detail objects, see Microsoft adCenter API Error Handling. For a list of campaign-management–specific error codes, see Campaign Management Error Codes. For a list of generic error codes, see Common Error Codes.

Message Contract Return Value

Set the properties of the Keyword objects in the keywords array to the new values, and then set all the properties to null that should not be updated.

The ExactMatchBid, BroadMatchBid, PhraseMatchBid, ContentMatchBid, and NegativeKeywords elements can be changed without causing the keyword to go through the editorial validation process. However, any change to the Param1, Param2, or Param3 element causes the keyword to go through the editorial validation process.

To update only the bid amounts for a keyword, set the Keyword.ExactMatchBid, Keyword.BroadMatchBid, Keyword.PhraseMatchBid, and/or Keyword.ContentMatchBid properties to the new bid amounts. If there are bids that should not be updated, set their corresponding properties to null.

To remove an existing bid match type, set the corresponding bid amount property to zero (not null), and then call the UpdateKeywords service operation. For example, to remove the phrase match type, set Keyword.PhraseMatchBid to zero, and then call the UpdateKeywords service operation.

Because this service operation accepts an array for an argument, we recommend that you read the Quotas in Microsoft adCenter topic before you use this service operation. Arrays can consume a large percentage of your allocated quota.

WSDL: CampaignManagement.svc in version 5.1.

Concepts