Skip to content

Latest commit

 

History

History
102 lines (76 loc) · 3.57 KB

README.md

File metadata and controls

102 lines (76 loc) · 3.57 KB
Raw

Bid Manager REST API v2 Java Samples

These samples demonstrate basic usage of Bid Manager API v2.

The complete documentation for the Bid Manager API is available from https://developers.google.com/bid-manager/.

Prerequisites

Announcements and updates

For API and client library updates and news, please follow our Google Ads Developers blog: http://googleadsdeveloper.blogspot.com/.

Running the examples

Download the repository contents

To download the contents of the repository, you can use the command

git clone https://github.com/googleads/googleads-bidmanager-examples

Authentication Setup

This API uses OAuth2.0.

Follow these steps to enable the API for your Google Cloud Platform project and generate the necessary credentials:

  1. Visit Google Developers Console to select or create your project.
  2. From the API Manager → Google APIs screen, activate access to "DoubleClick Bid Manager API".
  3. Click on "Credentials" in the left navigation menu.
  4. Click the button labeled "Create credentials" and select "OAuth Client ID".
  5. Select "Desktop App" as the "Application type", then "Create".
  6. From the Credentials page, click the "Download OAuth Client" icon under "Actions" next to the client ID you just created and click "Download JSON".
  7. Save the downloaded file as client_secrets.json in your home directory.

Authenticate using a service account

These samples support authentication using a service account key. To run samples using a service account, follow these steps after completing steps 1 and 2 from the section above:

  1. Click on "Credentials" in the left navigation menu.
  2. Click the button labeled "Create credentials" and select "Service Account".
  3. Provide a "Service account name", "Service account ID", and "Service account description", then "Create and Continue".
  4. From the Credentials page, click the new service account email.
  5. Navigate to the "Keys" tab, click "Add Key", and create a new JSON key, which will download automatically.
  6. Save the downloaded file as service_account_key.json in your home directory.
  7. When starting a sample, include the --useServiceAccount argument to designate that you are authenticating with a service account.

Setup the environment

Set the Application name

Edit DoubleClickBidManagerFactory.java and change APPLICATION_NAME

Via the command line

Execute the following command:

$ mvn compile

Via Eclipse

  1. Setup Eclipse preferences:
    1. Window > Preferences .. (or on Mac, Eclipse > Preferences)
    2. Select Maven
    3. Select "Download Artifact Sources"
    4. Select "Download Artifact JavaDoc"
  2. Import the sample project
    1. "File > Import..."
    2. Select "Maven > Existing Maven Project" and click "Next"
    3. Click "Browse" next to "Select root directory", find the sample directory and click "Next"
    4. Click "Finish"

Running the Examples

Once you've checked out the code:

  1. Run GetLatestReport.java

    1. Via the command line, execute the following command:

      $ mvn exec:java -Dexec.mainClass="com.google.bidmanager.api.samples.GetLatestReportForQuery" -Dexec.args="--queryId INSERT_QUERY_ID_HERE --outputFile INSERT_OUTPUT_FILE_HERE"

    2. Via eclipse, right-click on the project and select Run As > Java Application