Thêm chiến dịch Tối đa hoá hiệu suất cho các mục tiêu trong ngành du lịch

// Copyright 2023 Google LLC
//
// 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
//
//     https://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 com.google.ads.googleads.examples.travel;

import static com.google.ads.googleads.examples.utils.CodeSampleHelper.getPrintableDateTime;

import com.beust.jcommander.Parameter;
import com.google.ads.googleads.examples.utils.ArgumentNames;
import com.google.ads.googleads.examples.utils.CodeSampleHelper;
import com.google.ads.googleads.examples.utils.CodeSampleParams;
import com.google.ads.googleads.lib.GoogleAdsClient;
import com.google.ads.googleads.v17.common.CallToActionAsset;
import com.google.ads.googleads.v17.common.HotelPropertyAsset;
import com.google.ads.googleads.v17.common.ImageAsset;
import com.google.ads.googleads.v17.common.MaximizeConversionValue;
import com.google.ads.googleads.v17.common.TextAsset;
import com.google.ads.googleads.v17.enums.AdvertisingChannelTypeEnum.AdvertisingChannelType;
import com.google.ads.googleads.v17.enums.AssetFieldTypeEnum.AssetFieldType;
import com.google.ads.googleads.v17.enums.AssetGroupStatusEnum.AssetGroupStatus;
import com.google.ads.googleads.v17.enums.AssetSetTypeEnum.AssetSetType;
import com.google.ads.googleads.v17.enums.BudgetDeliveryMethodEnum.BudgetDeliveryMethod;
import com.google.ads.googleads.v17.enums.CampaignStatusEnum.CampaignStatus;
import com.google.ads.googleads.v17.enums.HotelAssetSuggestionStatusEnum.HotelAssetSuggestionStatus;
import com.google.ads.googleads.v17.errors.GoogleAdsError;
import com.google.ads.googleads.v17.errors.GoogleAdsException;
import com.google.ads.googleads.v17.resources.Asset;
import com.google.ads.googleads.v17.resources.AssetGroup;
import com.google.ads.googleads.v17.resources.AssetGroupAsset;
import com.google.ads.googleads.v17.resources.AssetSet;
import com.google.ads.googleads.v17.resources.AssetSetAsset;
import com.google.ads.googleads.v17.resources.Campaign;
import com.google.ads.googleads.v17.resources.CampaignBudget;
import com.google.ads.googleads.v17.services.AssetGroupAssetOperation;
import com.google.ads.googleads.v17.services.AssetGroupOperation;
import com.google.ads.googleads.v17.services.AssetOperation;
import com.google.ads.googleads.v17.services.AssetSetAssetOperation;
import com.google.ads.googleads.v17.services.AssetSetOperation;
import com.google.ads.googleads.v17.services.AssetSetServiceClient;
import com.google.ads.googleads.v17.services.CampaignBudgetOperation;
import com.google.ads.googleads.v17.services.CampaignOperation;
import com.google.ads.googleads.v17.services.GoogleAdsServiceClient;
import com.google.ads.googleads.v17.services.HotelAssetSuggestion;
import com.google.ads.googleads.v17.services.HotelImageAsset;
import com.google.ads.googleads.v17.services.HotelTextAsset;
import com.google.ads.googleads.v17.services.MutateAssetSetsResponse;
import com.google.ads.googleads.v17.services.MutateGoogleAdsResponse;
import com.google.ads.googleads.v17.services.MutateOperation;
import com.google.ads.googleads.v17.services.MutateOperationResponse;
import com.google.ads.googleads.v17.services.MutateOperationResponse.ResponseCase;
import com.google.ads.googleads.v17.services.SuggestTravelAssetsRequest;
import com.google.ads.googleads.v17.services.SuggestTravelAssetsResponse;
import com.google.ads.googleads.v17.services.TravelAssetSuggestionServiceClient;
import com.google.ads.googleads.v17.utils.ResourceNames;
import com.google.common.collect.ImmutableList;
import com.google.common.collect.ImmutableMap;
import com.google.common.io.ByteStreams;
import com.google.protobuf.ByteString;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.net.URL;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.Map.Entry;
import java.util.stream.Collectors;
import org.joda.time.DateTime;

/**
 * This example shows how to create a Performance Max for travel goals campaign. It also uses
 * TravelAssetSuggestionService to fetch suggested assets for creating an asset group. In case there
 * are not enough assets for the asset group (required by Performance Max), this example will create
 * more assets to fulfill the requirements.
 *
 * <p>For more information about Performance Max campaigns, see
 * https://developers.google.com/google-ads/api/docs/performance-max/overview.
 *
 * <p>Prerequisites:
 *
 * <ul>
 *   <li>You must have at least one conversion action in the account. For more about conversion
 *       actions, see
 *       https://developers.google.com/google-ads/api/docs/conversions/overview#conversion_actions.
 * </ul>
 *
 * <p>Notes:
 *
 * <ul>
 *   <li>This example uses the default customer conversion goals. For an example of setting
 *       campaign-specific conversion goals, see {@link
 *       com.google.ads.googleads.examples.shoppingads.AddPerformanceMaxRetailCampaign}.
 *   <li>To learn how to create asset group signals, see {@link
 *       com.google.ads.googleads.examples.advancedoperations.AddPerformanceMaxCampaign}.
 * </ul>
 */
public class AddPerformanceMaxForTravelGoalsCampaign {

  // Minimum requirements of assets required in a Performance Max asset group.
  // See https://developers.google.com/google-ads/api/docs/performance-max/assets for details.
  private static Map<AssetFieldType, Integer> MIN_REQUIRED_TEXT_ASSET_COUNTS =
      ImmutableMap.<AssetFieldType, Integer>builder()
          .put(AssetFieldType.HEADLINE, 3)
          .put(AssetFieldType.LONG_HEADLINE, 1)
          .put(AssetFieldType.DESCRIPTION, 2)
          .put(AssetFieldType.BUSINESS_NAME, 1)
          .build();

  private static Map<AssetFieldType, Integer> MIN_REQUIRED_IMAGE_ASSET_COUNTS =
      ImmutableMap.<AssetFieldType, Integer>builder()
          .put(AssetFieldType.MARKETING_IMAGE, 1)
          .put(AssetFieldType.SQUARE_MARKETING_IMAGE, 1)
          .put(AssetFieldType.LOGO, 1)
          .build();

  // Texts and URLs used to create text and image assets when the TravelAssetSuggestionService
  // doesn't return enough assets required for creating an asset group.
  private static Map<AssetFieldType, List<String>> DEFAULT_TEXT_ASSETS_INFO =
      ImmutableMap.<AssetFieldType, List<String>>builder()
          .put(AssetFieldType.HEADLINE, ImmutableList.of("Hotel", "Travel Reviews", "Book travel"))
          .put(AssetFieldType.LONG_HEADLINE, ImmutableList.of("Travel the World"))
          .put(
              AssetFieldType.DESCRIPTION,
              ImmutableList.of("Great deal for your beloved hotel", "Best rate guaranteed"))
          .put(AssetFieldType.BUSINESS_NAME, ImmutableList.of("Interplanetary Cruises"))
          .build();
  private static Map<AssetFieldType, List<String>> DEFAULT_IMAGE_ASSETS_INFO =
      ImmutableMap.<AssetFieldType, List<String>>builder()
          .put(AssetFieldType.MARKETING_IMAGE, ImmutableList.of("https://gaagl.page.link/Eit5"))
          .put(
              AssetFieldType.SQUARE_MARKETING_IMAGE,
              ImmutableList.of("https://gaagl.page.link/bjYi"))
          .put(AssetFieldType.LOGO, ImmutableList.of("https://gaagl.page.link/bjYi"))
          .build();

  // We specify temporary IDs that are specific to a single mutate request. Temporary IDs are always
  // negative and unique within one mutate request.
  //
  // <p>See https://developers.google.com/google-ads/api/docs/mutating/best-practices for further
  // details.
  //
  // <p>These temporary IDs are fixed because they are used in multiple places.
  private static final int ASSET_TEMPORARY_ID = -1;
  private static final int BUDGET_TEMPORARY_ID = -2;
  private static final int CAMPAIGN_TEMPORARY_ID = -3;
  private static final int ASSET_GROUP_TEMPORARY_ID = -4;

  // There are also entities that will be created in the same request but do not
  // need to be fixed temporary IDs because they are referenced only once.
  private static long temporaryId = ASSET_GROUP_TEMPORARY_ID - 1;

  /** Parameters for the example. */
  private static class AddPerformanceMaxForTravelGoalsCampaignParams extends CodeSampleParams {

    @Parameter(names = ArgumentNames.CUSTOMER_ID, required = true)
    private Long customerId;

    @Parameter(
        names = ArgumentNames.PLACE_ID,
        required = true,
        description =
            "The place ID of a hotel property. A place ID uniquely identifies a place in the Google"
                + " Places database. See https://developers.google.com/places/web-service/place-id"
                + " to learn more.")
    private String placeId;
  }

