.NET 客户端库托管在 GitHub 上,并以 NuGet 软件包的形式分发。它提供了多项功能来帮助您使用该 API,包括更轻松地管理凭据和创建 Google Ads API 服务客户端。
该库支持以下 .NET 框架:
- .NET Framework 4.7.2 及更高版本 (
net472) - .NET Standard 2.1 (
netstandard2.1) - .NET 8.0 (
net8.0)
.NET Standard 2.1 与其他多个 .NET 版本和实现兼容,因此该库可能在许多其他平台上正常运行。 不过,我们尚未正式测试兼容性,因此不会正式支持这些平台。如需了解详情,请参阅 .NET Standard 2.1 文档。
Google Ads API .NET 库使用 Grpc.Net.Client 作为默认传输层,并在不受支持的平台上回退到 Grpc.Core。虽然您可以通过将 UseGrpcCore 设置为 true 来强制使用 Grpc.Core,但请注意,Grpc.Core 已被废弃,仅用于旧版维护。如需了解详情,请参阅
基本用法指南。
进行首次 API 调用
如需使用 Google Ads API,您需要执行多个步骤才能获得对该 API 的访问权限并配置 Google Ads 账号。请按照 快速入门指南操作,该指南将引导您 完成所有重要步骤,包括设置 Google Ads 账号。
基本用法
使用配置设置初始化 GoogleAdsClient,并检索服务客户端以进行 API 调用:
GoogleAdsClient client = new GoogleAdsClient();
GoogleAdsServiceClient googleAdsService =
client.GetService(Services.V26.GoogleAdsService);
如需详细了解如何使用 .NET 客户端库,请参阅基本用法指南。
授权和身份验证
.NET 客户端库支持多种身份验证和授权方法,包括 OAuth 2.0 用户凭据(适用于桌面应用和 Web 应用)、服务账号、应用默认凭证(v24.1.0 及更高版本)和手动凭据注入(v27.0.0 及更高版本)。如需了解详情,请参阅
授权和身份验证指南。
配置和日志记录
.NET 客户端库支持使用运行时对象、App.config 文件、
JSON 配置文件或环境变量的多种 配置
和 日志记录 选项。如果您需要修改
客户端库的日志记录行为,请参阅
自定义 gRPC 拦截器指南。
实用程序
.NET 客户端库包含实用程序类,可提高 API 的易用性,包括媒体和视频上传帮助程序(v27.2.0 及更高版本中的 UploadVideo)。
请参阅以下指南了解详情:
微调应用性能
如需获得有关如何 微调应用性能的建议,请参阅性能调优指南。