data-manager-api-setup
/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).
Assessment and security
- Files in this package
- 7
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 10
No signals detected. Repository changed on 25.10.2026, without references to retired models or APIs.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
What it does and when to use it
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).
Original author description
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 it works
- Setup Authentication
- Install Client & Utility Libraries
SKILL.md preview
---
name: data-manager-api-setup
description: >-
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).
metadata:
version: "1.1.0"
category: GoogleAds
---
# Data Manager API Setup
## Setup Authentication
Refer to [Set up API access](https://developers.google.com/data-manager/api/devguides/quickstart/set-up-access.md.txt)
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.
```shell
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:
```shell
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](https://developers.google.com/data-manager/api/devguides/concepts/oauth-verification.md.txt).
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:
```shell
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](references/partner-links.md).
**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](https://developers.google.com/data-manager/api/devguides/concepts/deploy.md.txt).
## Install Client & Utility Libraries
Refer to [Install a client library](https://developers.google.com/data-manager/api/devguides/quickstart/install-library.md.txt)
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 `com.google.api-ads:data-manager-util`)
* [Node Setup Reference](references/node.md) (packages: `@google-ads/datamanager` and `@google-ads/datamanager-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`)
Files in this package (7)
- SKILL.md 6 KB
- references/dotnet.md 1 KB
- references/java.md 2 KB
- references/node.md 1 KB
- references/partner-links.md 2 KB
- references/php.md 1 KB
- references/python.md 1 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · google/skills | 100 | Apache-2.0 |
| yangshun2005/skills-cn | 100 | Apache-2.0 |
| hamzabellouch/agent-skills | 90 | MIT |
Database snapshot: 13.11.2026 · package version 51201ccbb5f3 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100data-manager-api-audience-ingestion
Guides developers through uploading audience members to Google products using the Data Manager API /v1/audienceMembers/ingest endpoint and its associated client libraries. Use this skill when the user wants to upload audience members for Customer Match, mobile device ID… - 100data-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,… - 100data-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,… - 90data-manager-api-audience-ingestion
指导开发者使用 Data Manager API 及其客户端库管理(添加、移除和清空)Google 产品的受众成员。当用户想要上传受众成员、移除特定用户,或为 Customer Match、移动设备 ID 受众或 Data Manager API 支持的任何其他受众用例清空/替换整个受众时,使用此技能。不要用于上传事件或转化(请使用 data-manager-api-event-ingestion 技能)。 - 90data-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… - 100data-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,…