  public static void main(String[] args) {
    AddPerformanceMaxForTravelGoalsCampaignParams params =
        new AddPerformanceMaxForTravelGoalsCampaignParams();
    if (!params.parseArguments(args)) {

      // Either pass the required parameters for this example on the command line, or insert them
      // into the code here. See the parameter class definition above for descriptions.
      params.customerId = Long.parseLong("INSERT_CUSTOMER_ID_HERE");
      params.placeId = "INSERT_PLACE_ID_HERE";
    }

    GoogleAdsClient googleAdsClient = null;
    try {
      googleAdsClient = GoogleAdsClient.newBuilder().fromPropertiesFile().build();
    } catch (FileNotFoundException fnfe) {
      System.err.printf(
          "Failed to load GoogleAdsClient configuration from file. Exception: %s%n", fnfe);
      System.exit(1);
    } catch (IOException ioe) {
      System.err.printf("Failed to create GoogleAdsClient. Exception: %s%n", ioe);
      System.exit(1);
    }

    try {
      new AddPerformanceMaxForTravelGoalsCampaign()
          .runExample(googleAdsClient, params.customerId, params.placeId);
    } 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
      // collection of GoogleAdsErrors that indicate the underlying causes of the
      // GoogleAdsException.
      System.err.printf(
          "Request ID %s failed due to GoogleAdsException. Underlying errors:%n",
          gae.getRequestId());
      int i = 0;
      for (GoogleAdsError googleAdsError : gae.getGoogleAdsFailure().getErrorsList()) {
        System.err.printf("  Error %d: %s%n", i++, googleAdsError);
      }
      System.exit(1);
    }
  }

  /**
   * Runs the example.
   *
   * @param googleAdsClient the Google Ads API client.
   * @param customerId the client customer ID.
   * @param placeId the place ID for a hotel property asset.
   */
  private void runExample(GoogleAdsClient googleAdsClient, long customerId, String placeId) {
    // Gets hotel asset suggestion using the TravelAssetSuggestionService.
    HotelAssetSuggestion hotelAssetSuggestion =
        getHotelAssetSuggestion(googleAdsClient, customerId, placeId);

    // Performance Max campaigns require that repeated assets such as headlines and descriptions be
    // created before the campaign. For the list of required assets for a Performance Max campaign,
    // see
    // https://developers.google.com/google-ads/api/docs/performance-max/assets.
    //
    // This step is the same for any type of Performance Max campaign.

    // Creates the headlines using the hotel asset suggestion.
    List<String> headlineAssetResourceNames =
        createMultipleTextAssets(
            googleAdsClient, customerId, AssetFieldType.HEADLINE, hotelAssetSuggestion);

    // Creates the descriptions using the hotel asset suggestion.
    List<String> descriptionAssetResourceNames =
        createMultipleTextAssets(
            googleAdsClient, customerId, AssetFieldType.DESCRIPTION, hotelAssetSuggestion);

    // Creates a hotel property asset set, which will be used later to link with a newly created
    // campaign.
    String hotelPropertyAssetSetResourceName = createHotelAssetSet(googleAdsClient, customerId);

    // Creates a hotel property asset and link it with the previously created hotel property asset
    // set. This asset will also be linked to an asset group in the later steps. In the real-world
    // scenario, you'd need to create many assets for all your hotel properties. We use one hotel
    // property here for simplicity. Both asset and asset set need to be created before creating a
    // campaign, so we cannot bundle them with other mutate operations below.
    String hotelPropertyAssetResourceName =
        createHotelAsset(googleAdsClient, customerId, placeId, hotelPropertyAssetSetResourceName);

    // It's important to create the below entities in this order because they depend on
    // each other.
    // The below methods create and return mutate operations that we later provide to the
    // GoogleAdsService.Mutate method in order to create the entities in a single request.
    // Since the entities for a Performance Max campaign are closely tied to one-another, it's
    // considered a best practice to create them in a single Mutate request so they all complete
    // successfully or fail entirely, leaving no orphaned entities. See:
    // https://developers.google.com/google-ads/api/docs/mutating/overview.
    List<MutateOperation> mutateOperations = new ArrayList<>();
    mutateOperations.add(createCampaignBudgetOperation(customerId));
    mutateOperations.add(createCampaignOperation(customerId, hotelPropertyAssetSetResourceName));
    mutateOperations.addAll(
        createAssetGroupOperations(
            customerId,
            hotelPropertyAssetResourceName,
            headlineAssetResourceNames,
            descriptionAssetResourceNames,
            hotelAssetSuggestion));

    // Issues a mutate request to create everything and prints the results.
    try (GoogleAdsServiceClient googleAdsServiceClient =
        googleAdsClient.getLatestVersion().createGoogleAdsServiceClient()) {
      MutateGoogleAdsResponse response =
          googleAdsServiceClient.mutate(Long.toString(customerId), mutateOperations);
      System.out.println(
          "Created the following entities for a campaign budget, a campaign, and an asset group for"
              + " Performance Max for travel goals:");
      printResponseDetails(response);
    }
  }

  /**
   * Returns hotel asset suggestion obtained from TravelAssetsSuggestionService.
   *
   * @param googleAdsClient the Google Ads API client.
   * @param customerId the client customer ID.
   * @param placeId the place ID for a hotel property asset.
   * @return a hotel asset suggestion.
   */
  private HotelAssetSuggestion getHotelAssetSuggestion(
      GoogleAdsClient googleAdsClient, long customerId, String placeId) {

    try (TravelAssetSuggestionServiceClient travelAssetSuggestionServiceClient =
        googleAdsClient.getLatestVersion().createTravelAssetSuggestionServiceClient()) {
      // Sends a request to suggest assets to be created as an asset group for the Performance Max
      // for travel goals campaign.
      SuggestTravelAssetsResponse suggestTravelAssetsResponse =
          travelAssetSuggestionServiceClient.suggestTravelAssets(
              SuggestTravelAssetsRequest.newBuilder()
                  .setCustomerId(Long.toString(customerId))
                  // Uses 'en-US' as an example. It can be any language specifications in BCP 47
                  // format.
                  .setLanguageOption("en-US")
                  // The service accepts several place IDs. We use only one here for demonstration.
                  .addPlaceIds(placeId)
                  .build());
      System.out.printf("Fetched a hotel asset suggestion for the place ID '%s'.%n", placeId);
      return suggestTravelAssetsResponse.getHotelAssetSuggestions(0);
    }
  }

  /**
   * Creates multiple text assets and returns the list of resource names. The hotel asset suggestion
   * is used to create a text asset first. If the number of created text assets is still fewer than
   * the minimum required number of assets of the specified asset field type, adds more text assets
   * to fulfill the requirement.
   *
   * @param googleAdsClient the Google Ads API client.
   * @param customerId the client customer ID.
   * @param assetFieldType the asset field type that the text assets will be created for.
   * @param hotelAssetSuggestion the hotel asset suggestion.
   * @return the resource names of the created text assets.
   */
  private List<String> createMultipleTextAssets(
      GoogleAdsClient googleAdsClient,
      long customerId,
      AssetFieldType assetFieldType,
      HotelAssetSuggestion hotelAssetSuggestion) {

    // Uses the GoogleAdService to create multiple text assets in a single request.
    List<MutateOperation> mutateOperations = new ArrayList<>();

    // First, adds all the text assets of the specified asset field type.
    // Filters to only the specified asset field type.
    // Constructs a mutate operation to create the asset.
    // Adds the operation to the list.
    if (HotelAssetSuggestionStatus.SUCCESS.equals(hotelAssetSuggestion.getStatus())) {
      for (HotelTextAsset asset : hotelAssetSuggestion.getTextAssetsList()) {
        if (asset.getAssetFieldType().equals(assetFieldType)) {
          MutateOperation build =
              MutateOperation.newBuilder()
                  .setAssetOperation(
                      AssetOperation.newBuilder()
                          .setCreate(
                              Asset.newBuilder()
                                  .setTextAsset(
                                      TextAsset.newBuilder().setText(asset.getText()).build())
                                  .build()))
                  .build();
          mutateOperations.add(build);
        }
      }
    }

    // If the added assets are still less than the minimum required assets for the asset field type,
    // add more text assets using the default texts.
    int i = 0;
    while (mutateOperations.size() < MIN_REQUIRED_TEXT_ASSET_COUNTS.get(assetFieldType)) {
      String text = DEFAULT_TEXT_ASSETS_INFO.get(assetFieldType).get(i++);
      // Creates a mutate operation for a text asset, using the default text.
      mutateOperations.add(
          MutateOperation.newBuilder()
              .setAssetOperation(
                  AssetOperation.newBuilder()
                      .setCreate(
                          Asset.newBuilder()
                              .setTextAsset(TextAsset.newBuilder().setText(text).build())
                              .build()))
              .build());
    }

    // Issues a mutate request to add all assets.
    List<String> assetResourceNames;
    try (GoogleAdsServiceClient googleAdsServiceClient =
        googleAdsClient.getLatestVersion().createGoogleAdsServiceClient()) {
      MutateGoogleAdsResponse response =
          googleAdsServiceClient.mutate(Long.toString(customerId), mutateOperations);
      assetResourceNames =
          response.getMutateOperationResponsesList().stream()
              .map(resp -> resp.getAssetResult().getResourceName())
              .collect(Collectors.toList());
      System.out.printf(
          "The following assets were created for the asset field type '%s':%n", assetFieldType);
      printResponseDetails(response);
    }

    return assetResourceNames;
  }

  /**
   * Creates a hotel property asset set.
   *
   * @param googleAdsClient the Google Ads API client.
   * @param customerId the client customer ID.
   * @return the created hotel property asset set resource name.
   */
  private String createHotelAssetSet(GoogleAdsClient googleAdsClient, long customerId) {
    // Creates an asset set operation for a hotel property asset set.
    AssetSetOperation assetSetOperation =
        AssetSetOperation.newBuilder()
            .setCreate(
                AssetSet.newBuilder()
                    .setName(
                        "My Hotel propery asset set #" + CodeSampleHelper.getPrintableDateTime())
                    .setType(AssetSetType.HOTEL_PROPERTY))
            .build();
    try (AssetSetServiceClient assetSetServiceClient =
        googleAdsClient.getLatestVersion().createAssetSetServiceClient()) {
      MutateAssetSetsResponse mutateAssetSetsResponse =
          assetSetServiceClient.mutateAssetSets(
              Long.toString(customerId), ImmutableList.of(assetSetOperation));
      String assetSetResourceName = mutateAssetSetsResponse.getResults(0).getResourceName();
      System.out.printf("Created an asset set with resource name: '%s'%n", assetSetResourceName);
      return assetSetResourceName;
    }
  }

  /**
   * Creates a hotel property asset using the specified place ID. The place ID must belong to a
   * hotel property. Then, links it to the specified asset set.
   *
   * <p>See https://developers.google.com/places/web-service/place-id to search for a hotel place
   * ID.
   *
   * @param googleAdsClient the Google Ads API client.
   * @param customerId the client customer ID.
   * @param placeId the place ID for a hotel.
   * @param hotelPropertyAssetSetResourceName the hotel asset set resource name.
   * @return the created hotel property asset resource name.
   */
  private String createHotelAsset(
      GoogleAdsClient googleAdsClient,
      long customerId,
      String placeId,
      String hotelPropertyAssetSetResourceName) {
    // Uses the GoogleAdService to create an asset and asset set asset in a single request.
    List<MutateOperation> mutateOperations = new ArrayList<>();
    String assetResourceName = ResourceNames.asset(customerId, ASSET_TEMPORARY_ID);
    // Creates a mutate operation for a hotel property asset.
    Asset hotelPropertyAsset =
        Asset.newBuilder()
            .setResourceName(assetResourceName)
            .setHotelPropertyAsset(HotelPropertyAsset.newBuilder().setPlaceId(placeId))
            .build();
    mutateOperations.add(
        MutateOperation.newBuilder()
            .setAssetOperation(AssetOperation.newBuilder().setCreate(hotelPropertyAsset))
            .build());

    // Creates a mutate operation for an asset set asset.
    AssetSetAsset assetSetAsset =
        AssetSetAsset.newBuilder()
            .setAsset(assetResourceName)
            .setAssetSet(hotelPropertyAssetSetResourceName)
            .build();
    mutateOperations.add(
        MutateOperation.newBuilder()
            .setAssetSetAssetOperation(AssetSetAssetOperation.newBuilder().setCreate(assetSetAsset))
            .build());
    // Issues a mutate request to create all entities.
    try (GoogleAdsServiceClient googleAdsServiceClient =
        googleAdsClient.getLatestVersion().createGoogleAdsServiceClient()) {
      MutateGoogleAdsResponse mutateGoogleAdsResponse =
          googleAdsServiceClient.mutate(Long.toString(customerId), mutateOperations);
      System.out.println("Created the following entities for the hotel asset:");
      printResponseDetails(mutateGoogleAdsResponse);
      // Returns the created asset resource name, which will be used later to create an asset
      // group. Other resource names are not used later.
      return mutateGoogleAdsResponse
          .getMutateOperationResponses(0)
          .getAssetResult()
          .getResourceName();
    }
  }

  /**
   * Creates a mutate operation that creates a new campaign budget.
   *
   * <p>A temporary ID will be assigned to this campaign budget so that it can be referenced by
   * other objects being created in the same mutate request.
   *
   * @param customerId the client customer ID.
   * @return a mutate operation that creates a campaign budget.
   */
  private MutateOperation createCampaignBudgetOperation(long customerId) {
    CampaignBudget campaignBudget =
        CampaignBudget.newBuilder()
            .setName("Performance Max for travel goals campaign budget #" + getPrintableDateTime())
            // The budget period already defaults to DAILY.
            .setAmountMicros(50_000_000)
            .setDeliveryMethod(BudgetDeliveryMethod.STANDARD)
            // A Performance Max campaign cannot use a shared campaign budget.
            .setExplicitlyShared(false)
            // Sets a temporary ID in the budget's resource name, so it can be referenced
            // by the campaign in later steps.
            .setResourceName(ResourceNames.campaignBudget(customerId, BUDGET_TEMPORARY_ID))
            .build();

    return MutateOperation.newBuilder()
        .setCampaignBudgetOperation(
            CampaignBudgetOperation.newBuilder().setCreate(campaignBudget).build())
        .build();
  }

  /**
   * Creates a mutate operation that creates a new Performance Max campaign. Links the specified
   * hotel property asset set to this campaign.
   *
   * <p>A temporary ID will be assigned to this campaign so that it can be referenced by other
   * objects being created in the same mutate request.
   *
   * @param customerId the client customer ID.
   * @param hotelPropertyAssetSetResourceName
   * @return the mutate operation that creates a campaign.
   */
  private MutateOperation createCampaignOperation(
      long customerId, String hotelPropertyAssetSetResourceName) {
    Campaign performanceMaxCampaign =
        Campaign.newBuilder()
            .setName("Performance Max for travel goals campaign #" + getPrintableDateTime())
            // Sets the campaign status as PAUSED. The campaign is the only entity in
            // the mutate request that should have its status set.
            .setStatus(CampaignStatus.PAUSED)
            // All Performance Max campaigns have an advertising_channel_type of
            // PERFORMANCE_MAX. The advertising_channel_sub_type should not be set.
            .setAdvertisingChannelType(AdvertisingChannelType.PERFORMANCE_MAX)
            // To create a Performance Max for travel goals campaign, you need to set
            // `hotel_property_asset_set`.
            .setHotelPropertyAssetSet(hotelPropertyAssetSetResourceName)
            // Bidding strategy must be set directly on the campaign.
            // Setting a portfolio bidding strategy by resource name is not supported.
            // Max Conversion and Maximize Conversion Value are the only strategies
            // supported for Performance Max campaigns.
            // An optional ROAS (Return on Advertising Spend) can be set for
            // maximize_conversion_value. The ROAS value must be specified as a ratio in
            // the API. It is calculated by dividing "total value" by "total spend".
            // For more information on Maximize Conversion Value, see the support
            // article: http://support.google.com/google-ads/answer/7684216.
            // A targetRoas of 3.5 corresponds to a 350% return on ad spend.
            .setMaximizeConversionValue(
                MaximizeConversionValue.newBuilder().setTargetRoas(3.5).build())
            // Assigns the resource name with a temporary ID.
            .setResourceName(ResourceNames.campaign(customerId, CAMPAIGN_TEMPORARY_ID))
            // Sets the budget using the given budget resource name.
            .setCampaignBudget(ResourceNames.campaignBudget(customerId, BUDGET_TEMPORARY_ID))
            // Optional fields.
            .setStartDate(new DateTime().plusDays(1).toString("yyyyMMdd"))
            .setEndDate(new DateTime().plusDays(365).toString("yyyyMMdd"))
            .build();

    return MutateOperation.newBuilder()
        .setCampaignOperation(
            CampaignOperation.newBuilder().setCreate(performanceMaxCampaign).build())
        .build();
  }

  /**
   * Creates a list of mutate operations that create a new asset group, composed of suggested
   * assets. In case the number of suggested assets is not enough for the requirements, creates more
   * assets to meet the requirement.
   *
   * <p>For the list of required assets for a Performance Max campaign, see
   * https://developers.google.com/google-ads/api/docs/performance-max/assets.
   *
   * @param hotelPropertyAssetResourceName the hotel property asset resource name that will be used
   *     to create an asset group
   * @param headlineAssetResourceNames a list of headline resource names
   * @param descriptionAssetResourceNames a list of description resource names
   * @param hotelAssetSuggestion the hotel asset suggestion
   * @return a list of mutate operations that create the asset group
   */
  private List<MutateOperation> createAssetGroupOperations(
      long customerId,
      String hotelPropertyAssetResourceName,
      List<String> headlineAssetResourceNames,
      List<String> descriptionAssetResourceNames,
      HotelAssetSuggestion hotelAssetSuggestion) {
    List<MutateOperation> mutateOperations = new ArrayList<>();

    // Creates a new mutate operation that creates an asset group using suggested information when
    // available.
    String assetGroupName;
    List<String> assetGroupFinalUrls;
    if (HotelAssetSuggestionStatus.SUCCESS.equals(hotelAssetSuggestion.getStatus())) {
      assetGroupName = hotelAssetSuggestion.getHotelName();
      assetGroupFinalUrls = ImmutableList.of(hotelAssetSuggestion.getFinalUrl());
    } else {
      assetGroupName = "Performance Max for travel goals asset group #" + getPrintableDateTime();
      assetGroupFinalUrls = ImmutableList.of("https://www.example.com");
    }
    String assetGroupResourceName = ResourceNames.assetGroup(customerId, ASSET_GROUP_TEMPORARY_ID);
    AssetGroup assetGroup =
        AssetGroup.newBuilder()
            .setResourceName(assetGroupResourceName)
            .setName(assetGroupName)
            .setCampaign(ResourceNames.campaign(customerId, CAMPAIGN_TEMPORARY_ID))
            .addAllFinalUrls(assetGroupFinalUrls)
            .setStatus(AssetGroupStatus.PAUSED)
            .build();
    mutateOperations.add(
        MutateOperation.newBuilder()
            .setAssetGroupOperation(AssetGroupOperation.newBuilder().setCreate(assetGroup))
            .build());

    // An asset group is linked to an asset by creating a new asset group asset
    // and providing:
    // -  the resource name of the asset group
    // -  the resource name of the asset
    // -  the field_type of the asset in this asset group
    //
    // To learn more about asset groups, see
    // https://developers.google.com/google-ads/api/docs/performance-max/asset-groups.

    // Headline and description assets were created at the first step of this example. So, we
    // just need to link them with the created asset group.

    // Builds the AssetGroupAssets to link headline assets to the asset group.
    List<AssetGroupAsset> assetGroupAssets = new ArrayList<>();
    assetGroupAssets.addAll(
        headlineAssetResourceNames.stream()
            .map(
                headlineAssetResourceName ->
                    AssetGroupAsset.newBuilder()
                        .setAsset(headlineAssetResourceName)
                        .setAssetGroup(assetGroupResourceName)
                        .setFieldType(AssetFieldType.HEADLINE)
                        .build())
            .collect(Collectors.toList()));
    // Builds the AssetGroupAssets to link description assets to the asset group.
    assetGroupAssets.addAll(
        descriptionAssetResourceNames.stream()
            .map(
                descriptionAssetResourceName ->
                    AssetGroupAsset.newBuilder()
                        .setAsset(descriptionAssetResourceName)
                        .setAssetGroup(assetGroupResourceName)
                        .setFieldType(AssetFieldType.DESCRIPTION)
                        .build())
            .collect(Collectors.toList()));

    // Adds operations to create the AssetGroupAssets for headlines and descriptions.
    mutateOperations.addAll(
        assetGroupAssets.stream()
            .map(
                assetGroupAsset ->
                    MutateOperation.newBuilder()
                        .setAssetGroupAssetOperation(
                            AssetGroupAssetOperation.newBuilder()
                                .setCreate(assetGroupAsset)
                                .build())
                        .build())
            .collect(Collectors.toList()));

    // Link the previously created hotel property asset to the asset group. In the real-world
    // scenario, you'd need to do this step several times for each hotel property asset.
    AssetGroupAsset hotelProperyAssetGroupAsset =
        AssetGroupAsset.newBuilder()
            .setAsset(hotelPropertyAssetResourceName)
            .setAssetGroup(assetGroupResourceName)
            .setFieldType(AssetFieldType.HOTEL_PROPERTY)
            .build();
    // Adds an operation to link the hotel property asset to the asset group.
    mutateOperations.add(
        MutateOperation.newBuilder()
            .setAssetGroupAssetOperation(
                AssetGroupAssetOperation.newBuilder().setCreate(hotelProperyAssetGroupAsset))
            .build());

    // Creates the rest of the required text assets and links them to the asset group.
    mutateOperations.addAll(
        createOperationsForTextAssetsAndAssetGroupAssets(
            customerId, hotelAssetSuggestion, assetGroupResourceName));

    // Creates the image assets and links them to the asset group. Some optional image assets
    // suggested by the TravelAssetSuggestionService might be created too.
    mutateOperations.addAll(
        createOperationsForImageAssetsAndAssetGroupAssets(
            customerId, hotelAssetSuggestion, assetGroupResourceName));
    if (HotelAssetSuggestionStatus.SUCCESS.equals(hotelAssetSuggestion.getStatus())) {
      // Creates a new mutate operation for a suggested call-to-action asset and links it
      // to the asset group.
      Asset callToActionAsset =
          Asset.newBuilder()
              .setResourceName(ResourceNames.asset(customerId, temporaryId))
              .setName("Suggested call-to-action asset #" + CodeSampleHelper.getPrintableDateTime())
              .setCallToActionAsset(
                  CallToActionAsset.newBuilder()
                      .setCallToAction(hotelAssetSuggestion.getCallToAction()))
              .build();
      // Adds an operation to create the call-to-action asset.
      mutateOperations.add(
          MutateOperation.newBuilder()
              .setAssetOperation(AssetOperation.newBuilder().setCreate(callToActionAsset))
              .build());

      AssetGroupAsset callToActionAssetGroupAsset =
          AssetGroupAsset.newBuilder()
              .setAsset(callToActionAsset.getResourceName())
              .setAssetGroup(assetGroupResourceName)
              .setFieldType(AssetFieldType.CALL_TO_ACTION_SELECTION)
              .build();
      // Adds an operation to link the call-to-action asset to the asset group.
      mutateOperations.add(
          MutateOperation.newBuilder()
              .setAssetGroupAssetOperation(
                  AssetGroupAssetOperation.newBuilder().setCreate(callToActionAssetGroupAsset))
              .build());

      temporaryId--;
    }
    return mutateOperations;
  }

  /**
   * Creates text assets required for an asset group using the suggested hotel text assets. It adds
   * more text assets to fulfill the requirements if the suggested hotel text assets are not enough.
   *
   * @param customerId the client customer ID.
   * @param hotelAssetSuggestion the hotel asset suggestion.
   * @return a list of mutate operations that create text assets and asset group assets.
   */
  private List<MutateOperation> createOperationsForTextAssetsAndAssetGroupAssets(
      long customerId, HotelAssetSuggestion hotelAssetSuggestion, String assetGroupResourceName) {
    // Creates mutate operations for the suggested text assets except for headlines and
    // descriptions, which were created previously.
    List<MutateOperation> mutateOperations = new ArrayList<>();
    // Creates a map of asset field type to list of text values to create.
    Map<AssetFieldType, List<String>> textByFieldType = new HashMap<>();

    if (HotelAssetSuggestionStatus.SUCCESS.equals(hotelAssetSuggestion.getStatus())) {
      // Adds text values of suggested text assets.
      for (HotelTextAsset hotelTextAsset : hotelAssetSuggestion.getTextAssetsList()) {
        AssetFieldType assetFieldType = hotelTextAsset.getAssetFieldType();
        if (AssetFieldType.HEADLINE.equals(assetFieldType)
            || AssetFieldType.DESCRIPTION.equals(assetFieldType)) {
          // Headlines and descriptions were already created at the first step of this code example.
          continue;
        }
        System.out.printf(
            "A text asset with text '%s' is suggested for the asset field type '%s'.%n",
            hotelTextAsset.getText(), assetFieldType);

        textByFieldType
            .computeIfAbsent(assetFieldType, ft -> new ArrayList<>())
            .add(hotelTextAsset.getText());
      }
    }

    // Collects more text values by field type to fulfill the requirements.
    for (Entry<AssetFieldType, Integer> requiredEntry : MIN_REQUIRED_TEXT_ASSET_COUNTS.entrySet()) {
      AssetFieldType assetFieldType = requiredEntry.getKey();
      if (AssetFieldType.HEADLINE.equals(assetFieldType)
          || AssetFieldType.DESCRIPTION.equals(assetFieldType)) {
        // Headlines and descriptions were already created at the first step of this code example.
        continue;
      }
      textByFieldType.computeIfAbsent(assetFieldType, k -> new ArrayList<>());
      int i = 0;
      while (textByFieldType.get(assetFieldType).size() < requiredEntry.getValue()) {
        String textFromDefaults = DEFAULT_TEXT_ASSETS_INFO.get(assetFieldType).get(i++);
        System.out.printf(
            "A default text '%s' is used to create a text asset for the asset field type '%s'.%n",
            textFromDefaults, assetFieldType);
        textByFieldType
            .computeIfAbsent(assetFieldType, ft -> new ArrayList<>())
            .add(textFromDefaults);
      }
    }

    // Converts the list of text values by field type into AssetOperations and
    // AssetGroupAssetOperations.
    for (Entry<AssetFieldType, List<String>> fieldTypeEntry : textByFieldType.entrySet()) {
      for (String text : fieldTypeEntry.getValue()) {
        // Builds the Asset.
        Asset asset =
            Asset.newBuilder()
                .setResourceName(ResourceNames.asset(customerId, temporaryId--))
                .setTextAsset(TextAsset.newBuilder().setText(text))
                .build();
        // Adds an operation to create the Asset.
        mutateOperations.add(
            MutateOperation.newBuilder()
                .setAssetOperation(AssetOperation.newBuilder().setCreate(asset))
                .build());

        // Builds the AssetGroupAsset.
        AssetGroupAsset assetGroupAsset =
            AssetGroupAsset.newBuilder()
                // References the Asset above by resource name.
                .setAsset(asset.getResourceName())
                .setAssetGroup(assetGroupResourceName)
                .setFieldType(fieldTypeEntry.getKey())
                .build();
        // Adds an operation to link the Asset to the AssetGroup.
        mutateOperations.add(
            MutateOperation.newBuilder()
                .setAssetGroupAssetOperation(
                    AssetGroupAssetOperation.newBuilder().setCreate(assetGroupAsset))
                .build());
      }
    }
    return mutateOperations;
  }

  /**
   * Creates image assets required for an asset group using the suggested hotel image assets. It
   * adds more image assets to fulfill the requirements if the suggested hotel image assets are not
   * enough.
   *
   * @param customerId the client customer ID.
   * @param hotelAssetSuggestion the hotel asset suggestion.
   * @return a list of mutate operations that create image assets and asset group assets.
   */
  private List<MutateOperation> createOperationsForImageAssetsAndAssetGroupAssets(
      long customerId, HotelAssetSuggestion hotelAssetSuggestion, String assetGroupResourceName) {
    // Creates mutate operations for the suggested image assets.
    List<MutateOperation> mutateOperations = new ArrayList<>();
    // Creates a map of asset field type to list of image URLs for which this method will create
    // assets and asset group assets.
    Map<AssetFieldType, List<String>> imageUrlsByFieldType = new HashMap<>();

    if (HotelAssetSuggestionStatus.SUCCESS.equals(hotelAssetSuggestion.getStatus())) {
      // Adds URLs of suggested image assets.
      for (HotelImageAsset hotelImageAsset : hotelAssetSuggestion.getImageAssetsList()) {
        AssetFieldType assetFieldType = hotelImageAsset.getAssetFieldType();
        System.out.printf(
            "An image asset with URL '%s' is suggested for the asset field type '%s'.%n",
            hotelImageAsset.getUri(), assetFieldType);

        imageUrlsByFieldType
            .computeIfAbsent(assetFieldType, ft -> new ArrayList<>())
            .add(hotelImageAsset.getUri());
      }
    }

    // Collects more image URLs by field type to fulfill the requirements.
    for (Entry<AssetFieldType, Integer> requiredEntry :
        MIN_REQUIRED_IMAGE_ASSET_COUNTS.entrySet()) {
      AssetFieldType assetFieldType = requiredEntry.getKey();
      imageUrlsByFieldType.computeIfAbsent(assetFieldType, k -> new ArrayList<>());
      int i = 0;
      while (imageUrlsByFieldType.get(assetFieldType).size() < requiredEntry.getValue()) {
        String imageUrlFromDefaults = DEFAULT_IMAGE_ASSETS_INFO.get(assetFieldType).get(i++);
        System.out.printf(
            "A default image URL '%s' is used to create an image asset for the asset field type"
                + " '%s'.%n",
            imageUrlFromDefaults, assetFieldType);
        imageUrlsByFieldType
            .computeIfAbsent(assetFieldType, ft -> new ArrayList<>())
            .add(imageUrlFromDefaults);
      }
    }

    // Converts the list of URLs by field type into AssetOperations and AssetGroupAssetOperations.
    for (Entry<AssetFieldType, List<String>> fieldTypeEntry : imageUrlsByFieldType.entrySet()) {
      AssetFieldType assetFieldType = fieldTypeEntry.getKey();
      for (String url : fieldTypeEntry.getValue()) {
        // Retrieves the image data from the URL.
        byte[] imageData;
        try {
          imageData = ByteStreams.toByteArray(new URL(url).openStream());
        } catch (IOException e) {
          throw new RuntimeException("Failed to retrieve image data from URL: " + url, e);
        }

        // Builds the image asset.
        Asset asset =
            Asset.newBuilder()
                .setResourceName(ResourceNames.asset(customerId, temporaryId--))
                // Provide a unique friendly name to identify your asset.
                // When there is an existing image asset with the same content but a different name,
                // the
                // new name will be dropped silently.
                .setName(
                    String.format(
                        "%s#%s", assetFieldType, CodeSampleHelper.getShortPrintableDateTime()))
                .setImageAsset(ImageAsset.newBuilder().setData(ByteString.copyFrom(imageData)))
                .build();
        // Adds an operation to create the Asset.
        mutateOperations.add(
            MutateOperation.newBuilder()
                .setAssetOperation(AssetOperation.newBuilder().setCreate(asset))
                .build());

        // Builds the AssetGroupAsset.
        AssetGroupAsset assetGroupAsset =
            AssetGroupAsset.newBuilder()
                // References the Asset above by resource name.
                .setAsset(asset.getResourceName())
                .setAssetGroup(assetGroupResourceName)
                .setFieldType(assetFieldType)
                .build();
        // Adds an operation to link the Asset to the AssetGroup.
        mutateOperations.add(
            MutateOperation.newBuilder()
                .setAssetGroupAssetOperation(
                    AssetGroupAssetOperation.newBuilder().setCreate(assetGroupAsset))
                .build());
      }
    }
    return mutateOperations;
  }

  /**
   * Prints the details of a MutateGoogleAdsResponse. Parses the "response" oneof field name and
   * uses it to extract the new entity's name and resource name.
   *
   * @param response the mutate Google Ads response.
   */
  private void printResponseDetails(MutateGoogleAdsResponse response) {
    for (MutateOperationResponse operationResponse : response.getMutateOperationResponsesList()) {
      ResponseCase responseCase = operationResponse.getResponseCase();
      String resourceName;
      switch (responseCase) {
        case ASSET_RESULT:
          resourceName = operationResponse.getAssetResult().getResourceName();
          break;
        case ASSET_GROUP_RESULT:
          resourceName = operationResponse.getAssetGroupResult().getResourceName();
          break;
        case ASSET_GROUP_ASSET_RESULT:
          resourceName = operationResponse.getAssetGroupAssetResult().getResourceName();
          break;
        case ASSET_SET_ASSET_RESULT:
          resourceName = operationResponse.getAssetSetAssetResult().getResourceName();
          break;
        case CAMPAIGN_BUDGET_RESULT:
          resourceName = operationResponse.getCampaignBudgetResult().getResourceName();
          break;
        case CAMPAIGN_RESULT:
          resourceName = operationResponse.getCampaignResult().getResourceName();
          break;
        default:
          throw new IllegalArgumentException("Unexpected response case: " + responseCase);
      }
      System.out.printf("Created a(n) %s with resource name: '%s'%n", responseCase, resourceName);
    }
  }
}
AddPerformanceMaxForTravelGoalsCampaign.java
      

