.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 使用者憑證 (適用於電腦和網路應用程式)、服務帳戶、應用程式預設憑證 (v24.1.0 以上版本) 和手動憑證插入 (v27.0.0 以上版本)。詳情請參閱授權和驗證指南。

設定和記錄

.NET 用戶端程式庫支援多種設定和記錄選項，可使用執行階段物件、App.config 檔案、JSON 設定檔或環境變數。如需修改用戶端程式庫的記錄行為，請參閱自訂 gRPC 攔截器指南。

公用程式

.NET 用戶端程式庫包含實用類別，可提升 API 的可用性，包括媒體和影片上傳輔助程式 (v27.2.0 以上版本中的 UploadVideo)。查看下列指南持續學習：

微調應用程式效能

請參閱效能調整指南，瞭解如何微調應用程式效能。