Google API client Library for .NET

The Google.Apis.Auth.AspNetCore3 NuGet package provides a Google-specific OpenIdConnect authentication handler for ASP.NET Core 3 applications.

Key features include:

• Incremental Auth Support: Allows requesting additional scopes as needed.
• Injectable Provider: Defines an IGoogleAuthProvider interface that can be injected into your services to supply Google credentials.

The Google API .NET client library is currently in maintenance mode. This means:

• Feature Set: The libraries are considered mature and complete. No major new features are expected to be added.
• Support: The team continues to support the libraries by fixing bugs and adding minor features necessary to maintain compatibility with ongoing changes to the .NET platform.
• API Updates: New versions of existing API libraries will be released as they become available, and new API libraries will be released as new Google services become available.

The library does not officially support the following platforms:

• Unity
• Xamarin
• UWP (Universal Windows Platform)

Support for these platforms is not currently provided due to insufficient usage to justify the required technical work and infrastructure. The decision is reviewed periodically.

The Google APIs client library for .NET is modular. Instead of installing one massive library, you should install the specific NuGet package corresponding to the Google API you want to use. Each package follows the naming convention Google.Apis.[ServiceName].[Version].

Commonly used API packages include:

• Google Sheets API v4: Google.Apis.Sheets.v4
• Cloud Storage JSON API v1: Google.Apis.Storage.v1
• Cloud Spanner API v1: Google.Apis.Spanner.v1
• Cloud Speech-to-Text API v1: Google.Apis.Speech.v1
• Cloud Text-to-Speech API v1: Google.Apis.Texttospeech.v1

You can find the exact package for your required service in the project's documentation or by searching NuGet for the service name.

To get started with the library, you can use the following resources:

• Get Started Guide: Google API client Library for .NET - Get Started
• API List: Supported APIs
• NuGet Packages: The libraries are published under the google-apis-packages profile on NuGet.

The integration test application demonstrates the standard implementation pattern for this library:

• Configuration: Check Startup.cs to see how to register the Google-specific OpenIdConnect authentication handler.
• Usage in Controllers: Check Controllers/HomeController.cs to see how to access credentials and perform authenticated actions.
• Credential Loading: The sample uses a helper class ClientInfo.cs to load the OAuth client ID and secret from the client_secrets.json file. In production, you should use a secure method to store and retrieve these credentials.

You can run the sample application to see the library in action. This requires ASP.NET Core 3.1 or Visual Studio 2019.

1. Clone the repository locally using Git.
2. Navigate to the integration test directory: google-api-dotnet-client/Src/Support/Google.Apis.Auth.AspNetCore3.IntegrationTests
3. Execute the application using the .NET CLI:

   dotnet run

4. The local web server will start, and a browser should open to the Index page, where you can test various authentication features.

If you encounter bugs or issues within the client library itself, please report them via the GitHub issue tracker.

For questions regarding how to use the client library in your applications, please post your questions to Stack Overflow using the #google-api-dotnet-client tag.