Get Started

Java

Here is a basic example that shows how to use the Java client library.

1. Setup your credentials

   Run the following command in a shell:

   curl https://raw.githubusercontent.com/googleads/googleads-java-lib/master/examples/dfp_axis/src/main/resources/ads.properties -o ~/ads.properties

   Open the ~/ads.properties file and populate the following fields:

   [...]
   api.dfp.applicationName=INSERT_APPLICATION_NAME_HERE
   api.dfp.jsonKeyPairPath=INSERT_PATH_TO_JSON_KEY_FILE_HERE
   api.dfp.networkCode=INSERT_NETWORK_CODE_HERE
   [...]

2. Specify dependencies

   Edit your pom.xml file and add the following to the dependencies tag. You can find the latest version number on Github.

   <dependency>
     <groupId>com.google.api-ads</groupId>
     <artifactId>ads-lib</artifactId>
     <version>RELEASE</version>
   </dependency>
   <dependency>
     <groupId>com.google.api-ads</groupId>
     <artifactId>dfp-axis</artifactId>
     <version>RELEASE</version>
   </dependency>

3. Write some code and make a request!

   import com.google.api.ads.common.lib.auth.OfflineCredentials;
   import com.google.api.ads.common.lib.auth.OfflineCredentials.Api;
   import com.google.api.ads.dfp.axis.factory.DfpServices;
   import com.google.api.ads.dfp.axis.v201705.Network;
   import com.google.api.ads.dfp.axis.v201705.NetworkServiceInterface;
   import com.google.api.ads.dfp.lib.client.DfpSession;
   import com.google.api.client.auth.oauth2.Credential;
   
   public class App {
     public static void main(String[] args) throws Exception {
       Credential oAuth2Credential = new OfflineCredentials.Builder()
           .forApi(Api.DFP)
           .fromFile()
           .build()
           .generateCredential();
   
       // Construct a DfpSession.
       DfpSession session = new DfpSession.Builder()
           .fromFile()
           .withOAuth2Credential(oAuth2Credential)
           .build();
   
       // Construct a DFP service factory, which can only be used once per
       // thread, but should be reused as much as possible.
       DfpServices dfpServices = new DfpServices();
   
       // Retrieve the appropriate service
       NetworkServiceInterface networkService = dfpServices.get(session,
           NetworkServiceInterface.class);
   
       // Make a request
       Network network = networkService.getCurrentNetwork();
   
       System.out.printf("Current network has network code '%s' and display" +
           " name '%s'.%n", network.getNetworkCode(), network.getDisplayName());
     }
   }
   

For more detailed information about using the Java Client Library, refer to the README file in the client library distribution.

Python

Here is a basic example that shows how to use the Python client library.

The Python Client Library supports Python v2.7 or Python v3.0+ via the 2to3 converter.

1. Install the library and setup your credentials.

   Run the following commands in a shell:

   pip install googleads
   curl https://raw.githubusercontent.com/googleads/googleads-python-lib/master/googleads.yaml -o ~/googleads.yaml
     

2. Setup your ~/googleads.yaml file.

   Fill in the following fields:

   dfp:
     application_name: INSERT_APPLICATION_NAME_HERE
     network_code: INSERT_NETWORK_CODE_HERE
     path_to_private_key_file: INSERT_PATH_TO_FILE_HERE
   

3. Run some code and make a request!

   # Import the library.
   from googleads import dfp
   
   # Initialize a client object, by default uses the credentials in ~/googleads.yaml.
   dfp_client = dfp.DfpClient.LoadFromStorage()
   
   # Initialize a service.
   network_service = dfp_client.GetService('NetworkService', version='v201705')
   
   # Make a request.
   current_network = network_service.getCurrentNetwork()
   
   print 'Found network %s (%s)!' % (current_network['displayName'],
                                     current_network['networkCode'])
   

PHP

Follow the steps in the ads PHP client library README to get started.

.NET

Here is a basic example that shows how to use the .NET client library

1. Create a new project

   Open Visual Studio and create a new project (i.e. Console Application).

2. Add required library references to your project

   If you're using NuGet, simply add a dependency for Google.Dfp, or Google.Dfp.Examples.CSharp if you want to run code examples.

   Otherwise, download the binary distribution from GitHub and copy all dlls from the \lib folder into your project. Add references to these dlls and to System.Web.Services in your project.

3. Setup your App.config

   Copy src\App.config to your project directory and add it to your project. If your application has its own App.config, then you can copy the following nodes into your App.config:

   • configuration/DfpApi
   • configuration/system.web
   • configuration/configSections/section[name="DfpApi"]
   • configuration/system.net
