Google Cloud Libraries for .NET

.NET idiomatic client libraries for Google Cloud Platform services.

Available APIs

This repository contains code for the following client libraries. Each package name links to the documentation for that package.

Package	Latest version	Description
Google.Cloud.Asset.V1	2.0.0	Google Cloud Asset Inventory
Google.Cloud.AutoML.V1	2.0.0	Google AutoML
Google.Cloud.BigQuery.DataTransfer.V1	2.0.0	Google BigQuery Data Transfer
Google.Cloud.BigQuery.V2	2.0.0-beta04	Google BigQuery
Google.Cloud.BigQuery.Storage.V1	2.0.0	Google BigQuery Storage
Google.Cloud.Bigtable.Admin.V2	2.0.0	Google Cloud Bigtable Administration
Google.Cloud.Bigtable.Common.V2	2.0.0	Common code used by Bigtable V2 APIs
Google.Cloud.Bigtable.V2	2.0.0	Google Bigtable
Google.Cloud.Billing.V1	2.0.0	Google Cloud Billing API
Google.Cloud.Container.V1	2.0.0	Google Kubernetes Engine API
Google.Cloud.DataCatalog.V1	1.0.0	Data Catalog
Google.Cloud.Dataproc.V1	2.0.0	Google Cloud Dataproc
Google.Cloud.Datastore.V1	3.0.0	Google Cloud Datastore
Google.Cloud.Debugger.V2	2.0.0	Google Cloud Debugger
Google.Cloud.DevTools.Common	2.0.0	Common Protocol Buffer messages for Google Cloud Developer Tools APIs
Google.Cloud.DevTools.ContainerAnalysis.V1	2.0.0	Google Container Analysis
Google.Cloud.Diagnostics.AspNet	4.0.0	Google Stackdriver Instrumentation Libraries for ASP.NET
Google.Cloud.Diagnostics.AspNetCore	4.0.0	Google Cloud Logging, Trace and Error Reporting Instrumentation Libraries for ASP.NET Core
Google.Cloud.Diagnostics.AspNetCore.Analyzers	2.0.0	Guidelines for using Google Cloud Logging, Trace and Error Reporting Instrumentation Libraries for ASP.NET Core
Google.Cloud.Diagnostics.Common	4.0.0	Google Cloud Logging, Trace and Error Reporting Instrumentation Libraries Common Components
Google.Cloud.Dialogflow.V2	3.0.0-beta01	Google Cloud Dialogflow
Google.Cloud.Dlp.V2	2.0.0	Google Cloud Data Loss Prevention
Google.Cloud.ErrorReporting.V1Beta1	2.0.0-beta02	Google Cloud Error Reporting
Google.Cloud.Firestore.Admin.V1	2.0.0	Firestore Admin
Google.Cloud.Firestore	2.0.0-beta02	Firestore
Google.Cloud.Firestore.V1	2.0.0-beta02	Firestore
Google.Cloud.Gaming.V1Beta	1.0.0-beta01	Google Cloud for Games
Google.Cloud.Iam.V1	2.0.0	Google Cloud Identity and Access Management (IAM)
Google.Cloud.Kms.V1	2.0.0	Google Cloud Key Management Service
Google.Cloud.Language.V1	2.0.0	Google Cloud Natural Language
Google.Cloud.Logging.Log4Net	3.0.0	Log4Net client library for the Google Cloud Logging API
Google.Cloud.Logging.NLog	3.0.0	NLog target for the Google Cloud Logging API
Google.Cloud.Logging.Type	3.0.0	Version-agnostic types for the Google Cloud Logging API
Google.Cloud.Logging.V2	3.0.0	Google Cloud Logging
Google.Cloud.ManagedIdentities.V1	2.0.0	Managed Service for Microsoft Active Directory
Google.Cloud.Memcache.V1Beta2	1.0.0-beta02	Google Cloud Memorystore for Memcache
Google.Cloud.Monitoring.V3	2.0.0	Google Cloud Monitoring
Google.Cloud.OrgPolicy.V1	2.0.0	OrgPolicy API messages
Google.Cloud.OsConfig.V1	1.0.0-beta01	Google Cloud OS Config API
Google.Cloud.OsLogin.Common	2.0.0	Version-agnostic types for the Google OS Login API
Google.Cloud.OsLogin.V1	2.0.0	Google Cloud OS Login API
Google.Cloud.OsLogin.V1Beta	2.0.0-beta02	Google Cloud OS Login API
Google.Cloud.PhishingProtection.V1Beta1	1.0.0-beta02	Cloud Phishing Protection
Google.Cloud.PubSub.V1	2.0.0	Cloud Pub/Sub
Google.Cloud.RecaptchaEnterprise.V1	1.0.0	Google Cloud reCAPTCHA Enterprise
Google.Cloud.RecaptchaEnterprise.V1Beta1	1.0.0-beta02	Google Cloud reCAPTCHA Enterprise
Google.Cloud.Recommender.V1	2.0.0	Google Cloud Recommender
Google.Cloud.Redis.V1	2.0.0	Google Cloud Memorystore for Redis
Google.Cloud.Redis.V1Beta1	2.0.0-beta02	Google Cloud Memorystore for Redis
Google.Cloud.Scheduler.V1	2.0.0	Google Cloud Scheduler
Google.Cloud.SecretManager.V1	1.0.0	Secret Manager
Google.Cloud.SecretManager.V1Beta1	2.0.0-beta02	Secret Manager
Google.Cloud.SecurityCenter.Settings.V1Beta1	1.0.0-beta01	Google Cloud Security Command Center Settings
Google.Cloud.SecurityCenter.V1	2.0.0	Google Cloud Security Command Center
Google.Cloud.SecurityCenter.V1P1Beta1	2.0.0-beta02	Google Cloud Security Command Center
Google.Cloud.ServiceDirectory.V1Beta1	1.0.0-beta02	Service Directory
Google.Cloud.Spanner.Admin.Database.V1	3.0.0-beta02	Google Cloud Spanner Database Administration
Google.Cloud.Spanner.Admin.Instance.V1	3.0.0-beta02	Google Cloud Spanner Instance Administration
Google.Cloud.Spanner.Data	3.0.0-beta02	Google ADO.NET Provider for Google Cloud Spanner
Google.Cloud.Spanner.Common.V1	3.0.0-beta02	Common resource names used by all Spanner V1 APIs
Google.Cloud.Spanner.V1	3.0.0-beta02	Google Cloud Spanner
Google.Cloud.Speech.V1	2.0.0	Google Cloud Speech
Google.Cloud.Speech.V1P1Beta1	2.0.0-beta02	Google Cloud Speech
Google.Cloud.Storage.V1	3.0.0-beta03	Google Cloud Storage
Google.Cloud.Talent.V4Beta1	2.0.0-beta03	Google Cloud Talent Solution
Google.Cloud.Tasks.V2	2.0.0	Google Cloud Tasks
Google.Cloud.Tasks.V2Beta3	2.0.0-beta02	Google Cloud Tasks
Google.Cloud.TextToSpeech.V1	2.0.0	Google Cloud Text-to-Speech
Google.Cloud.Trace.V1	2.0.0	Google Cloud Trace
Google.Cloud.Trace.V2	2.0.0	Google Cloud Trace
Google.Cloud.Translate.V3	2.0.0	Google Cloud Translation
Google.Cloud.Translation.V2	2.0.0	Google Cloud Translation
Google.Cloud.VideoIntelligence.V1	2.0.0	Google Cloud Video Intelligence
Google.Cloud.Vision.V1	2.0.0	Google Cloud Vision
Google.Cloud.WebRisk.V1	1.0.0	Google Cloud Web Risk
Google.Cloud.WebRisk.V1Beta1	2.0.0-beta02	Google Cloud Web Risk
Google.Identity.AccessContextManager.Type	1.0.0	Version-agnostic types for the Google Identity Access Context Manager API
Google.Identity.AccessContextManager.V1	1.0.0	Protocol buffer types for the Google Identity Access Context Manager API V1
Google.LongRunning	2.0.0	Support for the Long-Running Operations API pattern
Grafeas.V1	2.0.0	Grafeas

