Skip to content
Google Cloud Client Libraries for .NET
C# Python Shell PowerShell sed Batchfile
Branch: master
Clone or download
jskeet Handle event keyword in codegen, replacing it with @event
(The solution file is just an update via VS, and can be ignored.)
Latest commit 15e5d90 Nov 18, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Fix link to docs/README.md Aug 10, 2019
.kokoro First attempt at an autorelease script Sep 2, 2019
adhoc Update remaining files referring to GoogleCloudPlatform Sep 17, 2018
analyzerScripts Add analyzer to warn about wrong UseGoogleTrace/UseMvc order (#2054) Apr 25, 2018
apis Handle event keyword in codegen, replacing it with @event Nov 18, 2019
conformance-tests @ 54cc443 Update conformance tests Oct 29, 2019
docker Add a Dockerfile and environment details Nov 18, 2019
docs Remove Spanner Entity Framework Core provider source Nov 8, 2019
third_party/BreakingChangesDetector Remove IOperation feature flag. It is no longer required with the lat… May 7, 2018
tools Add Obsolete checking (#3718) Nov 8, 2019
.gitattributes Make API generation simpler on Windows Sep 6, 2017
.gitignore First attempt at a synth script Jul 2, 2019
.gitmodules Conformance test submodule and update script May 10, 2019
.travis.yml Fix Travis PR-detection for the change job Oct 8, 2019
BACKLOG.md Add to #2513 to backlog Aug 20, 2019
CODE_OF_CONDUCT.md Add Code of Conduct Jul 2, 2018
CONVENTIONS.md Cleanup default expressions (#1388) Sep 21, 2017
CommonResourcesConfig.json Allow for common resource configuration in the generator script Oct 16, 2019
ENVIRONMENT.md Add a Dockerfile and environment details Nov 18, 2019
LICENSE Initial commit May 19, 2015
NEWAPI.md Allow generation script to handle different generators Jul 2, 2019
PROCESSES.md Changes to API generation Jul 1, 2019
README.md Add WebRisk to the README and root docs Oct 22, 2019
TESTING.md Add snippets for Cloud Scheduler Mar 7, 2019
appveyor.sh Initialize submodules in AppVeyor May 10, 2019
appveyor.yml Remove coveralls token from AppVeyor configuration Oct 12, 2018
build.sh Improve Travis jobs Sep 19, 2019
buildrelease.sh Fix release build script Jun 17, 2019
checkcompatibility.sh Script to check compatibility between two branches May 17, 2019
checkpackagecompatibility.sh Script to help check package compatibility Sep 13, 2019
cleantestdata.sh Minor script changes for clarity of build timing Oct 15, 2018
codecov.yml Remove codecov from pull requests Apr 13, 2018
createcoveragereport.sh Don't show progress when installing codecov with chocolatey Oct 11, 2018
detect-pr-changes.sh Apply continue instead of break again Oct 8, 2019
generateapis.sh Move Bigtable.V2 to the microgenerator Nov 14, 2019
generateprojects.sh Add executable bit to all scripts Oct 2, 2018
global.json Update .NET SDK requirement to 2.2.100 Feb 13, 2019
grpc.ruleset Public dependency analyzer (#1456) Sep 18, 2017
processbuildtiminglog.sh Infrastructure for logging build actions to create a log file, then p… Oct 12, 2018
runintegrationtests.sh Use - instead of / for dotcover command line argument Oct 17, 2018
tagreleases.sh Remove dotnet restore from tagreleases.sh Nov 13, 2019
toolversions.sh Make the microgenerator run under Linux Sep 18, 2019
updateconformancetests.sh Use the conformance test data for Firestore in the central repo Jun 25, 2019
uploaddocs.sh Add a base URL for xrefmap.yml Jun 26, 2019

README.md

Google Cloud Libraries for .NET

.NET idiomatic client libraries for Google Cloud Platform services.

Travis build Status Appveyor build status Coverage Status

The following libraries are available at a GA quality level:

The following libraries are available at a beta quality level:

The following libraries are available at an alpha quality level:

  • Google Cloud Metadata - API docs (alpha)

See the API documentation for details of the status of each library.

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

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, according to the following quality levels:

GA: Libraries defined at a GA (General Availability) quality level are expected to be stable: breaking API changes will not be made without a new major release.

Beta: Libraries defined at a Beta quality level are expected to be stable and working, but the API surface is still under active development. We encourage you to experiment with these libraries, but expect breaking changes in future versions. There may still be issues, but we have a fairly high degree of confidence.

Alpha: Libraries defined at an Alpha quality level are still experimental. They may have significant issues, and the API surface will almost certainly change before a final release. We encourage experimentation with these libraries on test projects, but strongly discourage you from using them in a production environment.

License

Apache 2.0 - See LICENSE for more information.

You can’t perform that action at this time.