Rev 9005 | Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | RSS feed
// Copyright 2012 Google Inc. All Rights Reserved.//// Licensed under the Apache License, Version 2.0 (the "License");// you may not use this file except in compliance with the License.// You may obtain a copy of the License at//// http://www.apache.org/licenses/LICENSE-2.0//// Unless required by applicable law or agreed to in writing, software// distributed under the License is distributed on an "AS IS" BASIS,// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.// See the License for the specific language governing permissions and// limitations under the License.package adwords.axis.v201309.basicoperations;import com.google.api.ads.adwords.axis.factory.AdWordsServices;import com.google.api.ads.adwords.axis.v201309.cm.AdGroupCriterion;import com.google.api.ads.adwords.axis.v201309.cm.AdGroupCriterionOperation;import com.google.api.ads.adwords.axis.v201309.cm.AdGroupCriterionReturnValue;import com.google.api.ads.adwords.axis.v201309.cm.AdGroupCriterionServiceInterface;import com.google.api.ads.adwords.axis.v201309.cm.BiddableAdGroupCriterion;import com.google.api.ads.adwords.axis.v201309.cm.BiddingStrategyConfiguration;import com.google.api.ads.adwords.axis.v201309.cm.Bids;import com.google.api.ads.adwords.axis.v201309.cm.CpcBid;import com.google.api.ads.adwords.axis.v201309.cm.Criterion;import com.google.api.ads.adwords.axis.v201309.cm.Keyword;import com.google.api.ads.adwords.axis.v201309.cm.KeywordMatchType;import com.google.api.ads.adwords.axis.v201309.cm.Money;import com.google.api.ads.adwords.axis.v201309.cm.Operator;import com.google.api.ads.adwords.lib.client.AdWordsSession;import com.google.api.ads.common.lib.auth.OfflineCredentials;import com.google.api.ads.common.lib.auth.OfflineCredentials.Api;import com.google.api.client.auth.oauth2.Credential;/*** This example updates the bid of a keyword. To add a keyword, run* AddKeywords.java.** Credentials and properties in {@code fromFile()} are pulled from the* "ads.properties" file. See README for more info.** Tags: AdGroupCriterionService.mutate** Category: adx-exclude** @author Kevin Winter*/public class UpdateKeyword {public static Long runExample(Long adGroupId, Long keywordId, String text, Long bidAmount, String type)throws Exception {// Generate a refreshable OAuth2 credential similar to a ClientLogin token// and can be used in place of a service account.Credential oAuth2Credential = new OfflineCredentials.Builder().forApi(Api.ADWORDS).fromFile().build().generateCredential();// Construct an AdWordsSession.AdWordsSession session = new AdWordsSession.Builder().fromFile().withOAuth2Credential(oAuth2Credential).build();AdWordsServices adWordsServices = new AdWordsServices();// Get the AdGroupCriterionService.AdGroupCriterionServiceInterface adGroupCriterionService =adWordsServices.get(session, AdGroupCriterionServiceInterface.class);Keyword keyword = new Keyword();if(text!=null && ("").equalsIgnoreCase(text)){keyword.setText(text);}if(type!=null && ("").equalsIgnoreCase(type)){keyword.setMatchType(KeywordMatchType.fromString(type));}keyword.setId(keywordId);// Create ad group criterion with updated bid./*Criterion criterion = new Criterion();criterion.setId(keywordId);*/BiddableAdGroupCriterion biddableAdGroupCriterion = new BiddableAdGroupCriterion();biddableAdGroupCriterion.setAdGroupId(adGroupId);biddableAdGroupCriterion.setCriterion(keyword);if(bidAmount > -1l){// Create bids.BiddingStrategyConfiguration biddingStrategyConfiguration = new BiddingStrategyConfiguration();CpcBid bid = new CpcBid();bid.setBid(new Money(null, bidAmount));biddingStrategyConfiguration.setBids(new Bids[] {bid});biddableAdGroupCriterion.setBiddingStrategyConfiguration(biddingStrategyConfiguration);}// Create operations.AdGroupCriterionOperation operation = new AdGroupCriterionOperation();operation.setOperand(biddableAdGroupCriterion);operation.setOperator(Operator.SET);AdGroupCriterionOperation[] operations = new AdGroupCriterionOperation[] {operation};if((text!=null && ("").equalsIgnoreCase(text)) || (type!=null && ("").equalsIgnoreCase(type)) || (bidAmount > -1l)){// Update ad group criteria.AdGroupCriterionReturnValue result = adGroupCriterionService.mutate(operations);Long criterionId = 0l;// Display ad group criteria.for (AdGroupCriterion adGroupCriterionResult : result.getValue()) {if (adGroupCriterionResult instanceof BiddableAdGroupCriterion) {biddableAdGroupCriterion = (BiddableAdGroupCriterion) adGroupCriterionResult;System.out.println("Ad group criterion with ad group id \""+ biddableAdGroupCriterion.getAdGroupId() + "\", criterion id \""+ biddableAdGroupCriterion.getCriterion().getId() + "\", type \""+ biddableAdGroupCriterion.getCriterion().getCriterionType()+ "\", and bid \""+ ((CpcBid) biddableAdGroupCriterion.getBiddingStrategyConfiguration().getBids()[0]).getBid().getMicroAmount() + "\" was updated.");criterionId = biddableAdGroupCriterion.getCriterion().getId();}}return criterionId;}return 0l;}}