// Copyright 2023 Google LLC
//
// 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.

using CommandLine;
using Google.Ads.Gax.Examples;
using Google.Ads.Gax.Util;
using Google.Ads.GoogleAds.Config;
using Google.Ads.GoogleAds.Lib;
using Google.Ads.GoogleAds.V17.Common;
using Google.Ads.GoogleAds.V17.Errors;
using Google.Ads.GoogleAds.V17.Resources;
using Google.Ads.GoogleAds.V17.Services;
using Google.Protobuf;
using System;
using System.Collections.Generic;
using static Google.Ads.GoogleAds.V17.Enums.AdvertisingChannelTypeEnum.Types;
using static Google.Ads.GoogleAds.V17.Enums.AssetFieldTypeEnum.Types;
using static Google.Ads.GoogleAds.V17.Enums.AssetGroupStatusEnum.Types;
using static Google.Ads.GoogleAds.V17.Enums.AssetSetTypeEnum.Types;
using static Google.Ads.GoogleAds.V17.Enums.BudgetDeliveryMethodEnum.Types;
using static Google.Ads.GoogleAds.V17.Enums.CampaignStatusEnum.Types;
using static Google.Ads.GoogleAds.V17.Enums.HotelAssetSuggestionStatusEnum.Types;

namespace Google.Ads.GoogleAds.Examples.V17
{
    /// <summary>
    /// This example shows how to create a Performance Max for travel goals campaign. It also uses
    /// TravelAssetSuggestionService to fetch suggested assets for creating an asset group. In case
    /// there are not enough assets for the asset group (required by Performance Max), this example
    /// will create more assets to fulfill the requirements.
    ///
    /// <p>For more information about Performance Max campaigns, see
    /// https://developers.google.com/google-ads/api/docs/performance-max/overview.</p>
    /// <p>Prerequisites:</p>
    ///
    /// <ul>
    ///   <li>You must have at least one conversion action in the account. For more about conversion
    ///       actions, see
    ///       https://developers.google.com/google-ads/api/docs/conversions/overview#conversion_actions.
    ///   </li>
    /// </ul>
    ///
    /// <p>Notes:</p>
    ///
    /// <ul>
    ///   <li>This example uses the default customer conversion goals. For an example of setting
    ///       campaign-specific conversion goals, see AddPerformanceMaxRetailCampaign.cs.</li>
    ///   <li>To learn how to create asset group signals, see AddPerformanceMaxCampaign.cs.</li>
    /// </ul>
    /// </summary>
    public class AddPerformanceMaxForTravelGoalsCampaign : ExampleBase
    {
        /// <summary>
        /// Command line options for running the
        /// <see cref="AddPerformanceMaxForTravelGoalsCampaign"/> example.
        /// </summary>
        public class Options : OptionsBase
        {
            /// <summary>
            /// The Google Ads customer ID.
            /// </summary>
            [Option("customerId", Required = true, HelpText =
                "The Google Ads customer ID.")]
            public long CustomerId { get; set; }

