aidentity / index

google/skills · Apache-2.0

data-manager-api-setup

Guides developers through client library installation and authentication setup steps for the Data Manager API. Use this skill when a user is getting started with the Data Manager API and needs to setup their local environment, install the client library, or setup access to the API. Don't use for implementing audience or event ingestion logic (use the data-manager-api-audience-ingestion or data-manager-api-event-ingestion skills instead).

ads cloud stable

Contents

Data Manager API Setup

Setup Authentication

Refer to Set up API access

for more details.

  1. Enable API (Prerequisite): Check that the user has enabled the Data

Manager API in their Google Cloud project.

  1. Generate ADC: Authenticate the local workspace using Application

Default Credentials (ADC) via gcloud auth application-default login.

  • Required Scopes: Include scopes

https://www.googleapis.com/auth/datamanager and

https://www.googleapis.com/auth/cloud-platform.

  • Multi-API Scopes: If using the same credentials for other APIs,

append their scopes (e.g.,

https://www.googleapis.com/auth/adwords).

  • Service Accounts: Ensure the Service Account has the

Service Usage Consumer IAM role, and the user executing gcloud

has the Token Creator role

(roles/iam.serviceAccountTokenCreator) on that Service Account

for impersonation.

Install Client & Utility Libraries

Refer to Install a client library

for more details.

The companion utility libraries provide pre-built helper classes

and functions to correctly format, hash, and encrypt user identifiers (such as

emails, phone numbers, and physical addresses) prior to API ingestion. Use of

these libraries is highly recommended to ensure that user identifier formatting

matches the API's specifications.

Select the language-specific installation guide below:

  • [Python Setup Reference](references/python.md) (packages: google-ads-datamanager and google-ads-datamanager-util)
  • [Java Setup Reference](references/java.md) (packages: com.google.api-ads:data-manager and data-manager-util)
  • [Node Setup Reference](references/node.md) (packages: @google-ads/datamanager and @google-ads/data-manager-util)
  • [PHP Setup Reference](references/php.md) (packages: googleads/data-manager and googleads/data-manager-util)
  • [.NET Setup Reference](references/dotnet.md) (packages: Google.Ads.DataManager.V1 and Google.Ads.DataManager.Util.csproj)

Provenance

Authored by Google LLC in google/skills. The content is mirrored here under its upstream license.

Related

data-manager-api-audience-ingestion Guides developers through managing (adding, removing, and clearing) audience members for Google products using the Data Manager API and its associated client libraries. Use this skill when the user wants to upload audience members, remove specific users, or clear/replace an entire audience for Customer Match, mobile device ID audiences, or any other audience use case supported by the Data Manager API. Don't use for uploading events or conversions (use the data-manager-api-event-ingestion skill). google/skills Apache-2.0 data-manager-api-event-ingestion Guides developers through implementing event and conversion ingestion to Google products using the Data Manager API /v1/events/ingest endpoint and its associated client libraries. Use this skill when the user wants to upload offline conversions, enhanced conversions for leads, click conversions, Google Analytics web or app events, or any other event ingestion use case supported by the Data Manager API. Don't use for uploading audience members (use the data-manager-api-audience-ingestion skill). google/skills Apache-2.0 google-ads-api-account-diagnostics Diagnoses Google Ads account performance issues such as conversion loss (value or volume), low lead flow/volume, and lost impression share (opportunities) due to ad rank, bids, or budgets. Use when troubleshooting sudden performance drops, analyzing campaign impression share metrics, investigating low lead flow, or searching for bidding and budget constraints. Don't use for setting up new campaigns, uploading conversion events directly, or general Google Mobile Ads SDK integration issues (use gma-android-integrate instead). google/skills Apache-2.0 google-ads-api-mcp-setup Guides developers through downloading, configuring, and installing the official open-source Google Ads MCP Server. Use this skill when a user wants to connect their AI assistant (such as Gemini, Claude Code, or Cursor) to their Google Ads account to query campaigns or retrieve reporting metrics using natural language. google/skills Apache-2.0 google-ads-api-quickstart Guides developers through Google Ads API quickstart: credential setup, choosing from 6 client libraries/REST, configuring environments, and running a "retrieve campaigns" script. Troubleshoots common setup errors: USER_PERMISSION_DENIED, login_customer_id issues, and DEVELOPER_TOKEN_NOT_APPROVED. Use this skill when: - The user asks how to get started with the Google Ads API. - The user needs to set up Google Ads credentials or developer tokens. - The user wants to write a quickstart/example script for Google Ads. - The user encounters errors like USER_PERMISSION_DENIED or DEVELOPER_TOKEN_NOT_APPROVED. google/skills Apache-2.0