ctaggart / google-cloud-dotnet

Google Cloud Client Library for .NET
https://googlecloudplatform.github.io/google-cloud-dotnet/
Apache License 2.0
0 stars 0 forks source link

Google Cloud Libraries for .NET

.NET idiomatic client libraries for Google Cloud Platform services.

Travis build Status Appveyor build status Coverage Status

The Google Cloud Libraries for .NET support the following Google Cloud Platform services:

Note: This client is a work-in-progress, and may occasionally make backwards-incompatible changes.

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)(https://cloud.google.com/sdk/). Download the SDK if you haven't already, then login by running the following in the command line:

      gcloud auth login

Contributing

Contributions to this library are always welcome and highly encouraged.

See CONTRIBUTING.md for more information on how to get started.

Versioning

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

Anything with a major version of zero (0.y.z) should not be considered stable - anything may change at any time.

Anything with a suffix after the three numbers (such as 1.0.0-beta01) is expected to work, but further API changes may occur before the next stable release.

License

Apache 2.0 - See LICENSE for more information.