If you need support for other Google APIs, check out the Google .NET API Client library

Example Applications

getting-started-dotnet - A quickstart and tutorial that demonstrates how to build a complete web application using Cloud Datastore, Cloud Storage, and Cloud Pub/Sub and deploy it to Google Compute Engine.

Specifying a Project ID

Most Google Cloud Libraries for .NET require a project ID. If you don't remember yours (or haven't created a project yet), navigate to the Google Developers Console to view your project ID (or create a new project and then get the ID). Once done, record the value and make sure to pass it as a parameter to the methods that require it.

Authentication

Every API call needs to be authenticated. In order to successfully make a call, first ensure that the necessary Google Cloud APIs are enabled for your project and that you've downloaded the right set of keys (if it applies to you) as explained in the authentication document.

Next, choose a method for authenticating API requests from within your project:

When using google-cloud-dotnet libraries from within Compute/App Engine, no additional authentication steps are necessary.
When using google-cloud-dotnet libraries elsewhere, you can do one of the following:
- Define the environment variable GOOGLE_APPLICATION_CREDENTIALS to be the location of the key. For example:
```
set GOOGLE_APPLICATION_CREDENTIALS=/path/to/my/key.json
```
- If running locally for development/testing, you can authenticate using the Google Cloud SDK. Download the SDK if you haven't already, then login by running the following in the command line:
```
gcloud auth application-default login
```

Supported platforms

See the Supported Platforms documentation for details on where the Google Cloud Libraries for .NET are supported.

Versioning

The Google Cloud Client Libraries for .NET follow Semantic Versioning.

The version number in the package name (and .NET namespace) represents the version of the underlying API; the version number for the package itself indicates the status of the client library.

See the Versioning documentation for more details.

License

Apache 2.0 - See LICENSE for more information.

ibrahimozgon/google-cloud-dotnet