            /// <summary>
            /// The place ID of a hotel property. A place ID uniquely identifies a place in the
            /// Google Places database. See
            /// https://developers.google.com/places/web-service-place-id to learn more.
            /// </summary>
            [Option("placeId", Required = true, HelpText =
                "The place ID of a hotel property. A place ID uniquely identifies a place in the" +
                "Google Places database. See " +
                "https://developers.google.com/places/web-service-place-id to learn more.")]
            public string PlaceId { get; set; }
        }

        /// <summary>
        /// Main method, to run this code example as a standalone application.
        /// </summary>
        /// <param name="args">The command line arguments.</param>
        public static void Main(string[] args)
        {
            Options options = ExampleUtilities.ParseCommandLine<Options>(args);

            AddPerformanceMaxForTravelGoalsCampaign codeExample =
                new AddPerformanceMaxForTravelGoalsCampaign();
            Console.WriteLine(codeExample.Description);
            codeExample.Run(new GoogleAdsClient(), options.CustomerId, options.PlaceId);
        }

        // Minimum requirements of assets required in a Performance Max asset group.
        // See https://developers.google.com/google-ads/api/docs/performance-max/assets for details.
        private Dictionary<AssetFieldType, int> MIN_REQUIRED_TEXT_ASSET_COUNTS =
            new Dictionary<AssetFieldType, int>()
            {
                { AssetFieldType.Headline, 3 },
                { AssetFieldType.LongHeadline, 1 },
                { AssetFieldType.Description, 2 },
                { AssetFieldType.BusinessName, 1 },
            };