4. Setup credentials

   Open App.config and edit the following keys:

   <add key="ApplicationName" value="INSERT_YOUR_APPLICATION_NAME_HERE" />
   <add key="NetworkCode" value="INSERT_YOUR_NETWORK_CODE_HERE" />
   <add key="OAuth2Mode" value="SERVICE_ACCOUNT" />
   <add key="OAuth2SecretsJsonPath" value="INSERT_OAUTH2_SECRETS_JSON_FILE_PATH_HERE" />
   

5. Make a call to the library

   You can call the library as shown in the following C# code snippet

   View on GitHub

   DfpUser user = new DfpUser();
   InventoryService inventoryService =
       (InventoryService) dfpUser.GetService(DfpService.v201705.InventoryService);
   
   // Create a statement to select ad units.
   int pageSize = StatementBuilder.SUGGESTED_PAGE_LIMIT;
   StatementBuilder statementBuilder = new StatementBuilder()
       .OrderBy("id ASC")
       .Limit(pageSize);
   
   // Retrieve a small amount of ad units at a time, paging through until all
   // ad units have been retrieved.
   int totalResultSetSize = 0;
   do {
     AdUnitPage page = inventoryService.getAdUnitsByStatement(
         statementBuilder.ToStatement());
   
     // Print out some information for each ad unit.
     if (page.results != null) {
       totalResultSetSize = page.totalResultSetSize;
       int i = page.startIndex;
       foreach (AdUnit adUnit in page.results) {
         Console.WriteLine(
             "{0}) Ad unit with ID \"{1}\" and name \"{2}\" was found.",
             i++,
             adUnit.id,
             adUnit.name
         );
       }
     }
   
     statementBuilder.IncreaseOffsetBy(pageSize);
   } while (statementBuilder.GetOffset() < totalResultSetSize);
   
   Console.WriteLine("Number of results found: {0}", totalResultSetSize);
   

If you don't want to set your credentials in your App.config, then refer to this wiki article for alternate ways of using the DfpUser class. For more detailed information about using the .NET Client Library, refer to the README . If you want to develop in .NET without the client library, please refer to the NoClientLibrary wiki article.

Ruby

Here is a basic example that shows how to use the Ruby client library.

The Ruby Client Library requires Ruby 2.1 or 2.2 as well as the Google Ads Savon SOAP toolkit of version 1.0.0 or later.

Before you can run the example, you must follow the steps in the README file that is distributed with the Ruby Client Library. You will need to edit dfp_api.yml to include your authentication credentials.

1. Set up your credentials

   Copy the dfp_api.yml file to your home directory and populate the required fields.

   [...]
   :oauth2_keyfile: INSERT_PATH_TO_JSON_KEY_FILE_HERE
   :application_name: INSERT_APPLICATION_NAME_HERE
   :network_code: INSERT_NETWORK_CODE_HERE
   [...]
   

   First, create a new DfpApi instance. This loads the credentials from the ~/dfp_api.yml file. Refer to the README file for alternate ways to specify credentials.

   # Get DfpApi instance and load configuration from ~/dfp_api.yml.
   dfp = DfpApi::Api.new
   

2. Construct an InventoryService instance

   Each service can be retrieved through the service() method. This method returns a service stub object that can be used to call its methods. Specify the service name as the first parameter and required API version as the second parameter.

   inventory_service =
       dfp.service(:InventoryService, :v201705)
   

3. Perform an operation

   After you've instantiated a client to connect to the API, you can perform an operation. The following code returns all ad units present within the account into a page object, 500 at a time.

   View on GitHub

   # Create a statement to select ad units.
   statement = DfpApi::FilterStatement.new()
   
   # Retrieve a small amount of ad units at a time, paging
   # through until all ad units have been retrieved.
   total_result_set_size = 0;
   begin
     page = inventory_service.get_ad_units_by_statement(
         statement.toStatement())
   
     # Print out some information for each ad unit.
     if page[:results]
       total_result_set_size = page[:total_result_set_size]
       page[:results].each_with_index do |ad_unit, index|
         puts "%d) Ad unit with ID '%s' and name '%s' was found." % [
             index + statement.offset,
             ad_unit[:id],
             ad_unit[:name]
         ]
       end
     end
     statement.offset += DfpApi::SUGGESTED_PAGE_LIMIT
   end while statement.offset < page[:total_result_set_size]
   
   puts 'Total number of ad units: %d' %
       total_result_set_size

If you want to develop in Ruby without the client library, please refer to the wiki article.