.NET 客户端库

.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.V25.GoogleAdsService);

如需详细了解如何使用 .NET 客户端库，请参阅基本使用指南。

授权和身份验证

.NET 客户端库支持多种身份验证和授权方法，包括 OAuth 2.0 用户凭据（适用于桌面应用和 Web 应用）、服务账号、应用默认凭据（v24.1.0 及更高版本）和手动凭据注入（v27.0.0 及更高版本）。如需了解详情，请参阅授权和身份验证指南。

配置和日志记录

.NET 客户端库支持多种配置和日志记录选项，这些选项可通过运行时对象、App.config 文件、JSON 配置文件或环境变量进行设置。如果您需要修改客户端库的日志记录行为，请参阅自定义 gRPC 拦截器指南。

实用程序

.NET 客户端库包含用于提高 API 可用性的实用程序类，包括媒体和视频上传帮助程序（v27.2.0 中的 UploadVideo 及更高版本）。请参阅以下指南了解详情：

微调应用性能

如需有关如何微调应用性能的建议，请参阅性能调优指南。