        private Dictionary<AssetFieldType, int> MIN_REQUIRED_IMAGE_ASSET_COUNTS =
            new Dictionary<AssetFieldType, int>()
            {
                { AssetFieldType.MarketingImage, 1 },
                { AssetFieldType.SquareMarketingImage, 1 },
                { AssetFieldType.Logo, 1 },
            };


        // Texts and URLs used to create text and image assets when the TravelAssetSuggestionService
        // doesn't return enough assets required for creating an asset group.
        private Dictionary<AssetFieldType, List<string>> DEFAULT_TEXT_ASSETS_INFO =
            new Dictionary<AssetFieldType, List<string>>()
            {
                { AssetFieldType.Headline, new List<string>()
                    {
                        "Hotel", "Travel Reviews", "Book travel"
                    }
                },
                { AssetFieldType.LongHeadline, new List<string>() { "Travel the World" } },
                { AssetFieldType.Description, new List<string>()
                    {
                        "Great deal for your beloved hotel",
                        "Best rate guaranteed"
                    }
                },
                { AssetFieldType.BusinessName, new List<string>() { "Interplanetary cruises" } },
            };

        private Dictionary<AssetFieldType, List<string>> DEFAULT_IMAGE_ASSETS_INFO =
            new Dictionary<AssetFieldType, List<string>>()
            {
                { AssetFieldType.MarketingImage, new List<string>()
                    {
                        "https://gaagl.page.link/Eit5"
                    }
                },
                { AssetFieldType.SquareMarketingImage, new List<string>()
                    {
                        "https://gaagl.page.link/bjYi"
                    }
                },
                { AssetFieldType.Logo, new List<string>()
                    {
                        "https://gaagl.page.link/bjYi"
                    }
                },
            };

        // We specify temporary IDs that are specific to a single mutate request. Temporary IDs are always
        // negative and unique within one mutate request.
        //
        // <p>See https://developers.google.com/google-ads/api/docs/mutating/best-practices for
        // further details.
        //
        // <p>These temporary IDs are fixed because they are used in multiple places.
        private int ASSET_TEMPORARY_ID = -1;
        private int BUDGET_TEMPORARY_ID = -2;
        private int CAMPAIGN_TEMPORARY_ID = -3;
        private int ASSET_GROUP_TEMPORARY_ID = -4;

        // There are also entities that will be created in the same request but do not
        // need to be fixed temporary IDs because they are referenced only once.
        private long temporaryId = -5;

        /// <summary>
        /// Returns a description about the code example.
        /// </summary>
        public override string Description => "This example shows how to create a Performance " +
            " Max for travel goals campaign. It also uses TravelAssetSuggestionService to fetch " +
            "suggested assets for creating an asset group. In case there are not enough assets " +
            "for the asset group (required by Performance Max), this example will create more " +
            "assets to fulfill the requirements.\n" +
            "For more information about Performance Max campaigns, see " +
            "https://developers.google.com/google-ads/api/docs/performance-max/overview.\n" +
            "Prerequisites:\n" +
            "You must have at least one conversion action in the account. For more about " +
            "conversion actions, see " +
            "https://developers.google.com/google-ads/api/docs/conversions/overview#conversion_actions.\n" +
            "Notes:\n" +
            "- This example uses the default customer conversion goals. For an example of " +
            "setting campaign-specific conversion goals, see AddPerformanceMaxRetailCampaign.cs.\n" +
            "- To learn how to create asset group signals, see AddPerformanceMaxCampaign.cs.";

