.NET クライアント ライブラリは GitHub でホストされ、NuGet パッケージとして配布されます。このライブラリには、認証情報の管理の簡素化や Google Ads API サービス クライアントの作成など、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 広告アカウントを構成するための手順をいくつか行う必要があります。クイック スタートガイドに沿って、Google 広告アカウントの設定など、重要な手順をすべて完了してください。
基本的な使用方法
構成設定で 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）などがあります。詳細については、次のガイドをご覧ください。
アプリケーションのパフォーマンスを微調整する
アプリケーションのパフォーマンスを微調整する方法については、パフォーマンス チューニング ガイドをご覧ください。