Skip to content

Latest commit

 

History

History
230 lines (206 loc) · 31.3 KB

README.md

File metadata and controls

230 lines (206 loc) · 31.3 KB

Google Cloud Libraries for .NET

.NET idiomatic client libraries for Google Cloud Platform services.

GitHub Actions status

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-alpha06 Analytics Admin
Google.Analytics.Data.V1Alpha 1.0.0-alpha05 Google Analytics Data (V1Alpha API)
Google.Analytics.Data.V1Beta 1.0.0-beta03 Google Analytics Data (V1Beta API)
Google.Apps.Script.Type 1.0.0 Version-agnostic types for Apps Script APIs
Google.Area120.Tables.V1Alpha1 1.0.0-alpha03 Google Area 120 Tables
Google.Cloud.AccessApproval.V1 1.1.0 Access Approval
Google.Cloud.ApiGateway.V1 1.0.0 API Gateway
Google.Cloud.ApigeeConnect.V1 1.0.0-beta01 Apigee Connect
Google.Cloud.AppEngine.V1 1.1.0 App Engine Audit Data
Google.Cloud.ArtifactRegistry.V1Beta2 1.0.0-beta02 Artifact Registry
Google.Cloud.Asset.V1 2.8.0 Google Cloud Asset Inventory
Google.Cloud.AssuredWorkloads.V1Beta1 1.0.0-beta04 Assured Workloads
Google.Cloud.AutoML.V1 2.2.0 Google AutoML
Google.Cloud.BigQuery.Connection.V1 1.2.0 BigQuery Connection
Google.Cloud.BigQuery.DataTransfer.V1 3.1.0 Google BigQuery Data Transfer
Google.Cloud.BigQuery.Reservation.V1 1.2.0 BigQuery Reservation
Google.Cloud.BigQuery.V2 2.2.0 Google BigQuery
Google.Cloud.BigQuery.Storage.V1 2.2.0 Google BigQuery Storage
Google.Cloud.Bigtable.Admin.V2 2.4.0 Google Cloud Bigtable Administration
Google.Cloud.Bigtable.Common.V2 2.1.0 Common code used by Bigtable V2 APIs
Google.Cloud.Bigtable.V2 2.2.0 Google Bigtable
Google.Cloud.Billing.Budgets.V1 1.1.0 Cloud Billing Budget (V1 API)
Google.Cloud.Billing.Budgets.V1Beta1 1.0.0-beta03 Cloud Billing Budget (V1Beta1 API)
Google.Cloud.Billing.V1 2.2.0 Google Cloud Billing
Google.Cloud.BinaryAuthorization.V1Beta1 1.0.0-beta02 Binary Authorization
Google.Cloud.Channel.V1 1.1.0 Cloud Channel
Google.Cloud.CloudBuild.V1 1.1.0 Cloud Build
Google.Cloud.CloudDms.V1 1.0.0-beta01 Database Migration
Google.Cloud.Compute.V1 1.0.0-alpha01 Compute Engine
Google.Cloud.Container.V1 2.3.0 Google Kubernetes Engine
Google.Cloud.DataCatalog.V1 1.2.0 Data Catalog
Google.Cloud.DataLabeling.V1Beta1 1.0.0-beta02 Data Labeling
Google.Cloud.DataQnA.V1Alpha 1.0.0-alpha02 Data QnA
Google.Cloud.Dataproc.V1 3.1.0 Google Cloud Dataproc
Google.Cloud.Datastore.Admin.V1 1.1.0 Cloud Datastore
Google.Cloud.Datastore.V1 3.2.0 Google Cloud Datastore
Google.Cloud.Debugger.V2 2.3.0 Google Cloud Debugger
Google.Cloud.DevTools.Common 2.1.0 Common Protocol Buffer messages for Google Cloud Developer Tools APIs
Google.Cloud.DevTools.ContainerAnalysis.V1 2.2.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.1.0 Dialogflow
Google.Cloud.Dialogflow.V2 3.2.0 Google Cloud Dialogflow
Google.Cloud.Dlp.V2 3.2.0 Google Cloud Data Loss Prevention
Google.Cloud.DocumentAI.V1 1.0.0 Cloud Document AI (V1 API)
Google.Cloud.DocumentAI.V1Beta2 1.0.0-beta03 Cloud Document AI (V1Beta2 API)
Google.Cloud.Domains.V1Beta1 1.0.0-beta02 Cloud Domains
Google.Cloud.ErrorReporting.V1Beta1 2.0.0-beta04 Google Cloud Error Reporting
Google.Cloud.EssentialContacts.V1 1.0.0 Essential Contacts
Google.Cloud.Firestore.Admin.V1 2.2.0 Firestore Administration (e.g. index management)
Google.Cloud.Firestore 2.4.0 Firestore high-level library
Google.Cloud.Firestore.V1 2.3.0 Firestore low-level API access
Google.Cloud.Functions.V1 1.1.0 Cloud Functions
Google.Cloud.GSuiteAddOns.V1 1.0.0 Google Workspace Add-ons
Google.Cloud.Gaming.V1 1.1.0 Game Services
Google.Cloud.Gaming.V1Beta 1.0.0-beta07 Google Cloud for Games
Google.Cloud.GkeConnect.Gateway.V1Beta1 1.0.0-beta01 Connect Gateway
Google.Cloud.GkeHub.V1Beta1 1.0.0-beta02 GKE Hub
Google.Cloud.Iam.Admin.V1 1.0.0-beta01 Identity and Access Management (IAM)
Google.Cloud.Iam.Credentials.V1 1.1.0 IAM Service Account Credentials
Google.Cloud.Iam.V1 2.2.0 Google Cloud Identity and Access Management (IAM)
Google.Cloud.Iot.V1 1.1.0 Cloud IoT
Google.Cloud.Kms.V1 2.2.0 Google Cloud Key Management Service
Google.Cloud.Language.V1 2.2.0 Google Cloud Natural Language
Google.Cloud.LifeSciences.V2Beta 1.0.0-beta01 Cloud Life Sciences
Google.Cloud.Logging.Log4Net 3.3.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.3.0 Version-agnostic types for the Google Cloud Logging API
Google.Cloud.Logging.V2 3.3.0 Google Cloud Logging
Google.Cloud.ManagedIdentities.V1 2.2.0 Managed Service for Microsoft Active Directory
Google.Cloud.MediaTranslation.V1Beta1 1.0.0-beta02 Media Translation
Google.Cloud.Memcache.V1 1.1.0 Cloud Memorystore for Memcached
Google.Cloud.Memcache.V1Beta2 1.0.0-beta04 Google Cloud Memorystore for Memcache
Google.Cloud.Metastore.V1 1.0.0 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.3.0 Google Cloud Monitoring
Google.Cloud.NetworkConnectivity.V1Alpha1 1.0.0-alpha02 Network Connectivity
Google.Cloud.Notebooks.V1Beta1 1.0.0-beta03 AI Platform Notebooks
Google.Cloud.OrgPolicy.V1 2.2.0 OrgPolicy API messages
Google.Cloud.OrgPolicy.V2 1.0.0 Organization Policy
Google.Cloud.OsConfig.V1 1.3.0 Google Cloud OS Config (V1 API)
Google.Cloud.OsConfig.V1Alpha 1.0.0-alpha01 Google Cloud OS Config (V1Alpha API)
Google.Cloud.OsLogin.Common 2.2.0 Version-agnostic types for the Google OS Login API
Google.Cloud.OsLogin.V1 2.2.0 Google Cloud OS Login (V1 API)
Google.Cloud.OsLogin.V1Beta 2.0.0-beta04 Google Cloud OS Login (V1Beta API)
Google.Cloud.PhishingProtection.V1Beta1 1.0.0-beta04 Cloud Phishing Protection
Google.Cloud.PolicyTroubleshooter.V1 1.1.0 Policy Troubleshooter
Google.Cloud.PrivateCatalog.V1Beta1 1.0.0-beta01 Cloud Private Catalog
Google.Cloud.Profiler.V2 1.1.0 Cloud Profiler
Google.Cloud.PubSub.V1 2.5.0 Cloud Pub/Sub
Google.Cloud.RecaptchaEnterprise.V1 1.2.0 Google Cloud reCAPTCHA Enterprise (V1 API)
Google.Cloud.RecaptchaEnterprise.V1Beta1 1.0.0-beta04 Google Cloud reCAPTCHA Enterprise (V1Beta1 API)
Google.Cloud.RecommendationEngine.V1Beta1 1.0.0-beta02 Recommendations AI
Google.Cloud.Recommender.V1 2.5.0 Google Cloud Recommender
Google.Cloud.Redis.V1 2.2.0 Google Cloud Memorystore for Redis (V1 API)
Google.Cloud.Redis.V1Beta1 2.0.0-beta04 Google Cloud Memorystore for Redis (V1Beta1 API)
Google.Cloud.ResourceSettings.V1 1.0.0-beta01 Resource Settings
Google.Cloud.Retail.V2 1.1.0 Retail
Google.Cloud.Scheduler.V1 2.2.0 Google Cloud Scheduler
Google.Cloud.SecretManager.V1 1.4.0 Secret Manager (V1 API)
Google.Cloud.SecretManager.V1Beta1 2.0.0-beta04 Secret Manager (V1Beta1 API)
Google.Cloud.Security.PrivateCA.V1 1.0.0-beta01 Certificate Authority (V1 API)
Google.Cloud.Security.PrivateCA.V1Beta1 1.0.0-beta02 Certificate Authority (V1Beta1 API)
Google.Cloud.SecurityCenter.Settings.V1Beta1 1.0.0-beta03 Google Cloud Security Command Center Settings
Google.Cloud.SecurityCenter.V1 2.3.0 Google Cloud Security Command Center (V1 API)
Google.Cloud.SecurityCenter.V1P1Beta1 2.0.0-beta05 Google Cloud Security Command Center (V1P1Beta1 API)
Google.Cloud.ServiceControl.V1 1.1.0 Service Control
Google.Cloud.ServiceDirectory.V1 1.1.0 Service Directory (V1 API)
Google.Cloud.ServiceDirectory.V1Beta1 1.0.0-beta04 Service Directory (V1Beta1 API)
Google.Cloud.ServiceManagement.V1 1.1.0 Service Management
Google.Cloud.ServiceUsage.V1 1.0.0-beta01 Service Usage
Google.Cloud.Shell.V1 1.0.0 Cloud Shell
Google.Cloud.Spanner.Admin.Database.V1 3.9.0 Google Cloud Spanner Database Administration
Google.Cloud.Spanner.Admin.Instance.V1 3.9.0 Google Cloud Spanner Instance Administration
Google.Cloud.Spanner.Data 3.9.0 Google ADO.NET Provider for Google Cloud Spanner
Google.Cloud.Spanner.Common.V1 3.9.0 Common resource names used by all Spanner V1 APIs
Google.Cloud.Spanner.V1 3.9.0 Google Cloud Spanner
Google.Cloud.Speech.V1 2.2.0 Google Cloud Speech (V1 API)
Google.Cloud.Speech.V1P1Beta1 2.0.0-beta04 Google Cloud Speech (V1P1Beta1 API)
Google.Cloud.Storage.V1 3.5.0 Google Cloud Storage
Google.Cloud.Talent.V4 1.1.0 Google Cloud Talent Solution (V4 API)
Google.Cloud.Talent.V4Beta1 2.0.0-beta05 Google Cloud Talent Solution (V4Beta1 API)
Google.Cloud.Tasks.V2 2.2.0 Google Cloud Tasks (V2 API)
Google.Cloud.Tasks.V2Beta3 2.0.0-beta05 Google Cloud Tasks (V2Beta3 API)
Google.Cloud.TextToSpeech.V1 2.2.0 Google Cloud Text-to-Speech (V1 API)
Google.Cloud.TextToSpeech.V1Beta1 1.0.0-beta01 Google Cloud Text-to-Speech (V1Beta1 API)
Google.Cloud.Tpu.V1 1.0.0-beta01 Cloud TPU
Google.Cloud.Trace.V1 2.2.0 Google Cloud Trace (V1 API)
Google.Cloud.Trace.V2 2.2.0 Google Cloud Trace (V2 API)
Google.Cloud.Translate.V3 2.2.0 Google Cloud Translation (V3 API)
Google.Cloud.Translation.V2 2.1.0 Google Cloud Translation (V2 API)
Google.Cloud.Video.Transcoder.V1Beta1 1.0.0-beta02 Transcoder
Google.Cloud.VideoIntelligence.V1 2.2.0 Google Cloud Video Intelligence
Google.Cloud.Vision.V1 2.3.0 Google Cloud Vision
Google.Cloud.VpcAccess.V1 1.0.0-beta01 Serverless VPC Access
Google.Cloud.WebRisk.V1 1.2.0 Google Cloud Web Risk (V1 API)
Google.Cloud.WebRisk.V1Beta1 2.0.0-beta04 Google Cloud Web Risk (V1Beta1 API)
Google.Cloud.WebSecurityScanner.V1 1.1.0 Web Security Scanner
Google.Cloud.Workflows.Common.V1 1.0.0 Common resource names used by all Workflows V1 APIs
Google.Cloud.Workflows.Common.V1Beta 1.0.0-beta02 Common resource names used by all Workflows V1Beta APIs
Google.Cloud.Workflows.Executions.V1 1.0.0 Workflow Executions (V1 API)
Google.Cloud.Workflows.Executions.V1Beta 1.0.0-beta02 Workflow Executions (V1Beta API)
Google.Cloud.Workflows.V1 1.0.0 Workflows (V1 API)
Google.Cloud.Workflows.V1Beta 1.0.0-beta02 Workflows (V1Beta API)
Google.Identity.AccessContextManager.Type 1.1.0 Version-agnostic types for the Google Identity Access Context Manager API
Google.Identity.AccessContextManager.V1 1.2.0 Protocol buffer types for the Google Identity Access Context Manager API V1
Google.LongRunning 2.2.0 Support for the Long-Running Operations API pattern
Grafeas.V1 2.2.0 Grafeas

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

Example Applications

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 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.