The .NET Client Library

  • The Google Ads API client library for .NET will no longer support .NET 5.0 starting with version 19.0.0, and users should upgrade to a supported version before the end of 2024.

  • The library supports .NET Framework 4.7.2+, .NET Standard 2.1, .NET 6.0, and .NET 8.0.

  • It is available as a NuGet package and hosted on GitHub, providing features for easier credential management and service client creation.

  • While .NET Standard 2.1 offers compatibility with various .NET versions and implementations, only the explicitly listed frameworks are officially supported.

  • Users can find comprehensive documentation and guides, covering setup, OAuth flows, logging, and advanced features on the official Google Ads API website.

The .NET client library is hosted on GitHub and is distributed as a NuGet package. It offers several features to help you use the API, including easier management of credentials and creation of Google Ads API service clients.

The library supports the following .NET Frameworks:

  • .NET Framework 4.7.2+ (net472)
  • .NET Standard 2.1 (netstandard2.1)
  • .NET 8.0 (net8.0)

.NET Standard 2.1 is compatible with several other .NET versions and implementations, so the library might work fine on many other platforms. However, we haven't officially tested the compatibility and thus don't officially support these platforms. See the .NET Standard 2.1 documentation to learn more.

The Google Ads API .NET library uses Grpc.Net.Client as the default, with a fallback to Grpc.Core on unsupported platforms. You can force the use of Grpc.Core by setting UseGrpcCore to true. See the basic usage guide to learn more.

Make your first API call

To use the Google Ads API, you need to perform several steps to get access to the API and configure your Google Ads accounts. We recommend following the quick start guide, which will walk you through all the important steps including setting up your Google Ads accounts.

Basic usage

Refer to the basic usage guide to learn more about how to use the .NET client library.

Authorization and authentication

The .NET client library supports multiple approaches to authentication and authorization. Refer to the authorization and authentication guide to learn more.

Configuration and logging

The .NET client library supports multiple configuration and logging options. In case you need to modify the logging behaviour of the client library, refer to the custom gRPC interceptor guide.

Utilities

The .NET client library includes a few utility classes to improve the API usability. Refer to the following guides to learn more:

Fine tune your application performance

Refer to the performance tuning guide for recommendations on how to fine-tune your application's performance.