Google Cloud Libraries for .NET

.NET idiomatic client libraries for Google Cloud Platform services.

• Homepage
• API Documentation

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.Analytics.Admin.V1Alpha | 1.0.0-alpha04 | Analytics Admin | | Google.Analytics.Data.V1Alpha | 1.0.0-alpha04 | Google Analytics Data (V1Alpha API) | | Google.Analytics.Data.V1Beta | 1.0.0-beta02 | Google Analytics Data (V1Beta API) | | Google.Area120.Tables.V1Alpha1 | 1.0.0-alpha02 | Google Area 120 Tables | | Google.Cloud.AccessApproval.V1 | 1.0.0 | Access Approval | | Google.Cloud.ApiGateway.V1 | 1.0.0-beta01 | API Gateway | | Google.Cloud.AppEngine.V1 | 1.0.0 | App Engine Audit Data | | Google.Cloud.ArtifactRegistry.V1Beta2 | 1.0.0-beta01 | Artifact Registry | | Google.Cloud.Asset.V1 | 2.6.0 | Google Cloud Asset Inventory | | Google.Cloud.AssuredWorkloads.V1Beta1 | 1.0.0-beta03 | Assured Workloads | | Google.Cloud.AutoML.V1 | 2.1.0 | Google AutoML | | Google.Cloud.BigQuery.Connection.V1 | 1.1.0 | BigQuery Connection | | Google.Cloud.BigQuery.DataTransfer.V1 | 3.0.0 | Google BigQuery Data Transfer | | Google.Cloud.BigQuery.Reservation.V1 | 1.1.0 | BigQuery Reservation | | Google.Cloud.BigQuery.V2 | 2.1.0 | Google BigQuery | | Google.Cloud.BigQuery.Storage.V1 | 2.1.0 | Google BigQuery Storage | | Google.Cloud.Bigtable.Admin.V2 | 2.3.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.1.1 | Google Bigtable | | Google.Cloud.Billing.Budgets.V1 | 1.0.0 | Cloud Billing Budget (V1 API) | | Google.Cloud.Billing.Budgets.V1Beta1 | 1.0.0-beta02 | Cloud Billing Budget (V1Beta1 API) | | Google.Cloud.Billing.V1 | 2.1.0 | Google Cloud Billing | | Google.Cloud.BinaryAuthorization.V1Beta1 | 1.0.0-beta01 | Binary Authorization | | Google.Cloud.Channel.V1 | 1.0.0 | Cloud Channel | | Google.Cloud.CloudBuild.V1 | 1.0.0 | Cloud Build | | Google.Cloud.Container.V1 | 2.2.0 | Google Kubernetes Engine | | Google.Cloud.DataCatalog.V1 | 1.1.0 | Data Catalog | | Google.Cloud.DataLabeling.V1Beta1 | 1.0.0-beta01 | Data Labeling | | Google.Cloud.DataQnA.V1Alpha | 1.0.0-alpha01 | Data QnA | | Google.Cloud.Dataproc.V1 | 3.0.0 | Google Cloud Dataproc | | Google.Cloud.Datastore.Admin.V1 | 1.0.0 | Cloud Datastore | | Google.Cloud.Datastore.V1 | 3.1.0 | Google Cloud Datastore | | Google.Cloud.Debugger.V2 | 2.1.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.1.0 | Google Container Analysis | | Google.Cloud.Diagnostics.AspNetCore | 4.2.0 | Google Cloud Logging, Trace and Error Reporting Instrumentation Libraries for ASP.NET Core | | Google.Cloud.Diagnostics.AspNetCore3 | 4.2.0 | Google Cloud Logging, Trace and Error Reporting Instrumentation Libraries for ASP.NET Core 3 | | Google.Cloud.Diagnostics.Common | 4.2.0 | Google Cloud Logging, Trace and Error Reporting Instrumentation Libraries Common Components | | Google.Cloud.Dialogflow.Cx.V3 | 1.0.0 | Dialogflow | | Google.Cloud.Dialogflow.V2 | 3.1.0 | Google Cloud Dialogflow | | Google.Cloud.Dlp.V2 | 3.1.0 | Google Cloud Data Loss Prevention | | Google.Cloud.DocumentAI.V1 | 1.0.0-beta01 | Cloud Document AI (V1 API) | | Google.Cloud.DocumentAI.V1Beta2 | 1.0.0-beta02 | Cloud Document AI (V1Beta2 API) | | Google.Cloud.Domains.V1Beta1 | 1.0.0-beta01 | Cloud Domains | | Google.Cloud.ErrorReporting.V1Beta1 | 2.0.0-beta03 | Google Cloud Error Reporting | | Google.Cloud.Firestore.Admin.V1 | 2.1.0 | Firestore Administration (e.g. index management) | | Google.Cloud.Firestore | 2.3.1 | Firestore high-level library | | Google.Cloud.Firestore.V1 | 2.2.0 | Firestore low-level API access | | Google.Cloud.Functions.V1 | 1.0.0 | Cloud Functions | | Google.Cloud.Gaming.V1 | 1.0.0 | Game Services | | Google.Cloud.Gaming.V1Beta | 1.0.0-beta06 | Google Cloud for Games | | Google.Cloud.GkeHub.V1Beta1 | 1.0.0-beta01 | GKE Hub | | Google.Cloud.Iam.Credentials.V1 | 1.0.0 | IAM Service Account Credentials | | Google.Cloud.Iam.V1 | 2.1.0 | Google Cloud Identity and Access Management (IAM) | | Google.Cloud.Iot.V1 | 1.0.0 | Cloud IoT | | Google.Cloud.Kms.V1 | 2.1.0 | Google Cloud Key Management Service | | Google.Cloud.Language.V1 | 2.1.0 | Google Cloud Natural Language | | Google.Cloud.Logging.Log4Net | 3.2.0 | Log4Net client library for the Google Cloud Logging API | | Google.Cloud.Logging.NLog | 3.3.0 | NLog target for the Google Cloud Logging API | | Google.Cloud.Logging.Type | 3.2.0 | Version-agnostic types for the Google Cloud Logging API | | Google.Cloud.Logging.V2 | 3.2.0 | Google Cloud Logging | | Google.Cloud.ManagedIdentities.V1 | 2.1.0 | Managed Service for Microsoft Active Directory | | Google.Cloud.MediaTranslation.V1Beta1 | 1.0.0-beta01 | Media Translation | | Google.Cloud.Memcache.V1 | 1.0.0 | Cloud Memorystore for Memcached | | Google.Cloud.Memcache.V1Beta2 | 1.0.0-beta03 | Google Cloud Memorystore for Memcache | | Google.Cloud.Metastore.V1 | 1.0.0-beta01 | Dataproc Metastore (V1 API) | | Google.Cloud.Metastore.V1Alpha | 1.0.0-alpha02 | Dataproc Metastore (V1Alpha API) | | Google.Cloud.Metastore.V1Beta | 1.0.0-beta01 | Dataproc Metastore (V1Beta API) | | Google.Cloud.Monitoring.V3 | 2.2.0 | Google Cloud Monitoring | | Google.Cloud.NetworkConnectivity.V1Alpha1 | 1.0.0-alpha01 | Network Connectivity | | Google.Cloud.Notebooks.V1Beta1 | 1.0.0-beta02 | AI Platform Notebooks | | Google.Cloud.OrgPolicy.V1 | 2.1.0 | OrgPolicy API messages | | Google.Cloud.OrgPolicy.V2 | 1.0.0 | Organization Policy | | Google.Cloud.OsConfig.V1 | 1.2.0 | Google Cloud OS Config | | Google.Cloud.OsLogin.Common | 2.1.0 | Version-agnostic types for the Google OS Login API | | Google.Cloud.OsLogin.V1 | 2.1.0 | Google Cloud OS Login (V1 API) | | Google.Cloud.OsLogin.V1Beta | 2.0.0-beta03 | Google Cloud OS Login (V1Beta API) | | Google.Cloud.PhishingProtection.V1Beta1 | 1.0.0-beta03 | Cloud Phishing Protection | | Google.Cloud.PolicyTroubleshooter.V1 | 1.0.0 | Policy Troubleshooter | | Google.Cloud.Profiler.V2 | 1.0.0 | Cloud Profiler | | Google.Cloud.PubSub.V1 | 2.4.0 | Cloud Pub/Sub | | Google.Cloud.RecaptchaEnterprise.V1 | 1.1.0 | Google Cloud reCAPTCHA Enterprise (V1 API) | | Google.Cloud.RecaptchaEnterprise.V1Beta1 | 1.0.0-beta03 | Google Cloud reCAPTCHA Enterprise (V1Beta1 API) | | Google.Cloud.RecommendationEngine.V1Beta1 | 1.0.0-beta01 | Recommendations AI | | Google.Cloud.Recommender.V1 | 2.4.0 | Google Cloud Recommender | | Google.Cloud.Redis.V1 | 2.1.0 | Google Cloud Memorystore for Redis (V1 API) | | Google.Cloud.Redis.V1Beta1 | 2.0.0-beta03 | Google Cloud Memorystore for Redis (V1Beta1 API) | | Google.Cloud.Retail.V2 | 1.0.0 | Retail | | Google.Cloud.Scheduler.V1 | 2.1.0 | Google Cloud Scheduler | | Google.Cloud.SecretManager.V1 | 1.3.0 | Secret Manager (V1 API) | | Google.Cloud.SecretManager.V1Beta1 | 2.0.0-beta03 | Secret Manager (V1Beta1 API) | | Google.Cloud.Security.PrivateCA.V1Beta1 | 1.0.0-beta01 | Certificate Authority | | Google.Cloud.SecurityCenter.Settings.V1Beta1 | 1.0.0-beta02 | Google Cloud Security Command Center Settings | | Google.Cloud.SecurityCenter.V1 | 2.2.0 | Google Cloud Security Command Center (V1 API) | | Google.Cloud.SecurityCenter.V1P1Beta1 | 2.0.0-beta04 | Google Cloud Security Command Center (V1P1Beta1 API) | | Google.Cloud.ServiceControl.V1 | 1.0.0 | Service Control | | Google.Cloud.ServiceDirectory.V1 | 1.0.0 | Service Directory (V1 API) | | Google.Cloud.ServiceDirectory.V1Beta1 | 1.0.0-beta03 | Service Directory (V1Beta1 API) | | Google.Cloud.ServiceManagement.V1 | 1.0.0 | Service Management | | Google.Cloud.Spanner.Admin.Database.V1 | 3.7.0 | Google Cloud Spanner Database Administration | | Google.Cloud.Spanner.Admin.Instance.V1 | 3.7.0 | Google Cloud Spanner Instance Administration | | Google.Cloud.Spanner.Data | 3.7.0 | Google ADO.NET Provider for Google Cloud Spanner | | Google.Cloud.Spanner.Common.V1 | 3.7.0 | Common resource names used by all Spanner V1 APIs | | Google.Cloud.Spanner.V1 | 3.7.0 | Google Cloud Spanner | | Google.Cloud.Speech.V1 | 2.1.0 | Google Cloud Speech (V1 API) | | Google.Cloud.Speech.V1P1Beta1 | 2.0.0-beta03 | Google Cloud Speech (V1P1Beta1 API) | | Google.Cloud.Storage.V1 | 3.4.0 | Google Cloud Storage | | Google.Cloud.Talent.V4 | 1.0.0 | Google Cloud Talent Solution (V4 API) | | Google.Cloud.Talent.V4Beta1 | 2.0.0-beta04 | Google Cloud Talent Solution (V4Beta1 API) | | Google.Cloud.Tasks.V2 | 2.1.0 | Google Cloud Tasks (V2 API) | | Google.Cloud.Tasks.V2Beta3 | 2.0.0-beta04 | Google Cloud Tasks (V2Beta3 API) | | Google.Cloud.TextToSpeech.V1 | 2.1.0 | Google Cloud Text-to-Speech | | Google.Cloud.Trace.V1 | 2.1.0 | Google Cloud Trace (V1 API) | | Google.Cloud.Trace.V2 | 2.1.0 | Google Cloud Trace (V2 API) | | Google.Cloud.Translate.V3 | 2.1.0 | Google Cloud Translation (V3 API) | | Google.Cloud.Translation.V2 | 2.0.0 | Google Cloud Translation (V2 API) | | Google.Cloud.Video.Transcoder.V1Beta1 | 1.0.0-beta01 | Transcoder | | Google.Cloud.VideoIntelligence.V1 | 2.1.0 | Google Cloud Video Intelligence | | Google.Cloud.Vision.V1 | 2.2.0 | Google Cloud Vision | | Google.Cloud.WebRisk.V1 | 1.1.0 | Google Cloud Web Risk (V1 API) | | Google.Cloud.WebRisk.V1Beta1 | 2.0.0-beta03 | Google Cloud Web Risk (V1Beta1 API) | | Google.Cloud.WebSecurityScanner.V1 | 1.0.0 | Web Security Scanner | | Google.Cloud.Workflows.Common.V1 | 1.0.0-beta01 | Common resource names used by all Workflows V1 APIs | | Google.Cloud.Workflows.Common.V1Beta | 1.0.0-beta01 | Common resource names used by all Workflows V1Beta APIs | | Google.Cloud.Workflows.Executions.V1 | 1.0.0-beta01 | Workflow Executions (V1 API) | | Google.Cloud.Workflows.Executions.V1Beta | 1.0.0-beta01 | Workflow Executions (V1Beta API) | | Google.Cloud.Workflows.V1 | 1.0.0-beta01 | Workflows (V1 API) | | Google.Cloud.Workflows.V1Beta | 1.0.0-beta01 | Workflows (V1Beta API) | | Google.Identity.AccessContextManager.Type | 1.0.0 | Version-agnostic types for the Google Identity Access Context Manager API | | Google.Identity.AccessContextManager.V1 | 1.1.0 | Protocol buffer types for the Google Identity Access Context Manager API V1 | | Google.LongRunning | 2.1.0 | Support for the Long-Running Operations API pattern | | Grafeas.V1 | 2.1.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 documentation.

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

1. When using

   google-cloud-dotnet

   libraries from within Compute/App Engine, no additional authentication steps are necessary.

2. When using

   google-cloud-dotnet

   libraries elsewhere, you can do one of the following:
   • Define the environment variable GOOGLEAPPLICATIONCREDENTIALS 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.