Index of every page on this site: llms.txt
All skills
google avatar

/data-manager-api-setup

@5fb62c2
by googlegoogle/skills24k stars
2,026
Run it yourself

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), or for debugging UNAUTHENTICATED, PERMISSION_DENIED, or other errors from requests after setup (use the data-manager-api-troubleshooting skill).

Use this Skill: https://skilld.dev/gh/google/skills/data-manager-api-setup

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈153 tokens for metadata: the name and description. ≈1.3k when used: this file. ≈1.2k more on demand in 6 files.

Description uses 7.6% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈611 characters, or 7.6%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Data Manager API Setup

Setup Authentication

Refer to Set up API access for more details.

1. Enable the API

Prerequisites: A Google Cloud project, the Google Cloud CLI (gcloud), and a Google Account with a project role that can enable APIs, such as Owner, Editor, or Service Usage Admin. Always tell the user about the required role. If gcloud isn't installed, prompt the user to install it first.

gcloud services enable datamanager.googleapis.com --project={project_id}
gcloud services list --enabled --project={project_id} --filter="datamanager.googleapis.com"

2. Generate Application Default Credentials (ADC)

Choose the method that matches the user's scenario:

  • User account (API calls are made as the user's own Google Account): The Data Manager API scopes are sensitive, so the user must first configure their project's Google Auth Platform:

    1. Data Access page: Add the Data Manager API scopes.

    2. Audience page: Set Publishing status to Testing. Use the Internal user type for a Google Workspace organization, or External with the user's account added as a Test user.

    3. Create (or reuse) a Desktop app OAuth client and download its JSON configuration file.

    4. The user runs the following command, which opens a browser login:

      gcloud auth application-default login \
        --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform" \
        --client-id-file="{client_id_file_path}"

    Unverified app screen: This warning appears because the Data Manager API scopes are sensitive. During Testing, External test users still see it and can continue past it. Before other users can sign in, the app must complete OAuth app verification. Service accounts don't need verification.

  • Service account (API calls are made as an app identity instead of a person): For local development, use service account impersonation rather than a service account key, since keys are a security risk if not managed carefully.

    • Grant the Service Account the Service Usage Consumer IAM role (roles/serviceusage.serviceUsageConsumer) on the project.

    • Grant the user executing gcloud the Token Creator role (roles/iam.serviceAccountTokenCreator) on that Service Account.

    • Run:

      gcloud auth application-default login \
        --impersonate-service-account={service_account_email} \
        --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform"
  • Data partner creating partner links in advertiser accounts: Read Partner Links.

Multiple APIs: To use the same credentials for other APIs, append their scopes to the --scopes list in the commands above (e.g., https://www.googleapis.com/auth/adwords for the Google Ads API or https://www.googleapis.com/auth/display-video for the Display & Video 360 API).

Verify: gcloud auth application-default print-access-token prints an access token when credentials are set up correctly.

Troubleshooting PERMISSION_DENIED with a valid token: Add the user or service account to the destination account (for example, the Google Ads account or its manager account). For service accounts, also confirm the Service Usage Consumer role on the Cloud project.

Production: For production authentication (workloads in or outside Google Cloud, apps that act on behalf of other users, or partner links), see Deploy to production.

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:

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alertstoday3 checks · Risk SAFE
  • Gen Agent Trust Hub1d

    This skill provides configuration and setup instructions for the Data Manager API, focusing on authentication via the Google Cloud CLI and the installation of official client libraries. All resources, packages, and references are from official and well-known domains.

  • Sockettoday

    No alerts

  • Snyk1d

    Risk: LOW · No issues

Signed by skilld at 5fb62c2. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 3 days ago
metadata
{
  "version": "1.1.1",
  "category": "GoogleAds"
}

README badge

README badge for google/skills/data-manager-api-setup