The Data Manager API is in closed beta. To express interest in joining the closed beta, fill out this form.

Set up API access

Here's how to set up access to the Data Manager API with an SDK or REST.

Set up the Google Cloud command line interface

Install and initialize the Google Cloud command line interface.
To ensure your gcloud components are up to date, run the following command.
```
gcloud components update
```
(Optional) Use the gcloud config set command to set a default project and region.

Set up authentication

You can authenticate with user accounts and service accounts:

User accounts: Represent people who interact with Google APIs and services directly.
Service accounts: Represent apps, not people, as the users. They let your apps manage authentication and authorization. For example, if an app needs to access Google Cloud resources.

Your integration can use Application Default Credentials (ADC) to automatically find credentials from the environment. You don't have to change the client code to authenticate.

Choose User account or Service account to set up ADC:

To learn more about authentication and credentials for your app, see Authentication methods at Google and Set up Application Default Credentials.

Set up operating account access

Grant the email associated with your user or service account access to the Destination.

Set up the SDK for your programming language

On your local machine, install the SDK of your choice:

REST

Update the placeholders in the following sample, such as OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID, and AUDIENCE_ID, with the values for your account and destination.
Replace PROJECT_ID with the ID of your Google Cloud.

Copy the sample to the command line to send the request.

Remove the linkedAccount attribute of the entry in the destinations if you aren't accessing the operationAccount using an established product link.

#!/bin/bash
curl -X POST "https://datamanager.googleapis.com/v1/audienceMembers:ingest" \
  --header "Authorization: Bearer $(gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/datamanager)" \
  --header "x-goog-user-project: PROJECT_ID" \
  --header "Content-Type: application/json" \
  --data @- &lt;&lt;EOF
{
  "destinations": [
    {
      "operatingAccount": {
        "product": "OPERATING_ACCOUNT_PRODUCT",
        "accountId": "OPERATING_ACCOUNT_ID"
      },
      "loginAccount": {
        "product": "LOGIN_ACCOUNT_PRODUCT",
        "accountId": "LOGIN_ACCOUNT_ID"
      },
      "linkedAccount": {
        "product": "LINKED_ACCOUNT_PRODUCT",
        "accountId": "LINKED_ACCOUNT_ID"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ],
  "audienceMembers": [
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
          },
          {
            "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3"
          },
          {
            "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51"
          },
          {
            "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0"
          },
          {
            "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "83a834cc5327bc4dee7c5408988040dc5813c7662611cd93b707aff72bf7d33f"
          },
          {
            "emailAddress": "223ebda6f6889b1494551ba902d9d381daf2f642bae055888e96343d53e9f9c4"
          }
        ]
      }
    }
  ],
  "consent": {
    "adUserData": "CONSENT_GRANTED",
    "adPersonalization": "CONSENT_GRANTED"
  },
  "encoding": "HEX",
  "termsOfService": {
    "customerMatchTermsOfServiceStatus": "ACCEPTED"
  },
  "validateOnly": true
}
EOF

Java

Download and extract google-cloud-ads-datamanager-v1-java.tar.gz.
Navigate to the google-cloud-ads-datamanager-v1-java directory.
Run the following command to build and publish the library to your local Maven repository for use with Maven or Gradle.
```
./gradlew -Pversion=0.1.0 install
```

In your Java project, declare a dependency on the Data Manager API library.

Gradle:

implementation 'com.google.cloud:gapic-google-cloud-ads-datamanager-v1-java:0.1.0'

Maven:

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>gapic-google-cloud-ads-datamanager-v1-java</artifactId>
  <version>0.1.0</version>
</dependency>

Optional. Get the utility library and code samples.
1. Download and extract data-manager-java.tar.gz.
2. Navigate to the data-manager-java directory.
3. For Maven or Gradle, run the following command. This command builds and publishes the utility library to your local Maven repository.
```
./gradlew data-manager-util:install
```
4. In your Java project, declare a dependency on the utility library.
  
  Gradle:
```
implementation 'com.google.api-ads:data-manager-util:0.1.0'
```
  Maven:
```
<dependency>
   <groupId>com.google.api-ads</groupId>
   <artifactId>data-manager-util</artifactId>
   <version>0.1.0</version>
</dependency>
```
5. To format and encrypt the data, use the UserDataFormatter and Encrypter utilities in your Java project.
6. Browse code samples in the data-manager-samples subdirectory. To run a sample from the command line, use the Gradle run task.
  
  For example, the following command runs the IngestAudienceMembers sample and prints a usage statement:
```
./gradlew data-manager-samples:run \
  --args='IngestAudienceMembers --help'
```
  To help you get started with some sample data, use the file at data-manager-samples/src/main/resources/sampledata/audience_members_1.csv.

Python

Download ads-datamanager-v1-py.tar.gz.
Navigate to the directory of the download.
Run the following command to build the library and make it available to other projects in the same Python environment:
```
pip install ./ads-datamanager-v1-py.tar.gz
```
In your Python project, declare a dependency on the Data Manager API library. For example, if using a requirements.txt file in your project, add the following line to the file:
```
google-ads-data-manager=0.1.0
```
Optional. Get the utility library and code samples.
1. Download and extract data-manager-python.tar.gz.
2. Navigate to the data-manager-python directory.
3. To install the utility library in your Python environment, run the following command:
```
pip install .
```
4. In your Python project, declare a dependency on the utility library. For example, if using a requirements.txt file in your project, add the following line to the file:
```
google-ads-data-manager-util=0.1.0
```
5. To format and encrypt the data, use the Formatter and Encrypter utilities in your Python project.
6. Browse code samples in the samples subdirectory. Pass the --help argument when running a sample to print a usage statement with expected parameters.
  
  To help you get started with some sample data, use the file at samples/sampledata/audience_members_1.csv.

Node.js

Download and extract ads-datamanager-v1-nodejs.tar.gz.
Navigate to the ads-datamanager-v1-nodejs directory.
Run the following commands to compile and pack the library into a .tgz file for use with npm.
```
npm install
npm pack
```
The commands generate an archive named google-cloud-datamanager-0.1.0.tgz.
In your Node.js project, declare a dependency on the Data Manager API library by adding a dependencies entry for the full path and filename of the google-cloud-datamanager-0.1.0.tgz file.

PHP

Download and extract google-cloud-ads-datamanager-v1-php.tar.gz.
Navigate to the google-cloud-ads-datamanager-v1-php directory.
Run the following command to resolve dependencies for the library:
```
composer update --prefer-dist
```
In the composer.json file of your PHP project on the same host, declare a dependency on the Data Manager API library using the following steps:

a. Add a repositories section that points to the location of the google-cloud-ads-datamanager-v1-php directory.
```
 "repositories" : [
    {
       "type" : "path",
       "url" : "PATH_TO_LIBRARY"
    }
 ]
```
b. Declare a dependency on the Data Manager API library.
```
 "require": {
    "googleads/data-manager": "^0.1.0"
 }
```