https://github.com/googleads/googleads-dotnet-lib
Google Ad Manager SOAP API .NET client library
https://github.com/googleads/googleads-dotnet-lib
Last synced: about 1 month ago
JSON representation
Google Ad Manager SOAP API .NET client library
- Host: GitHub
- URL: https://github.com/googleads/googleads-dotnet-lib
- Owner: googleads
- License: apache-2.0
- Created: 2014-02-24T01:34:17.000Z (over 12 years ago)
- Default Branch: main
- Last Pushed: 2026-02-25T14:45:37.000Z (4 months ago)
- Last Synced: 2026-04-29T09:10:49.331Z (about 2 months ago)
- Language: C#
- Homepage:
- Size: 2.8 GB
- Stars: 109
- Watchers: 45
- Forks: 199
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Google Ad Manager SOAP API .NET Client Library
This project hosts the .NET client library for the
[Google Ad Manager SOAP API](//developers.google.com/ad-manager/api).
## Features
- Distributed via Nuget
- Stub classes for all the supported API versions and services.
- Helpful utilities
- SOAP messages are logged, for easier debugging purposes
- Automatic handling of SOAP headers
- Easy management of credentials, authentication, and session information
- Docs available in HTML and XML format.
## Supported Runtimes
- .NET Framework 4.6.2+
- .NET Core 2.0+
- .NET 5+
## Announcements and updates
For API and client library updates and news, please follow our Google Ads Developers blog:
http://googleadsdeveloper.blogspot.com/.
## Getting started
1. Install your library. We recommend using the following Nuget distribution:
- [Google.Dfp](https://www.nuget.org/packages/Google.Dfp/): Ad Manager API DotNet Client Library
You can learn more about the nuget package manager at http://www.nuget.org. For other distribution
options, see the alternative distribution options below.
1. Setup your OAuth2 credentials.
The and Ad Manager API uses
[OAuth2](http://oauth.net/2/) as the authentication mechanism. Follow the appropriate guide below
based on your use case.
**If you're accessing an API using your own credentials...**
* [Using Service Accounts](https://github.com/googleads/googleads-dotnet-lib/wiki/API-access-using-own-credentials-(server-to-server-flow))
**If you're accessing an API on behalf of clients...**
* [Developing a web application](https://github.com/googleads/googleads-dotnet-lib/wiki/API-access-on-behalf-of-your-clients-(web-flow))
## Alternative distribution options
### Binary distribution
The binary distribution of the Ads API .NET library consists of a precompiled version of the
library as a .NET assembly, code examples for using the library, and library documentation.
If you are interested in just using the library and not in its internals, and you don't use
nuget package manager in your development environment, then you should download this distribution.
The contents of this distribution are as follows:
```
\
\lib
- Precompiled assemblies.
- Documentation xmls for the assemblies.
\examples
Code examples, in C# and VB.NET (when available).
README
ChangeLog
COPYING
Visual Studio solution file
```
To run the code examples:
- Open Visual Studio solution file in the root folder of the binary distribution in Microsoft
Visual Studio
- Open `App.config` for the examples project and follow the instructions in the file to enter
required configuration values.
- Save and close `App.config`.
- Open the Properties dialog for the Examples project (Right click the Examples project of your
choice in the Solution Explorer and select the Properties option from the context menu.).
- Navigate to the Debug Tab and enter the command line options. The command line options are of
the form `version.examplename`. For instance, `v202308.GetCurrentNetwork` is the command line option to
run `GetCurrentNetwork` example in `v202308` version of the Ad Manager API.
- Compile and run the Examples project.
Alternatively, each code example has a `main()` method, so you can set the appropriate code example
as the Startup object (Select the Application tab on the Examples Properties dialog and pick
the desired class from the "Startup object" dropdown.).
To use the library in a new project:
- Create a new Visual Studio project of your choice (for instance, a C# Windows application).
- Copy the lib folder from the binary distribution to your project folder. Add references to all
the assemblies in this folder in your project.
- Add a reference to System.Web.Services in your project.
- Copy `examples\App.config` to your project directory and add it to your project.
- Edit the required keys in `App.config`. If your application has its own `App.config`, then you
need to merge its contents with the contents of `examples\App.config`.
- Make a call to the library, e.g.:
```
// Create an appropriate AdsUser instance.
AdManagerUser user = new AdManagerUser();
// Create the required service.
using (NetworkService networkService = user.GetService())
{
// make calls to service class.
}
```
You can refer to [this wiki article](//github.com/googleads/googleads-dotnet-lib/wiki/Getting-Started) for
more details.
## How to enable logging
See https://github.com/googleads/googleads-dotnet-lib/wiki#logging for details.
## Miscellaneous
### Wiki
- https://github.com/googleads/googleads-dotnet-lib/wiki
### Issue tracker
- https://github.com/googleads/googleads-dotnet-lib/issues
### API Documentation:
- https://developers.google.com/ad-manager/api
### Support forum
- https://developers.google.com/doubleclick-publishers/community
### Authors
- https://github.com/AnashOommen
- https://github.com/ChristopherSeeley
- https://github.com/jimper