Get Started with the API

Open the pom.xml and add these dependencies:

<dependencies>
   <dependency>
      <groupId>com.google.apis</groupId>
      <artifactId>google-api-services-doubleclickbidmanager</artifactId>
      <version>v1-rev29-1.20.0</version>
    </dependency>
      <dependency>
      <groupId>com.google.oauth-client</groupId>
      <artifactId>google-oauth-client-jetty</artifactId>
      <version>1.20.0</version>
    </dependency>
        <dependency>
      <groupId>com.google.http-client</groupId>
      <artifactId>google-http-client-jackson2</artifactId>
      <version>1.19.0</version>
    </dependency>
  </dependencies>

All calls to the API require authentication; load up the client secrets file you downloaded to create a GoogleClientSecrets object.

GoogleClientSecrets clientSecrets = GoogleClientSecrets.load(
        JSON_FACTORY, 
        new InputStreamReader(SecurityUtilities.class.
            getResourceAsStream("/client_secrets.json")));

Create a Credential object using the GoogleClientSecrets.

    // set up authorization code flow.
    GoogleAuthorizationCodeFlow flow = new GoogleAuthorizationCodeFlow.Builder(
        HTTP_TRANSPORT, JSON_FACTORY, clientSecrets, SCOPES)       
        .setDataStoreFactory(dataStoreFactory)
        .build();
    // authorize and get credentials.
    Credential credential =
        new AuthorizationCodeInstalledApp(flow, new LocalServerReceiver())
          .authorize("user");

Use the Credential object to create an authenticated DoubleClickBidManager using the Builder pattern:

DoubleClickBidManager bmService = new DoubleClickBidManager
        .Builder(HTTP_TRANSPORT, JSON_FACTORY, 
            setHttpTimeout(getUserCredential()))
        .setApplicationName(APPLICATION_NAME + "_JavaSamples").build();

After you've instantiated a client to connect to the API, you can perform an operation. The following code runs listqueries and displays the output.

// Call the API, getting a list of queries.
      ListQueriesResponse queryListResponse = service.queries()
          .listqueries().execute();
      // Print them out.
      System.out.println("Id\t\tName");
      for (Query q : queryListResponse.getQueries()) {
        System.out.format("%s\t%s%n", q.getQueryId(), 
            q.getMetadata().getTitle());
      }

Example using pip:

$ pip --upgrade google-api-python-client

Use the Client ID and Secret from above to prompt for authorization.

flow = client.OAuth2WebServerFlow(
      client_id=client_id, client_secret=client_secret,
      scope=[_SCOPE], user_agent=_USER_AGENT,
      redirect_uri='urn:ietf:wg:oauth:2.0:oob')

  authorize_url = flow.step1_get_authorize_url()

  print ('Log into the Google Account you use to access your DBM account'
         'and go to the following URL: \n%s\n' % (authorize_url))
  print 'After approving the token enter the verification code (if specified).'
  code = raw_input('Code: ').strip()

  try:
    credentials = flow.step2_exchange(code)
  except client.FlowExchangeError, e:
    print 'Authentication has failed: %s' % e
    sys.exit(1)
  else:
    return credentials

Create a client for the Bid Manager API passing in the latest version of the API.

build('doubleclickbidmanager', _VERSION,
               http=credentials.authorize(httplib2.Http()))

After you've instantiated a client to connect to the API, you can perform an operation. The following code runs listqueries and displays the output.

doubleclick_bid_manager.queries().getquery(queryId=query_id)
                .execute())

Download and install google-api-php-client.

Add this to your include path

set_include_path('<PATH_TO_PHP_CLIENT>' . PATH_SEPARATOR . get_include_path());

Create a Google_Client object.

$client = new Google_Client();

All calls to the API require authentication; load up the client secrets file you downloaded and add a scope for your requests.

$client->setApplicationName('DBM API PHP Samples');
$client->addScope('https://www.googleapis.com/auth/doubleclickbidmanager');

You can then create your DoubleClickBidManager client using the authorized Google_Client object:

$service = new Google_Service_DoubleClickBidManager($client);

After you've instantiated a client to connect to the API, you can perform an operation. The following code runs listqueries and displays the output.

      // Call the API, getting a list of queries.
      $result = $this->service->queries->listqueries();
      if (isset($result['queries']) && count($result['queries']) > 0) {
        print '<pre>';
        foreach ($result['queries'] as $query) {
          printf('<p>%s %s</p>', $query->queryId, $query->metadata->title);
        }
        print '</pre>';