Data Manager API Setup
Developmentdata-manager-api-setupData Manager API Setup is an Agent Skill for development published in the google/skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
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).
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/google/skills/blob/HEAD/skills/ads/data-manager-api-setup/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/data-manager-api-setup, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Data Manager API Setup
Setup Authentication
Refer to Set up API access for more details.
- Enable API (Prerequisite): Check that the user has enabled the Data Manager API in their Google Cloud project.
- 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/datamanagerandhttps://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 ConsumerIAM role, and the user executinggcloudhas the Token Creator role (roles/iam.serviceAccountTokenCreator) on that Service Account for impersonation.
- Required Scopes: Include scopes
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 (packages:
google-ads-datamanagerandgoogle-ads-datamanager-util) - Java Setup Reference (packages:
com.google.api-ads:data-manageranddata-manager-util) - Node Setup Reference (packages:
@google-ads/datamanagerand@google-ads/data-manager-util) - PHP Setup Reference (packages:
googleads/data-managerandgoogleads/data-manager-util) - .NET Setup Reference (packages:
Google.Ads.DataManager.V1andGoogle.Ads.DataManager.Util.csproj)