Get started with the Ads Data Hub API

This guide explains how to get started writing applications that use the Ads Data Hub REST API to interact with Ads Data Hub. The Ads Data Hub REST API allows you to view Ads Data Hub customers associated with your Google account, create queries, and run queries.

Before you start

To gain access to the Ads Data Hub API, you must contact the Ads Data Hub support. They'll help you configure your Ads Data Hub account and Google Cloud Project.

Client libraries and samples

The Google API client libraries are available in several popular languages, and allow you to work with many Google APIs. Because the Ads Data Hub API is a non-public API, some modifications may be necessary for the client libraries to access it.

All samples in this guide include instructions, and any supplemental files necessary to access the API.

Client Library Ads Data Hub samples
Google API Client Library for Java Java

OAuth 2.0 setup

The API supports both the installed application and web application flows, but for this example we’ll step through the installed application flow.

  1. Go to the Google API Console Enabled APIs page.
  2. From the project drop-down, select a Google Cloud project you intend to use with the Ads Data Hub REST API, or create a new one.
  3. Verify that Ads Data Hub API is in the list of enabled APIs and services. If not, click ENABLE APIS AND SERVICES to search for, and enable it. If it can’t be found, contact the Ads Data Hub support team to help configure your project.
  4. In the sidebar on the left, click Credentials.
  5. Select the Create credentials drop-down, then choose OAuth client ID. On the next page, select an Application type of Other. Optionally, enter a customized name for this client ID, then click Create. You will then be redirected to the Credentials page.
  6. Under OAuth 2.0 client IDs, find the client ID that you just created, and then click the associated download icon to download the JSON client secrets file. You can use this file to step through the installed application OAuth 2.0 flow and access the Ads Data Hub REST API.

Make an API call


 * Copyright (c) 2019 Google Inc.
 * 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
 * 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.


import java.util.List;

 * This sample illustrates how to retrieve all accounts associated to the user.
 * <p>See the <a href="customers.list reference
 * documentation"></a>
 * for more details.
public class ListCustomers extends BaseSample {

  public String getName() {
    return "List customers";

  public String getDescription() {
    return "Lists customers associated with the authorized user";

  public void execute(AdsDataHub client) throws IOException {
    String pageToken = null;
    boolean noData = true;

    System.out.printf("Listing of customers associated with the authorized user:\n");

    do {
      ListCustomersResponse response = client.customers().list().setPageToken(pageToken).execute();
      pageToken = response.getNextPageToken();
      List<Customer> customers = response.getCustomers();

      if (customers != null && customers.size() > 0) {
        noData = false;
        for (Customer customer : customers) {
          System.out.printf("* Customer id: %d\n", customer.getCustomerId());
          System.out.printf("\tCustomer name: %s\n", customer.getDisplayName());
    } while (pageToken != null);

    if (noData) {
      System.out.println("No customers were found associated with the authorized user.");


Next steps

  • See sample queries in Ads Data Hub for examples of queries you can create and run with the Ads Data Hub REST API.
  • Expand on the samples to familiarize yourself with the API and customize it for your use case. Then try to:
  • Contact ADH support if you have questions or feedback about the API.