        /// <summary>
        /// Runs the code example.
        /// </summary>
        /// <param name="client">The Google Ads client.</param>
        /// <param name="customerId">The Google Ads customer ID.</param>
        /// <param name="placeId">The place ID of a hotel property.</param>
        public void Run(GoogleAdsClient client, long customerId, string placeId)
        {
            HotelAssetSuggestion hotelAssetSuggestion =
                GetHotelAssetSuggestion(client, customerId, placeId);

            // Performance Max campaigns require that repeated assets such as headlines and
            // descriptions be created before the campaign. For the list of required assets for a
            // Performance Max campaign, see
            // https://developers.google.com/google-ads/api/docs/performance-max/assets.
            // This step is the same for any type of Performance Max campaign.

            // Creates the headlines using the hotel asset suggestion.
            List<string> headlineAssetResourceNames = CreateMultipleTextAssets(
                client, customerId, AssetFieldType.Headline, hotelAssetSuggestion);

            // Creates the descriptions using the hotel asset suggestion.
            List<string> descriptionAssetResourceNames = CreateMultipleTextAssets(
                client, customerId, AssetFieldType.Description, hotelAssetSuggestion);

            // Creates a hotel property asset set, which will be used later to link with a newly
            // created campaign.
            string hotelPropertyAssetSetResourceName = CreateHotelAssetSet(client, customerId);

            // Creates a hotel property asset and link it with the previously created hotel property
            // asset set. This asset will also be linked to an asset group in the later steps.
            // In the real-world scenario, you'd need to create many assets for all your hotel
            // properties. We use one hotel property here for simplicity.
            // Both asset and asset set need to be created before creating a campaign, so we cannot
            // bundle them with other mutate operations below.
            string hotelPropertyAssetResourceName = CreateHotelAsset(
                client, customerId, placeId, hotelPropertyAssetSetResourceName);

            // It's important to create the entities below in this order because they depend on
            // each other.
            // The methods below create and return mutate operations that we later provide to the
            // GoogleAdsService.Mutate method in order to create the entities in a single request.
            // Since the entities for a Performance Max campaign are closely tied to one-another,
            // it's considered a best practice to create them in a single Mutate request so they
            // all complete successfully or fail entirely, leaving no orphaned entities. See:
            // https://developers.google.com/google-ads/api/docs/mutating/overview.
            List<MutateOperation> mutateOperations = new List<MutateOperation>();
            mutateOperations.Add(CreateCampaignBudgetOperation(customerId));
            mutateOperations.Add(CreateCampaignOperation(customerId,
                hotelPropertyAssetSetResourceName));
            mutateOperations.AddRange(
                CreateAssetGroupOperations(
                    customerId,
                    hotelPropertyAssetResourceName,
                    headlineAssetResourceNames,
                    descriptionAssetResourceNames,
                    hotelAssetSuggestion,
                    client.Config
                )
            );

            // Issues a mutate request to create everything and prints the results.
            GoogleAdsServiceClient googleAdsServiceClient =
                client.GetService(Services.V17.GoogleAdsService);
            MutateGoogleAdsResponse response =
                googleAdsServiceClient.Mutate(customerId.ToString(), mutateOperations);
            Console.WriteLine("Created the following entities for a campaign budget, a campaign, " +
                "and an asset group for Performance Max for travel goals:");
            PrintResponseDetails(response);
        }

        /// <summary>
        /// Returns hotel asset suggestion obtained from TravelAssetsSuggestionService.
        /// <param name="client">The Google Ads client.</param>
        /// <param name="customerId">The Google Ads customer ID.</param>
        /// <param name="placeId">The place ID of a hotel property.</param>
        /// <returns>The hotel asset suggestion.</returns>
        /// </summary>
        private HotelAssetSuggestion GetHotelAssetSuggestion(GoogleAdsClient client,
            long customerId, string placeId)
        {
            // Get the TravelAssetSuggestionService client.
            TravelAssetSuggestionServiceClient travelAssetSuggestionService =
                client.GetService(Services.V17.TravelAssetSuggestionService);

            SuggestTravelAssetsRequest request = new SuggestTravelAssetsRequest
            {
                CustomerId = customerId.ToString(),
                LanguageOption = "en-US",
            };

            request.PlaceIds.Add(placeId);

            SuggestTravelAssetsResponse response = travelAssetSuggestionService.SuggestTravelAssets(
                request
            );

            Console.WriteLine($"Fetched a hotel asset suggestion for the place ID {placeId}");
            return response.HotelAssetSuggestions[0];
        }


        ///<summary>
        /// Creates multiple text assets and returns the list of resource names. The hotel asset
        /// suggestion is used to create a text asset first. If the number of created text assets is
        /// still fewer than the minimum required number of assets of the specified asset field
        /// type, adds more text assets  to fulfill the requirement.
        /// <param name="client">The Google Ads client.</param>
        /// <param name="customerId">The Google Ads customer ID.</param>
        /// <param name="assetFieldType">The asset field type that the text assets will be created
        /// for.</param>
        /// <param name="hotelAssetSuggestion">The hotel asset suggestion.</param>
        /// <returns>The resource names of the created text assets.</returns>
        /// </summary>
        private List<string> CreateMultipleTextAssets(GoogleAdsClient client, long customerId,
            AssetFieldType assetFieldType, HotelAssetSuggestion hotelAssetSuggestion)
        {
            // Uses the GoogleAdService to create multiple text assets in a single request.
            List<MutateOperation> mutateOperations = new List<MutateOperation>();

            // First, adds all the text assets of the specified asset field type.
            // Filters to only the specified asset field type.
            // Constructs a mutate operation to create the asset.
            // Adds the operation to the list.
            if (hotelAssetSuggestion.Status == HotelAssetSuggestionStatus.Success)
            {
                foreach (HotelTextAsset asset in hotelAssetSuggestion.TextAssets)
                {
                    if (asset.AssetFieldType == assetFieldType)
                    {
                        MutateOperation operation = new MutateOperation
                        {
                            AssetOperation = new AssetOperation
                            {
                                Create = new Asset
                                {
                                    TextAsset = new TextAsset
                                    {
                                        Text = asset.Text
                                    }
                                }
                            }
                        };
                        mutateOperations.Add(operation);
                    }
                }
            }

            // If the added assets are still less than the minimum required assets for the asset
            // field type, add more text assets using the default texts.
            int i = 0;
            while (mutateOperations.Count < MIN_REQUIRED_TEXT_ASSET_COUNTS[assetFieldType])
            {
                string text = DEFAULT_TEXT_ASSETS_INFO[assetFieldType][i++];
                MutateOperation operation = new MutateOperation
                {
                    AssetOperation = new AssetOperation {
                        Create = new Asset {
                            TextAsset = new TextAsset {
                                Text = text
                            }
                        }
                    }
                };
                mutateOperations.Add(operation);
            }

            GoogleAdsServiceClient googleAdsService =
                client.GetService(Services.V17.GoogleAdsService);

            MutateGoogleAdsResponse response =
                googleAdsService.Mutate(customerId.ToString(), mutateOperations);

            List<string> assetResourceNames = new List<string>();

            foreach (MutateOperationResponse operationResponse in response.MutateOperationResponses)
            {
                MutateAssetResult assetResult = operationResponse.AssetResult;
                assetResourceNames.Add(assetResult.ResourceName);
            }

            Console.WriteLine($"The following assets were created for the asset field type " +
                $"{assetFieldType}");
            PrintResponseDetails(response);

            return assetResourceNames;
        }

        /// <summary>
        /// Creates a hotel property asset set.
        /// <param name="client">The Google Ads client.</param>
        /// <param name="customerId">The Google Ads customer ID.</param>
        /// <returns> The created hotel property asset set resource name.</returns>
        /// </summary>
        private string CreateHotelAssetSet(GoogleAdsClient client, long customerId)
        {
            AssetSetOperation operation = new AssetSetOperation()
            {
                Create = new AssetSet {
                    Name = "My Hotel property asset set #" + ExampleUtilities.GetRandomString(),
                    Type = AssetSetType.HotelProperty
                }
            };

            AssetSetServiceClient assetSetService = client.GetService(Services.V17.AssetSetService);

            MutateAssetSetsResponse response = assetSetService.MutateAssetSets(
                customerId.ToString(),
                new List<AssetSetOperation> { operation }
            );

            string assetResourceName = response.Results[0].ResourceName;
            Console.WriteLine($"Created an asset set with resource name: {assetResourceName}");
            return assetResourceName;
        }

        /// <summary>
        /// Creates a hotel property asset using the specified place ID. The place ID must belong
        /// to a hotel property. Then, links it to the specified asset set.
        ///
        /// <p>See https://developers.google.com/places/web-service/place-id to search for a hotel
        /// place ID.</p>
        /// <param name="client">The Google Ads API client.</param>
        /// <param name="customerId">The client customer ID.</param>
        /// <param name="placeId">The place ID for a hotel.</param>
        /// <param name="hotelPropertyAssetSetResourceName">The hotel asset set resource
        /// name.</param>
        /// <returns>The created hotel property asset resource name.</returns>
        /// </summary>
        private string CreateHotelAsset(
            GoogleAdsClient client, long customerId, string placeId,
            string hotelPropertyAssetSetResourceName)
        {
            // Uses the GoogleAdService to create an asset and asset set asset in a single request.
            List<MutateOperation> mutateOperations = new List<MutateOperation>();
            string assetResourceName = ResourceNames.Asset(customerId, ASSET_TEMPORARY_ID);

            // Creates a mutate operation for a hotel property asset.
            Asset hotelPropertyAsset = new Asset()
            {
                ResourceName = assetResourceName,
                HotelPropertyAsset = new HotelPropertyAsset
                {
                    PlaceId = placeId
                }
            };
            mutateOperations.Add(new MutateOperation
            {
                AssetOperation = new AssetOperation
                {
                   Create = hotelPropertyAsset
                }
            });

            // Creates a mutate operation for an asset set asset.
            AssetSetAsset assetSetAsset = new AssetSetAsset
            {
                Asset = assetResourceName,
                AssetSet = hotelPropertyAssetSetResourceName
            };
            mutateOperations.Add(new MutateOperation
            {
                AssetSetAssetOperation = new AssetSetAssetOperation
                {
                    Create = assetSetAsset
                }
            });

            // Issues a mutate request to create all entities.
            GoogleAdsServiceClient googleAdsServiceClient =
                client.GetService(Services.V17.GoogleAdsService);

            MutateGoogleAdsResponse response =
                googleAdsServiceClient.Mutate(customerId.ToString(), mutateOperations);
            Console.WriteLine("Created the following entities for the hotel asset:");
            PrintResponseDetails(response);

            return response.MutateOperationResponses[0].AssetResult.ResourceName;
        }

