// Copyright 2013 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 v201306;
import com.google.api.adwords.lib.AdWordsService;
import com.google.api.adwords.lib.AdWordsServiceLogger;
import com.google.api.adwords.lib.AdWordsUser;
import com.google.api.adwords.v201306.cm.AdGroupCriterion;
import com.google.api.adwords.v201306.cm.AdGroupCriterionOperation;
import com.google.api.adwords.v201306.cm.AdGroupCriterionReturnValue;
import com.google.api.adwords.v201306.cm.AdGroupCriterionServiceInterface;
import com.google.api.adwords.v201306.cm.AgeRange;
import com.google.api.adwords.v201306.cm.BiddableAdGroupCriterion;
import com.google.api.adwords.v201306.cm.Gender;
import com.google.api.adwords.v201306.cm.NegativeAdGroupCriterion;
import com.google.api.adwords.v201306.cm.Operator;
/**
* This example adds demographic target criteria to an ad group. To get ad groups, run
* AddAdGroup.java.
*
* Tags: AdGroupCriterionService.mutate
*
* @author thagikura@google.com (Takeshi Hagikura)
*/
public class AddAdGroupDemographicCriteria {
// Criterion Id for male. The IDs can be found here
// https://developers.google.com/adwords/api/docs/appendix/genders
private static final Long ID_FOR_MALE = 10L;
// Criterion Id for age 18 to 24. The IDs can be found here
// https://developers.google.com/adwords/api/docs/appendix/ages
private static final Long ID_FOR_18_TO_24 = 503001L;
public static void main(String[] args) {
try {
// Log SOAP XML request and response.
AdWordsServiceLogger.log();
// Get AdWordsUser from "~/adwords.properties".
AdWordsUser user = new AdWordsUser();
// Get the AdGroupCriterionService.
AdGroupCriterionServiceInterface adGroupCriterionService =
user.getService(AdWordsService.V201306.ADGROUP_CRITERION_SERVICE);
long adGroupId = Long.parseLong("INSERT_AD_GROUP_ID_HERE");
// Create biddable ad group criterion for gender
Gender genderTarget = new Gender();
genderTarget.setId(ID_FOR_MALE);
BiddableAdGroupCriterion genderBiddableAdGroupCriterion = new BiddableAdGroupCriterion();
genderBiddableAdGroupCriterion.setAdGroupId(adGroupId);
genderBiddableAdGroupCriterion.setCriterion(genderTarget);
// Create negative ad group criterion for age range
AgeRange ageRangeNegative = new AgeRange();
ageRangeNegative.setId(ID_FOR_18_TO_24);
NegativeAdGroupCriterion ageRangeNegativeAdGroupCriterion = new NegativeAdGroupCriterion();
ageRangeNegativeAdGroupCriterion.setAdGroupId(adGroupId);
ageRangeNegativeAdGroupCriterion.setCriterion(ageRangeNegative);
// Create operations.
AdGroupCriterionOperation genderBiddableAdGroupCriterionOperation =
new AdGroupCriterionOperation();
genderBiddableAdGroupCriterionOperation.setOperand(genderBiddableAdGroupCriterion);
genderBiddableAdGroupCriterionOperation.setOperator(Operator.ADD);
AdGroupCriterionOperation ageRangeNegativeAdGroupCriterionOperation =
new AdGroupCriterionOperation();
ageRangeNegativeAdGroupCriterionOperation.setOperand(ageRangeNegativeAdGroupCriterion);
ageRangeNegativeAdGroupCriterionOperation.setOperator(Operator.ADD);
AdGroupCriterionOperation[] operations = new AdGroupCriterionOperation[] {
genderBiddableAdGroupCriterionOperation, ageRangeNegativeAdGroupCriterionOperation};
// Add ad group criteria.
AdGroupCriterionReturnValue result = adGroupCriterionService.mutate(operations);
// Display ad group criteria.
if (result != null && result.getValue() != null) {
for (AdGroupCriterion adGroupCriterionResult : result.getValue()) {
System.out.println("Ad group criterion with ad group id \""
+ adGroupCriterionResult.getAdGroupId() + "\", criterion id \""
+ adGroupCriterionResult.getCriterion().getId() + "\", and type \""
+ adGroupCriterionResult.getCriterion().getCriterionType() + "\" was added.");
}
} else {
System.out.println("No ad group criteria were added.");
}
} catch (Exception e) {
e.printStackTrace();
}
}
}