.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 已淘汰，僅供舊版維護使用。詳情請參閱基本使用指南。

安裝

使用 dotnet 指令列工具，在專案中安裝 Google.Ads.GoogleAds NuGet 套件：

dotnet add package Google.Ads.GoogleAds

如要從 appsettings.json、App.config 或環境變數載入設定，請一併安裝 Google.Ads.GoogleAds.Extensions 套件：

dotnet add package Google.Ads.GoogleAds.Extensions

進行第一次 API 呼叫

如要使用 Google Ads API，您需要執行幾個步驟，才能存取 API 並設定 Google Ads 帳戶。請按照快速入門指南操作，逐步完成所有重要步驟，包括設定 Google Ads 帳戶。

基本用法

使用設定初始化 GoogleAdsConfig 和 GoogleAdsClient、擷取 GoogleAdsServiceClient，並使用 SearchStream 串流廣告活動列：

using System;
using Google.Ads.Gax.Config;
using Google.Ads.GoogleAds.Config;
using Google.Ads.GoogleAds.Lib;
using Google.Ads.GoogleAds.V26.Errors;
using Google.Ads.GoogleAds.V26.Services;

GoogleAdsConfig config = new GoogleAdsConfig()
{
    OAuth2Mode = OAuth2Flow.APPLICATION,
    OAuth2ClientId = "INSERT_CLIENT_ID.apps.googleusercontent.com",
    OAuth2ClientSecret = "INSERT_CLIENT_SECRET",
    OAuth2RefreshToken = "INSERT_REFRESH_TOKEN",
    LoginCustomerId = "INSERT_LOGIN_CUSTOMER_ID_HERE"
};

GoogleAdsClient client = new GoogleAdsClient(config);
GoogleAdsServiceClient googleAdsService =
    client.GetService(Services.V26.GoogleAdsService);

string customerId = "INSERT_CUSTOMER_ID_HERE";
string query =
    "SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id";

try
{
    googleAdsService.SearchStream(
        customerId,
        query,
        delegate (SearchGoogleAdsStreamResponse response)
        {
            foreach (GoogleAdsRow row in response.Results)
            {
                Console.WriteLine(
                    $"Campaign ID {row.Campaign.Id}: {row.Campaign.Name}");
            }
        });
}
catch (GoogleAdsException ex)
{
    Console.WriteLine($"Request ID {ex.RequestId} failed: {ex.Message}");
}

請參閱基本使用指南，進一步瞭解如何使用 .NET 用戶端程式庫。

授權與驗證

.NET 用戶端程式庫支援多種驗證和授權方法，包括 OAuth 2.0 使用者憑證 (適用於電腦和網頁應用程式)、服務帳戶、應用程式預設憑證 (v24.1.0 以上版本)，以及手動插入憑證 (v27.0.0 以上版本)。詳情請參閱授權和驗證指南。

設定和記錄

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

公用程式

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

微調應用程式效能

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