        /// <summary>
        /// Creates a mutate operation that creates a new campaign budget.
        /// <p>A temporary ID will be assigned to this campaign budget so that it can be referenced
        /// by other objects being created in the same mutate request.</p>
        /// <param name="customerId">The client customer ID.</param>
        /// <returns>A mutate operation that creates a campaign budget.</returns>
        /// </summary>
        private MutateOperation CreateCampaignBudgetOperation(long customerId)
        {
            CampaignBudget campaignBudget = new CampaignBudget
            {
                Name = "Performance Max for travel goals campaign budget #" +
                    ExampleUtilities.GetRandomString(),
                // The budget period already defaults to DAILY.
                AmountMicros = 500000,
                DeliveryMethod = BudgetDeliveryMethod.Standard,
                // A Performance Max campaign cannot use a shared campaign budget.
                ExplicitlyShared = false,
                // Sets a temporary ID in the budget's resource name, so it can be referenced
                // by the campaign in later steps.
                ResourceName = ResourceNames.CampaignBudget(customerId, BUDGET_TEMPORARY_ID)
            };

            return new MutateOperation
            {
                CampaignBudgetOperation = new CampaignBudgetOperation
                {
                    Create = campaignBudget
                }
            };
        }

        /// <summary>
        /// Creates a mutate operation that creates a new Performance Max campaign. Links the
        /// specified hotel property asset set to this campaign.
        /// <p>A temporary ID will be assigned to this campaign so that it can be referenced by
        /// other objects being created in the same mutate request.</p>
        /// <param name="customerId">The client customer ID.</param>
        /// <param name="hotelPropertyAssetSetResourceName"> The resource name of the hotel property
        /// asset set.</param>
        /// <returns>A mutate operation that creates a campaign.</returns>
        /// </summary>
        private MutateOperation CreateCampaignOperation(long customerId,
            string hotelPropertyAssetSetResourceName)
        {
            Campaign performanceMaxCampaign = new Campaign
            {
                Name = "Performance Max for travel goals campaign #" +
                    ExampleUtilities.GetRandomString(),
                // Sets the campaign status as PAUSED. The campaign is the only entity in
                // the mutate request that should have its status set.
                Status = CampaignStatus.Paused,
                // All Performance Max campaigns have an advertising_channel_type of
                // PERFORMANCE_MAX. The advertising_channel_sub_type should not be set.
                AdvertisingChannelType = AdvertisingChannelType.PerformanceMax,
                // To create a Performance Max for travel goals campaign, you need to set
                // `hotel_property_asset_set`.
                HotelPropertyAssetSet = hotelPropertyAssetSetResourceName,
                // Bidding strategy must be set directly on the campaign.
                // Setting a portfolio bidding strategy by resource name is not supported.
                // Max Conversion and Maximize Conversion Value are the only strategies
                // supported for Performance Max campaigns.
                // An optional ROAS (Return on Advertising Spend) can be set for
                // maximize_conversion_value. The ROAS value must be specified as a ratio in
                // the API. It is calculated by dividing "total value" by "total spend".
                // For more information on Maximize Conversion Value, see the support
                // article: http://support.google.com/google-ads/answer/7684216.
                // A targetRoas of 3.5 corresponds to a 350% return on ad spend.
                MaximizeConversionValue = new MaximizeConversionValue
                {
                    TargetRoas = 3.5
                },
                // Assigns the resource name with a temporary ID.
                ResourceName = ResourceNames.Campaign(customerId, CAMPAIGN_TEMPORARY_ID),
                // Sets the budget using the given budget resource name.
                CampaignBudget = ResourceNames.CampaignBudget(customerId, BUDGET_TEMPORARY_ID)
            };

            return new MutateOperation
            {
                CampaignOperation = new CampaignOperation
                {
                    Create = performanceMaxCampaign
                }
            };
        }

        /// <summary>
        /// Creates a mutate operation that creates a new asset group.
        /// <param name="customerId">The client customer ID.</param>
        /// <param name="hotelPropertyAssetResourceName"> The resource name of the hotel property
        /// asset.</param>
        /// <param name="headlineAssetResourceNames">The resource names for headline
        /// assets.</param>
        /// <param name="descriptionAssetResourceNames">The resource names for description
        /// assets.</param>
        /// <param name="hotelAssetSuggestion">The hotel asset suggestion.</param>
        /// <param name="config">The Google Ads configuration.</param>
        /// <returns>A mutate operation that creates an asset group.</returns>
        /// </summary>
        private List<MutateOperation> CreateAssetGroupOperations(
            long customerId,
            string hotelPropertyAssetResourceName,
            List<string> headlineAssetResourceNames,
            List<string> descriptionAssetResourceNames,
            HotelAssetSuggestion hotelAssetSuggestion,
            GoogleAdsConfig config
        )
        {
            List<MutateOperation> mutateOperations = new List<MutateOperation>();

            // Creates a new mutate operation that creates an asset group using suggested
            // information when available.
            string assetGroupName;
            List<string> assetGroupFinalUrls = new List<string>();
            if (hotelAssetSuggestion.Status == HotelAssetSuggestionStatus.Success)
            {
                assetGroupName = hotelAssetSuggestion.HotelName;
                assetGroupFinalUrls.Add(hotelAssetSuggestion.FinalUrl);
            }
            else
            {
                assetGroupName = "Performance Max for travel goals asset group #"
                    + ExampleUtilities.GetRandomString();
                assetGroupFinalUrls.Add("https://www.example.com");
            }

            string assetGroupResourceName = ResourceNames.AssetGroup(customerId,
                ASSET_GROUP_TEMPORARY_ID);

            AssetGroup assetGroup = new AssetGroup
            {
                ResourceName = assetGroupResourceName,
                Name = assetGroupName,
                Campaign = ResourceNames.Campaign(customerId, CAMPAIGN_TEMPORARY_ID),
                Status = AssetGroupStatus.Paused
            };

            assetGroup.FinalUrls.AddRange(assetGroupFinalUrls);

            mutateOperations.Add(new MutateOperation
            {
                AssetGroupOperation = new AssetGroupOperation
                {
                    Create = assetGroup
                }
            });

            // An asset group is linked to an asset by creating a new asset group asset
            // and providing:
            // -  the resource name of the asset group
            // -  the resource name of the asset
            // -  the field_type of the asset in this asset group
            //
            // To learn more about asset groups, see
            // https://developers.google.com/google-ads/api/docs/performance-max/asset-groups.

            // Headline and description assets were created at the first step of this example.
            // So, we just need to link them with the created asset group.
            List<AssetGroupAsset> assetGroupAssets = new List<AssetGroupAsset>();
            foreach (string headlineAssetResourceName in headlineAssetResourceNames)
            {
                assetGroupAssets.Add(new AssetGroupAsset
                {
                    Asset = headlineAssetResourceName,
                    AssetGroup = assetGroupResourceName,
                    FieldType = AssetFieldType.Headline
                });
            }

            foreach (string descriptionAssetResourceName in descriptionAssetResourceNames)
            {
                assetGroupAssets.Add(new AssetGroupAsset
                {
                    Asset = descriptionAssetResourceName,
                    AssetGroup = assetGroupResourceName,
                    FieldType = AssetFieldType.Description
                });
            }

            foreach (AssetGroupAsset assetGroupAsset in assetGroupAssets)
            {
                mutateOperations.Add(new MutateOperation
                {
                    AssetGroupAssetOperation = new AssetGroupAssetOperation
                    {
                        Create = assetGroupAsset
                    }
                });
            }

            // Link the previously created hotel property asset to the asset group. In the
            // real-world scenario, you'd need to do this step several times for each hotel property
            // asset.
            AssetGroupAsset hotelPropertyAssetGroupAsset = new AssetGroupAsset
            {
                Asset = hotelPropertyAssetResourceName,
                AssetGroup = assetGroupResourceName,
                FieldType = AssetFieldType.HotelProperty
            };

            // Adds an operation to link the hotel property asset to the asset group.
            mutateOperations.Add(new MutateOperation
            {
                AssetGroupAssetOperation = new AssetGroupAssetOperation
                {
                    Create = hotelPropertyAssetGroupAsset
                }
            });

            // Creates the rest of the required text assets and links them to the asset group.
            mutateOperations.AddRange(
                CreateOperationsForTextAssetsAndAssetGroupAssets(
                    customerId, hotelAssetSuggestion, assetGroupResourceName
                )
            );

            // Creates the image assets and links them to the asset group. Some optional image
            // assets suggested by the TravelAssetSuggestionService might be created too.
            mutateOperations.AddRange(
                CreateOperationsForImageAssetsAndAssetGroupAssets(
                   customerId, hotelAssetSuggestion, assetGroupResourceName, config
                )
            );

            if (hotelAssetSuggestion.Status == HotelAssetSuggestionStatus.Success)
            {
                // Creates a new mutate operation for a suggested call-to-action asset and links it
                // to the asset group.
                Asset callToActionAsset = new Asset
                {
                    ResourceName = ResourceNames.Asset(customerId, temporaryId),
                    Name = "Suggested call-to-action asset #" + ExampleUtilities.GetRandomString(),
                    CallToActionAsset = new CallToActionAsset
                    {
                        CallToAction = hotelAssetSuggestion.CallToAction
                    }
                };
                // Adds an operation to create the call-to-action asset.
                mutateOperations.Add(new MutateOperation
                {
                    AssetOperation = new AssetOperation
                    {
                        Create = callToActionAsset
                    }
                });

                AssetGroupAsset callToActionAssetGroupAsset = new AssetGroupAsset
                {
                    Asset = callToActionAsset.ResourceName,
                    AssetGroup = assetGroupResourceName,
                    FieldType = AssetFieldType.CallToActionSelection
                };
                // Adds an operation to link the call-to-action asset to the asset group.
                mutateOperations.Add(new MutateOperation
                {
                    AssetGroupAssetOperation = new AssetGroupAssetOperation
                    {
                        Create = callToActionAssetGroupAsset
                    }
                });
                temporaryId--;
            }

            return mutateOperations;
        }

