data-manager-api-setup

Synced v1.0.0 License: Apache-2.0 Source: google/skills/skills/ads/data-manager-api-setup Commit: 99c871e Latest included change:

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).

Summary

Purpose
Explains how to prepare local access to the Data Manager API and install its client and companion utility libraries.
When to use
Use it when you need help with ADC scopes or service-account impersonation, or need to identify the client and utility packages for your language.
Outputs
It provides API enablement and authentication steps, plus links and package names for Python, Java, Node.js, PHP, and .NET installation guides.
Upstream changes (5, latest included 2026-09-25)
72ae9f9 Update utility library install steps to install from each package manager Updated the skill's metadata version and corrected the Java and .NET utility package names.
5401dca Update Data Manager API setup skill for @google-ads/datamanager-util npm release. Bumped the skill metadata version and corrected the Node utility package name to `@google-ads/datamanager-util`.
329fa26 Standardize version formatting in Ads skills metadata Changed the metadata version from `1.0` to the quoted `1.0.0` format.
703f8d2 Move ads skills from per-product subdirectories to top-level skills/ads/ directory. Moved the unchanged setup skill from `skills/ads/data-manager-api/data-manager-api-setup/SKILL.md` to `skills/ads/data-manager-api-setup/SKILL.md`.
e1ac3d0 feat: Introduce a new data-manager-api-setup skill for getting started, auth setup, and client/utility library installation feat: Add guidance to ingestion skills for retrieving diagnostics and using the validate_only flag Added the Data Manager API setup skill with API access and ADC authentication guidance plus client and language-specific utility-library installation references.
npx skills add "lettucebo/Skills#v2.2.0@data-manager-api-setup" --full-depth

⚠ Available after v2.2.0 is published

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.
  2. 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:

History

v1.0.0 mapping-added 99c871e