data-manager-api-setup

已同步 v1.0.0 授權: Apache-2.0 來源: google/skills/skills/ads/data-manager-api-setup 提交: 99c871e 收錄的最新變更:

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

摘要

用途
說明如何準備 Data Manager API 的本機存取環境，並安裝其用戶端與輔助程式庫。
使用時機
當你需要確認 ADC 範圍或服務帳戶模擬設定，或查找所用語言的用戶端與輔助套件時使用。
輸出結果
提供啟用 API 與設定驗證的步驟，以及 Python、Java、Node.js、PHP 和 .NET 安裝指南連結與套件名稱。
上游變更（5 筆，最新收錄 2026-09-25）
72ae9f9 Update utility library install steps to install from each package manager 更新技能的中繼資料版本，並修正 Java 與 .NET 公用程式套件名稱。
5401dca Update Data Manager API setup skill for @google-ads/datamanager-util npm release. 提升技能中繼資料版本，並將 Node 公用程式套件名稱修正為 `@google-ads/datamanager-util`。
329fa26 Standardize version formatting in Ads skills metadata 將中繼資料版本從 `1.0` 改為加上引號的 `1.0.0` 格式。
703f8d2 Move ads skills from per-product subdirectories to top-level skills/ads/ directory. 將內容未變的設定技能從 `skills/ads/data-manager-api/data-manager-api-setup/SKILL.md` 移至 `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 新增 Data Manager API 設定技能，提供 API 存取與 ADC 驗證指引，以及用戶端和各語言公用程式庫的安裝參考。
npx skills add "lettucebo/Skills#v2.2.0@data-manager-api-setup" --full-depth

⚠ v2.2.0 發布後即可使用

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:

歷程

v1.0.0 mapping-added 99c871e