        /// <summary>
        /// Creates text assets required for an asset group using the suggested hotel text assets.
        /// It adds  more text assets to fulfill the requirements if the suggested hotel text assets
        /// are not enough.
        /// <param name="customerId">The client customer ID.</param>
        /// <param name="hotelAssetSuggestion">The hotel asset suggestion.</param>
        /// <param name="assetGroupResourceName">The resource name of the asset group.</param>
        /// <returns>A list of mutate operations that create text assets and asset group
        /// assets.</returns>
        /// </summary>
        private List<MutateOperation> CreateOperationsForTextAssetsAndAssetGroupAssets(
            long customerId,
            HotelAssetSuggestion hotelAssetSuggestion,
            string assetGroupResourceName
        )
        {
            // Creates mutate operations for the suggested text assets except for headlines and
            // descriptions, which were created previously.
            List<MutateOperation> mutateOperations = new List<MutateOperation>();
            // Creates a map of asset field type to list of text values to create.
            Dictionary<AssetFieldType, List<string>> textByFieldType =
                new Dictionary<AssetFieldType, List<string>>();

            if (hotelAssetSuggestion.Status == HotelAssetSuggestionStatus.Success)
            {
                // Adds text values of suggested text assets.
                foreach (HotelTextAsset hotelTextAsset in hotelAssetSuggestion.TextAssets)
                {
                    AssetFieldType assetFieldType = hotelTextAsset.AssetFieldType;
                    if (assetFieldType == AssetFieldType.Headline ||
                        assetFieldType == AssetFieldType.Description)
                    {
                        // Headlines and descriptions were already created at the first step of this
                        // code example.
                        continue;
                    }
                    Console.WriteLine($"A text asset with text {hotelTextAsset.Text} is " +
                        $"suggested for the asset field type {assetFieldType}");
                    List<string> existingTexts = null;
                    if (!textByFieldType.TryGetValue(assetFieldType, out existingTexts))
                    {
                        existingTexts = textByFieldType[assetFieldType] = new List<string>();
                    }

                    existingTexts.Add(hotelTextAsset.Text);
                }
            }

            // Collects more text values by field type to fulfill the requirements.
            foreach (AssetFieldType assetFieldType in MIN_REQUIRED_TEXT_ASSET_COUNTS.Keys)
            {
                if (assetFieldType == AssetFieldType.Headline ||
                        assetFieldType == AssetFieldType.Description)
                {
                    // Headlines and descriptions were already created at the first step of
                    // this code example.
                    continue;
                }

                List<string> existingTexts = null;
                if (!textByFieldType.TryGetValue(assetFieldType, out existingTexts))
                {
                    existingTexts = textByFieldType[assetFieldType] = new List<string>();
                }

                int i = 0;
                while (textByFieldType[assetFieldType].Count <
                    MIN_REQUIRED_TEXT_ASSET_COUNTS[assetFieldType])
                {
                    string textFromDefaults = DEFAULT_TEXT_ASSETS_INFO[assetFieldType][i++];
                    Console.WriteLine($"A default text '{textFromDefaults}' is used to create a " +
                        $"text asset for the asset field type '{assetFieldType}'");
                    existingTexts.Add(textFromDefaults);
                }
            }

            // Converts the list of text values by field type into AssetOperations and
            // AssetGroupAssetOperations.
            foreach (AssetFieldType assetFieldType in textByFieldType.Keys)
            {
                foreach (string text in textByFieldType[assetFieldType])
                {
                    // Builds the asset.
                    Asset asset = new Asset
                    {
                        ResourceName = ResourceNames.Asset(customerId, temporaryId--),
                        TextAsset = new TextAsset
                        {
                            Text = text
                        }
                    };
                    // Adds an operation to create the Asset.
                    mutateOperations.Add(new MutateOperation
                    {
                        AssetOperation = new AssetOperation
                        {
                            Create = asset
                        }
                    });

                    //Builds the AssetGroupAsset.
                    AssetGroupAsset assetGroupAsset = new AssetGroupAsset
                    {
                        Asset = asset.ResourceName,
                        AssetGroup = assetGroupResourceName,
                        FieldType = assetFieldType
                    };
                    // Adds an operation to link the Asset to the AssetGroup.
                    mutateOperations.Add(new MutateOperation
                    {
                        AssetGroupAssetOperation = new AssetGroupAssetOperation
                        {
                            Create = assetGroupAsset
                        }
                    });
                }
            }

            return mutateOperations;
        }

        /// <summary>
        /// Creates image assets required for an asset group using the suggested hotel image assets.
        /// It adds more image assets to fulfill the requirements if the suggested hotel image
        /// assets are not enough.
        /// <param name="customerId">The client customer ID.</param>
        /// <param name="hotelAssetSuggestion">The hotel asset suggestion.</param>
        /// <param name="assetGroupResourceName">The resource name of the asset group.</param>
        /// <param name="config">The Google Ads config.</param>
        /// <returns>A list of mutate operations that create image assets and asset group
        /// assets.</returns>
        /// </summary>
        private List<MutateOperation> CreateOperationsForImageAssetsAndAssetGroupAssets(
            long customerId,
            HotelAssetSuggestion hotelAssetSuggestion,
            string assetGroupResourceName,
            GoogleAdsConfig config
        )
        {
            // Creates mutate operations for the suggested image assets.
            List<MutateOperation> mutateOperations = new List<MutateOperation>();
            // Creates a map of asset field type to list of image URLs for which this method will
            // create assets and asset group assets.
            Dictionary<AssetFieldType, List<string>> imageUrlsByFieldType =
                new Dictionary<AssetFieldType, List<string>>();

            if (hotelAssetSuggestion.Status == HotelAssetSuggestionStatus.Success)
            {
                // Adds URLs of suggested image assets.
                foreach (HotelImageAsset hotelImageAsset in hotelAssetSuggestion.ImageAssets)
                {
                    AssetFieldType assetFieldType = hotelImageAsset.AssetFieldType;
                    Console.WriteLine($"An image asset with URL '{hotelImageAsset.Uri} is " +
                        $"suggested for the asset field type {assetFieldType}");

                    List<string> existingImageUrls = null;
                    if (!imageUrlsByFieldType.TryGetValue(assetFieldType, out existingImageUrls))
                    {
                        existingImageUrls = imageUrlsByFieldType[assetFieldType] =
                            new List<string>();
                    }
                    existingImageUrls.Add(hotelImageAsset.Uri);
                }
            }

            // Collects more image URLs by field type to fulfill the requirements.
            foreach (AssetFieldType assetFieldType in MIN_REQUIRED_IMAGE_ASSET_COUNTS.Keys)
            {
                List<string> existingImageUrls = null;
                if (!imageUrlsByFieldType.TryGetValue(assetFieldType, out existingImageUrls))
                {
                    existingImageUrls = imageUrlsByFieldType[assetFieldType] =
                        new List<string>();
                }

                int i = 0;
                while (imageUrlsByFieldType[assetFieldType].Count <
                    MIN_REQUIRED_IMAGE_ASSET_COUNTS[assetFieldType])
                {
                    string imageUrlFromDefaults = DEFAULT_IMAGE_ASSETS_INFO[assetFieldType][i++];
                    Console.WriteLine($"A default image URL '{imageUrlFromDefaults} is used to " +
                        $"create an image asset for the asset field type {assetFieldType}");
                    existingImageUrls.Add(imageUrlFromDefaults);
                }
            }

            // Converts the list of URLs by field type into AssetOperations and
            // AssetGroupAssetOperations.
            foreach (AssetFieldType assetFieldType in imageUrlsByFieldType.Keys)
            {
                foreach (string imageUrl in imageUrlsByFieldType[assetFieldType])
                {
                    // Builds the image asset.
                    Asset asset = new Asset
                    {
                        ResourceName = ResourceNames.Asset(customerId, temporaryId--),
                        // Provide a unique friendly name to identify your asset.
                        // When there is an existing image asset with the same content but a
                        // different name, the new name will be dropped silently.
                        Name = $"{assetFieldType}{ExampleUtilities.GetRandomString()}",
                        ImageAsset = new ImageAsset
                        {
                            Data = ByteString.CopyFrom(
                                    MediaUtilities.GetAssetDataFromUrl(imageUrl, config)
                            )
                        }
                    };

                    // Adds an operation to create the asset.
                    mutateOperations.Add(new MutateOperation
                    {
                        AssetOperation = new AssetOperation
                        {
                            Create = asset
                        }
                    });

                    // Builds the AssetGroupAsset
                    AssetGroupAsset assetGroupAsset = new AssetGroupAsset
                    {
                        Asset = asset.ResourceName,
                        AssetGroup = assetGroupResourceName,
                        FieldType = assetFieldType
                    };

                    // Adds an operation to link the Asset to the AssetGroup.
                    mutateOperations.Add(new MutateOperation
                    {
                        AssetGroupAssetOperation = new AssetGroupAssetOperation
                        {
                            Create = assetGroupAsset
                        }
                    });
                }

            }

            return mutateOperations;
        }

        /// <summary>
        /// Prints the details of a MutateGoogleAdsResponse. Parses the "response" field name and
        /// uses it to extract the new entity's name and resource name.
        /// <param name="response">The mutate Google Ads response.</param>
        /// </summary>
        private void PrintResponseDetails(MutateGoogleAdsResponse response) {
            foreach (MutateOperationResponse operationResponse in response.MutateOperationResponses)
            {
                string resourceName;

                string entityName = operationResponse.ResponseCase.ToString();
                // Trim the substring "Result" from the end of the entity name.
                entityName = entityName.Remove(entityName.Length - 6);
                switch (operationResponse.ResponseCase)
                {
                    case MutateOperationResponse.ResponseOneofCase.AssetResult:
                        resourceName = operationResponse.AssetResult.ResourceName;
                        break;

                    case MutateOperationResponse.ResponseOneofCase.AssetGroupResult:
                        resourceName = operationResponse.AssetGroupResult.ResourceName;
                        break;

                    case MutateOperationResponse.ResponseOneofCase.AssetGroupAssetResult:
                        resourceName = operationResponse.AssetGroupAssetResult.ResourceName;
                        break;

                    case MutateOperationResponse.ResponseOneofCase.AssetSetAssetResult:
                        resourceName = operationResponse.AssetSetAssetResult.ResourceName;
                        break;

                    case MutateOperationResponse.ResponseOneofCase.CampaignBudgetResult:
                        resourceName = operationResponse.CampaignBudgetResult.ResourceName;
                        break;

                    case MutateOperationResponse.ResponseOneofCase.CampaignResult:
                        resourceName = operationResponse.CampaignResult.ResourceName;
                        break;

                    default:
                        resourceName = "<not found>";
                        break;
                }
                Console.WriteLine(
                    $"Created a(n) {entityName} with resource name: '{resourceName}'.");
            }
        }
    }
}
AddPerformanceMaxForTravelGoalsCampaign.cs