Changes for release v0_2 (#13)

- Regenerate from the latest protos.
- Updates to Hotel Ads examples for PercentCpc bidding strategy.

Author: jradcliff

google-ads-examples/pom.xml

@@ -55,7 +55,7 @@
     <dependency>
       <groupId>com.google.api-ads</groupId>
       <artifactId>google-ads</artifactId>
-      <version>0.2.0</version>
+      <version>0.2.1-SNAPSHOT</version>
     </dependency>
     <dependency>
       <groupId>com.beust</groupId>

google-ads-examples/src/main/java/com/google/ads/googleads/examples/hotelads/AddHotelAd.java

@@ -21,7 +21,7 @@
 import com.google.ads.googleads.lib.GoogleAdsException;
 import com.google.ads.googleads.v0.common.Ad;
 import com.google.ads.googleads.v0.common.HotelAdInfo;
-import com.google.ads.googleads.v0.common.ManualCpc;
+import com.google.ads.googleads.v0.common.PercentCpc;
 import com.google.ads.googleads.v0.enums.AdGroupAdStatusEnum.AdGroupAdStatus;
 import com.google.ads.googleads.v0.enums.AdGroupStatusEnum.AdGroupStatus;
 import com.google.ads.googleads.v0.enums.AdGroupTypeEnum.AdGroupType;
@@ -72,6 +72,9 @@ private static class AddHotelAdParams extends CodeSampleParams {
 
     @Parameter(names = ArgumentNames.HOTEL_CENTER_ACCOUNT_ID, required = true)
     private Long hotelCenterAccountId;
+
+    @Parameter(names = ArgumentNames.CPC_BID_CEILING_MICRO_AMOUNT)
+    private Long cpcBidCeilingMicroAmount = 20_000_000L;
   }
 
   public static void main(String[] args) {
@@ -82,6 +85,7 @@ public static void main(String[] args) {
       // into the code here. See the parameter class definition above for descriptions.
       params.customerId = Long.parseLong("INSERT_CUSTOMER_ID_HERE");
       params.hotelCenterAccountId = Long.parseLong("INSERT_HOTEL_CENTER_ACCOUNT_ID_HERE");
+      params.cpcBidCeilingMicroAmount = Long.parseLong("INSERT_CPC_BID_CEILING_MICRO_AMOUNT_HERE");
     }
 
     GoogleAdsClient googleAdsClient;
@@ -97,7 +101,12 @@ public static void main(String[] args) {
     }
 
     try {
-      new AddHotelAd().runExample(googleAdsClient, params.customerId, params.hotelCenterAccountId);
+      new AddHotelAd()
+          .runExample(
+              googleAdsClient,
+              params.customerId,
+              params.hotelCenterAccountId,
+              params.cpcBidCeilingMicroAmount);
     } catch (GoogleAdsException gae) {
       // GoogleAdsException is the base class for most exceptions thrown by an API request.
       // Instances of this exception have a message and a GoogleAdsFailure that contains a
@@ -119,17 +128,27 @@ public static void main(String[] args) {
    * @param googleAdsClient the Google Ads API client.
    * @param customerId the client customer ID.
    * @param hotelCenterAccountId the Hotel Center account ID.
+   * @param cpcBidCeilingMicroAmount the maximum bid limit that can be set when creating a campaign
+   *     using the Percent CPC bidding strategy.
    * @throws GoogleAdsException if an API request failed with one or more service errors.
    */
   private void runExample(
-      GoogleAdsClient googleAdsClient, long customerId, long hotelCenterAccountId) {
+      GoogleAdsClient googleAdsClient,
+      long customerId,
+      long hotelCenterAccountId,
+      long cpcBidCeilingMicroAmount) {
 
     // Creates a budget to be used by the campaign that will be created below.
     String budgetResourceName = addCampaignBudget(googleAdsClient, customerId);
 
     // Creates a hotel campaign.
     String campaignResourceName =
-        addHotelCampaign(googleAdsClient, customerId, budgetResourceName, hotelCenterAccountId);
+        addHotelCampaign(
+            googleAdsClient,
+            customerId,
+            budgetResourceName,
+            hotelCenterAccountId,
+            cpcBidCeilingMicroAmount);
 
     // Creates a hotel ad group.
     String adGroupResourceName = addHotelAdGroup(googleAdsClient, customerId, campaignResourceName);
@@ -174,14 +193,17 @@ private String addCampaignBudget(GoogleAdsClient googleAdsClient, long customerI
    * @param customerId the client customer ID.
    * @param budgetResourceName the resource name of the budget for the campaign.
    * @param hotelCenterAccountId the Hotel Center account ID.
+   * @param cpcBidCeilingMicroAmount the maximum bid limit that can be set when creating a campaign
+   *     using the Percent CPC bidding strategy.
    * @return resource name of the newly created campaign.
    * @throws GoogleAdsException if an API request failed with one or more service errors.
    */
   private String addHotelCampaign(
       GoogleAdsClient googleAdsClient,
       long customerId,
       String budgetResourceName,
-      long hotelCenterAccountId) {
+      long hotelCenterAccountId,
+      long cpcBidCeilingMicroAmount) {
 
     // Configures the hotel settings.
     HotelSettingInfo hotelSettingInfo =
@@ -204,8 +226,12 @@ private String addHotelCampaign(
             // the ads from immediately serving. Set to ENABLED once you've added
             // targeting and the ads are ready to serve
             .setStatus(CampaignStatus.PAUSED)
-            // Sets the bidding strategy. Only Manual CPC can be used for hotel campaigns.
-            .setManualCpc(ManualCpc.newBuilder().build())
+            // Sets the bidding strategy to Percent CPC. Only Manual CPC and Percent CPC can be used
+            // for hotel campaigns.
+            .setPercentCpc(
+                PercentCpc.newBuilder()
+                    .setCpcBidCeilingMicros(Int64Value.of(cpcBidCeilingMicroAmount))
+                    .build())
             // Sets the budget.
             .setCampaignBudget(StringValue.of(budgetResourceName))
             // Adds the networkSettings configured above.

google-ads-examples/src/main/java/com/google/ads/googleads/examples/utils/ArgumentNames.java

@@ -23,6 +23,7 @@ public final class ArgumentNames {
   public static final String CRITERION_ID = "--criterionId";
   public static final String CAMPAIGN_BUDGET_ID = "--campaignBudgetId";
   public static final String CPC_BID_MICRO_AMOUNT = "--cpcBidMicroAmount";
+  public static final String CPC_BID_CEILING_MICRO_AMOUNT = "--cpcBidCeilingMicroAmount";
   public static final String ARTIFACT_NAME = "--artifactName";
   public static final String KEYWORD_TEXT = "--keywordText";
   public static final String RECOMMENDATION_ID = "--recommendationId";