Google Ads Data Manager API .NET 客户端库与工具库安装指南data-manager-api-setup【免费下载链接】skillsAgent Skills for Google products and technologies项目地址: https://gitcode.com/GitHub_Trending/skills29/skills本篇技术指南聚焦于 Google Ads Data Manager API 的 .NET 本地环境搭建涵盖客户端库与配套工具库的完整安装流程、ADC 认证配置以及工具库在用户标识符格式化与加密中的核心作用。读完本文你将能够在 .NET 项目中引入Google.Ads.DataManager.V1客户端包并通过ProjectReference接入不在公共包管理器上发布的工具库为后续的受众Audience与事件Event数据接入做好准备。本指南的内容源自>库作用发布渠道客户端库Client Library提供IngestionServiceClient等核心类封装ingest_audience_members、remove_audience_members、ingest_events等 RPC 调用公共包管理器如 NuGet工具库Utility Library提供预构建的辅助类与函数用于在数据接入前正确格式化、哈希、加密用户标识符如邮箱、电话号码、物理地址确保用户标识符格式完全符合 API 规范仅源码仓库需自行 clone 与引用工具库之所以「强烈建议使用」是因为用户标识符email、phone、address在进入 API 前需要经历规范化、归一化、SHA-256 哈希与在部分场景下的加密处理。手工实现极易出现格式偏差例如字段命名、编码、哈希算法细节导致请求被拒或匹配率下降。仓库中的 格式化参考 明确要求格式化与规范化规则以官方 Format user data 指南为准并通过工具库完成实际处理。[!IMPORTANT] 工具库不在公共包管理器上发布如 NuGet 上没有对应包必须通过下方步骤从源码仓库克隆并引用。这一点在 SKILL.md 及所有语言参考文档中均有明确标注。二、安装 .NET 客户端库Google.Ads.DataManager.V1在 .NET 项目中使用dotnet CLI安装客户端库一条命令即可完成dotnet add package Google.Ads.DataManager.V1该命令会在当前项目的.csproj文件中自动追加PackageReference依赖并从 NuGet 解析Google.Ads.DataManager.V1最新稳定版。安装完成后客户端库即提供 Data Manager API 的强类型客户端与请求/响应消息类用于后续构造IngestAudienceMembersRequest、IngestEventsRequest等负载。三、安装 .NET 工具库Google.Ads.DataManager.Util工具库无法通过dotnet add package获取官方安装流程分为两步第 1 步克隆工具库源码仓库git clone https://github.com/googleads/data-manager-dotnet.gitdata-manager-dotnet仓库同时包含客户端库示例与工具库源码其中工具库工程位于仓库内的Google.Ads.DataManager.Util\src子目录下。第 2 步通过 ProjectReference 声明项目级引用在 .NET 项目的.csproj中声明对克隆仓库内工具库工程的引用将{path_to_utility_library}替换为本地克隆仓库的实际路径ProjectReference Include{path_to_utility_library}\Google.Ads.DataManager.Util\src\Google.Ads.DataManager.Util.csproj /使用ProjectReference而非程序集拷贝或包引用可以保证工具库与主项目一同构建、版本始终一致也便于随时拉取仓库最新提交获得修复。工具库在 .NET 之外的对应形态仓库为每种语言都维护了独立的工具库安装参考便于你按团队技术栈对照操作语言客户端包工具库安装参考.NETGoogle.Ads.DataManager.V1NuGetdotnet.mdclone ProjectReferencePythongoogle-ads-datamanagerPyPIpython.mdclone pip install .Javacom.google.api-ads:data-managerMaven Centraljava.mdclone ./gradlew>Node.jsgoogle-ads/datamanagernpmnode.mdclone npm pack生成.tgz后以file:依赖引用PHPgoogleads/data-managerComposer / Packagistphp.mdclone composer.json配置 path repository可以看到各语言的工具库都刻意不发布到公共包管理器统一采用「克隆源码 本地化引用」的接入模式这也是 Data Manager API 工具链的一个显著特点。四、安装前的认证与环境准备安装库只是第一步。在调用任何 API 之前需要完成 Data Manager API 的访问开通与本地认证。结合>gcloud auth application-default login3. 配置必需的 OAuth Scopes本地 ADC 凭据必须包含以下两个作用域https://www.googleapis.com/auth/datamanagerData Manager API 主作用域https://www.googleapis.com/auth/cloud-platform云平台通用作用域如果同一份凭据还要供其他 API 使用则需追加对应作用域例如 Google Ads API 的https://www.googleapis.com/auth/adwords。作用域缺失会导致认证通过但调用被拒权限不足错误。4. 服务账号场景的 IAM 角色若使用服务账号执行请求需要满足服务账号本身应具备Service Usage ConsumerIAM 角色以便正常使用 API 配额执行gcloud的用户需在该服务账号上拥有Token Creator角色roles/iam.serviceAccountTokenCreator才能通过--impersonate-service-account完成身份模拟。五、安装完成后的下一步接入受众与事件环境就绪后真正的数据接入逻辑由仓库中的两个配套技能承接Data Manager API Audience Ingestion面向 Customer Match、移动设备 ID 等受众成员的上传、移除与清空Replace All。其实现清单要求先实例化IngestionServiceClient、构造Destinationoperating_account/login_account/linked_account、使用工具库格式化用户数据再发送IngestAudienceMembersRequest等请求并通过request_id查询异步处理状态。Data Manager API Event Ingestion面向离线转化、点击转化、Google Analytics 网页/应用事件的上传使用/v1/events/ingest端点与IngestEventsRequest同样依赖工具库完成用户标识符的格式化与归一化。其中工具库的实际用法可以参照 格式化参考 中给出的 Python 示例.NET 工具库提供对应的辅助类API 形态以源码仓库为准from google.ads.datamanager_util import Formatter from google.ads.datamanager_util.format import Encoding formatter: Formatter Formatter() processed_email: str formatter.process_email_address( email, Encoding.HEX )这段示例体现了工具库的典型职责接收原始邮箱地址输出按 API 规范处理规范化 哈希 编码后的字符串供UserIdentifier字段使用。六、常见问题与排查要点结合 SKILL.md 与配套接入技能中的告警项安装与调用阶段常见问题如下问题现象可能原因处理建议dotnet add package失败网络无法访问 NuGet 源检查 NuGet 源配置nuget.config与网络代理工具库类型无法解析ProjectReference路径错误或指向了错误的.csproj核对{path_to_utility_library}是否指向Google.Ads.DataManager.Util\src\Google.Ads.DataManager.Util.csproj认证通过但调用报权限错误OAuth Scope 缺失确认 ADC 包含datamanager与cloud-platform两个作用域服务账号调用失败缺少Service Usage Consumer或 Token Creator 角色按上文 IAM 角色要求补配标识符上传后匹配率异常未使用工具库手工格式化/哈希不符合规范改用工具库处理邮箱、电话与地址七、总结Data Manager API 的 .NET 接入分为三个层面认证准备启用 API、ADC、Scopes、IAM 角色、客户端库安装dotnet add package Google.Ads.DataManager.V1与工具库接入克隆data-manager-dotnet仓库并以ProjectReference引用Google.Ads.DataManager.Util。其中工具库因不发布到 NuGet 而最容易被遗漏但它恰恰是保证用户标识符格式符合 API 规范的关键一环。完成本篇安装流程后即可进入 受众接入 或 事件接入 的编码实现阶段。【免费下载链接】skillsAgent Skills for Google products and technologies项目地址: https://gitcode.com/GitHub_Trending/skills29/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考