.NET クライアント ライブラリは GitHub でホストされ、 NuGet パッケージとして配布されます。このライブラリには、認証情報の管理の簡素化や Google Ads API サービス クライアントの作成など、API の使用に役立つ機能がいくつか用意されています。
このライブラリは、次の .NET Framework をサポートしています。
- .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 広告アカウントを構成する手順がいくつか必要です。 クイックスタート ガイドに沿って、Google 広告アカウントの設定など、重要な手順をすべて完了してください。
基本的な使用方法
構成設定で GoogleAdsClient を初期化し、サービス クライアントを取得して API 呼び出しを行います。
GoogleAdsClient client = new GoogleAdsClient();
GoogleAdsServiceClient googleAdsService =
client.GetService(Services.V26.GoogleAdsService);
.NET クライアント ライブラリの使用方法について詳しくは、基本的な使用方法ガイドをご覧ください。
承認と認証
.NET クライアント ライブラリは、OAuth 2.0 ユーザー認証情報（デスクトップ アプリケーションとウェブ アプリケーション用）、サービス アカウント、アプリケーションのデフォルト認証情報（v24.1.0 以降）、手動による認証情報の挿入（v27.0.0 以降）など、複数の認証と承認の方法をサポートしています。詳しくは、
承認と認証のガイドをご覧ください。
構成とロギング
.NET クライアント ライブラリは、ランタイム オブジェクト、App.config ファイル、
JSON 構成ファイル、環境変数を使用して、複数の 構成
と ロギングのオプションをサポートしています。クライアント ライブラリのロギング動作を変更する必要がある場合は、
カスタム gRPC インターセプタ ガイドをご覧ください。
ユーティリティ
.NET クライアント ライブラリには、メディアと動画のアップロード ヘルパー（v27.2.0 以降の UploadVideo）など、API の使いやすさを向上させるユーティリティ クラスが含まれています。
詳細については、次のガイドをご覧ください。
アプリケーションのパフォーマンスを微調整する
アプリケーションのパフォーマンスを微調整する方法については、パフォーマンス チューニング ガイドをご覧ください。