How to Implement Google Ads API to Manage Campaigns in Java

Set Up Your Java Project for Google Ads API

• Ensure you have the google-ads-java library added to your project. You can add the Maven or Gradle dependency in your project's pom.xml or build.gradle file:

<dependency>
  <groupId>com.google.api-ads</groupId>
  <artifactId>google-ads</artifactId>
  <version>7.0.0</version>
</dependency>

implementation 'com.google.api-ads:google-ads:7.0.0'

Initialize the Google Ads Client

• Create a client configuration file named google-ads.properties in your project's resources directory with your API credentials.
• Initialize the Google Ads API client in your Java application using the following code:

import com.google.ads.googleads.lib.GoogleAdsClient;
import com.google.auth.oauth2.UserCredentials;

import java.io.FileInputStream;
import java.io.IOException;

public class GoogleAdsInitializer {

    public static GoogleAdsClient initializeAdsClient() throws IOException {
        // Initialize the Google Ads client
        return GoogleAdsClient.newBuilder()
                .fromPropertiesFile(new FileInputStream("path/to/google-ads.properties"))
                .build();
    }
}

Fetch and List Campaigns

• Use the Google Ads Client to retrieve and list campaigns:

import com.google.ads.googleads.v7.services.GoogleAdsServiceClient;
import com.google.ads.googleads.v7.services.SearchGoogleAdsRequest;
import com.google.ads.googleads.v7.services.SearchGoogleAdsResponse;
import com.google.ads.googleads.v7.resources.Campaign;

import java.io.IOException;

public class CampaignManager {

    public static void fetchCampaigns(GoogleAdsClient client, long customerId) {
        try (GoogleAdsServiceClient googleAdsServiceClient = client.getLatestVersion().createGoogleAdsServiceClient()) {
            // Create a request to retrieve campaigns
            SearchGoogleAdsRequest request = SearchGoogleAdsRequest.newBuilder()
                    .setCustomerId(String.valueOf(customerId))
                    .setQuery("SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id")
                    .build();

            // Issue the search request
            SearchGoogleAdsResponse response = googleAdsServiceClient.search(request);

            // Display the results
            for (Campaign campaign : response.iterateAll()) {
                System.out.printf("Campaign found with ID %d and name '%s'.%n", campaign.getId(), campaign.getName());
            }
        } catch (IOException e) {
            System.err.println("Failed to create GoogleAdsServiceClient: " + e);
        }
    }
}

Manage Campaigns by Modifying Attributes

• To update a campaign’s status, for example, use the following code snippet:

import com.google.ads.googleads.v7.services.MutateCampaignsRequest;
import com.google.ads.googleads.v7.services.CampaignOperation;
import com.google.ads.googleads.v7.resources.Campaign;
import com.google.ads.googleads.v7.enums.CampaignStatusEnum.CampaignStatus;
import com.google.ads.googleads.v7.services.GoogleAdsServiceClient;
import java.io.IOException;
import java.util.Collections;

public class CampaignUpdater {

    public static void updateCampaignStatus(GoogleAdsClient client, long customerId, long campaignId, CampaignStatus status) {
        try (GoogleAdsServiceClient googleAdsServiceClient = client.getLatestVersion().createGoogleAdsServiceClient()) {
            // Build a campaign instance with the updated status
            Campaign campaign = Campaign.newBuilder()
                    .setResourceName(ResourceNames.campaign(customerId, campaignId))
                    .setStatus(status)
                    .build();

            // Create a campaign operation
            CampaignOperation operation = CampaignOperation.newBuilder().setUpdate(campaign).build();

            // Create a mutate request
            MutateCampaignsRequest request = MutateCampaignsRequest.newBuilder()
                    .setCustomerId(String.valueOf(customerId))
                    .addAllOperations(Collections.singletonList(operation))
                    .build();

            // Send the mutate request
            googleAdsServiceClient.mutateCampaigns(request);
            System.out.println("Campaign status updated successfully.");
        } catch (IOException e) {
            System.err.println("Failed to create GoogleAdsServiceClient: " + e);
        }
    }
}

Handle API Errors and Debugging

• Utilize appropriate exception handling mechanisms to catch and understand API errors. Log meaningful error messages for debugging purposes.

import com.google.ads.googleads.v7.errors.GoogleAdsException;

public class ErrorHandler {

    public static void handleExceptions() {
        try {
            // Your code to call Google Ads API
        } catch (GoogleAdsException e) {
            // Log each failure message
            e.getGoogleAdsFailure().getErrorsList().forEach(
                error -> System.err.printf("Error: %s%n", error.getMessage())
            );
        } catch (Exception e) {
            // Handle other exceptions
            e.printStackTrace();
        }
    }
}

Optimize API Calls

• Ensure efficient data retrieval by using appropriate queries and using pagination where necessary to manage large sets of data.
• Avoid unnecessary calls by caching frequently accessed data when speed and efficiency are crucial.

Conclusion

• By following the provided example code and guidelines, you can effectively manage Google Ads campaigns using Google's Ads API in Java. Adapt these templates to suit your specific use case and ensure to comply with Google Ads policies while implementing automated interactions.