cloud.google.com/go => github.com/googleapis/google-cloud-go (every 8h) https://github.com/googleapis/google-cloud-go
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Noah dabad2cceb expr/cel: migrate to microgen 2 days ago
.github .github: add FR and PR templates 1 week ago
asset all: auto-regenerate gapics 3 days ago
automl all: auto-regenerate gapics 3 days ago
bigquery release: bigquery/v1.4.0 2 days ago
bigtable all: auto-regenerate gapics 3 days ago
civil all: modify copyright notice 1 year ago
cloudbuild/apiv1 all: auto-regenerate gapics 3 days ago
cloudtasks all: auto-regenerate gapics 3 days ago
cmd/go-cloud-debug-agent internal: add licenses to shell scripts 5 months ago
compute/metadata compute/metadata: unset ResponseHeaderTimeout in defaultClient 2 weeks ago
container All: regen gapics. 4 months ago
containeranalysis all: auto-regenerate gapics 3 days ago
datacatalog/apiv1beta1 all: auto-regenerate gapics 3 days ago
dataproc all: auto-regenerate gapics 3 days ago
datastore all: auto-regenerate gapics 3 days ago
debugger/apiv2 all: auto-regenerate gapics 3 days ago
dialogflow/apiv2 all: auto-regenerate gapics 3 days ago
dlp/apiv2 all: auto-regenerate gapics 3 days ago
errorreporting all: auto-regenerate gapics 3 days ago
expr/apiv1alpha1 all: auto-regenerate gapics 3 days ago
firestore all: auto-regenerate gapics 3 days ago
functions/metadata functions/metadata: handle string resources 2 months ago
grafeas/apiv1 All: regen gapics. 4 months ago
httpreplay internal: add licenses to shell scripts 5 months ago
iam all: auto-regenerate gapics 3 days ago
internal expr/cel: migrate to microgen 1 day ago
iot/apiv1 all: auto-regenerate gapics 3 days ago
irm/apiv1alpha2 all: auto-regenerate gapics 3 days ago
kms/apiv1 all: auto-regenerate gapics 3 days ago
language all: auto-regenerate gapics 3 days ago
logging all: auto-regenerate gapics 3 days ago
longrunning all: auto-regenerate gapics 3 days ago
monitoring/apiv3 all: auto-regenerate gapics 3 days ago
osconfig all: auto-regenerate gapics 3 days ago
oslogin all: auto-regenerate gapics 3 days ago
phishingprotection/apiv1beta1 all: auto-regenerate gapics 3 days ago
profiler profiler: update busybench.go to allow specifying the number of busyworkers 1 month ago
pubsub all: auto-regenerate gapics 3 days ago
recaptchaenterprise/apiv1beta1 all: auto-regenerate gapics 3 days ago
recommender/apiv1beta1 all: auto-regenerate gapics 3 days ago
redis all: auto-regenerate gapics 3 days ago
rpcreplay All: regen gapics. 4 months ago
scheduler all: auto-regenerate gapics 3 days ago
secretmanager/apiv1beta1 all: auto-regenerate gapics 3 days ago
securitycenter all: auto-regenerate gapics 3 days ago
spanner spanner: fix the invalid timestamp boundary in tests 2 days ago
speech all: auto-regenerate gapics 3 days ago
storage all: auto-regenerate gapics 3 days ago
talent/apiv4beta1 all: auto-regenerate gapics 3 days ago
texttospeech/apiv1 all: auto-regenerate gapics 3 days ago
trace all: auto-regenerate gapics 3 days ago
translate all: auto-regenerate gapics 3 days ago
videointelligence all: auto-regenerate gapics 3 days ago
vision all: auto-regenerate gapics 3 days ago
webrisk/apiv1beta1 all: auto-regenerate gapics 3 days ago
.gitignore internal: add gitignore 2 weeks ago
CHANGES.md release: v0.52.0 3 days ago
CODE_OF_CONDUCT.md docs: add code of conduct 1 year ago
CONTRIBUTING.md docs: small CONTRIBUTING.md fixes 3 months ago
LICENSE LICENSE: use verbatim text 2 years ago
README.md docs: fix kms link in readme 2 weeks ago
RELEASING.md docs: more releasing tweaks 2 months ago
doc.go docs: Add scopes documentation 4 months ago
examples_test.go docs: Add scopes documentation 4 months ago
go.mod all: auto-regenerate gapics 3 days ago
go.sum all: auto-regenerate gapics 3 days ago
license_test.go all: modify copyright notice 1 year ago
tools.go internal/kokoro: add apidiff 10 months ago

README.md

Google Cloud Client Libraries for Go

GoDoc

Go packages for Google Cloud Platform services.

import "cloud.google.com/go"

To install the packages on your system, do not clone the repo. Instead:

  1. Change to your project directory:

    cd /my/cloud/project
    
  2. Get the package you want to use. Some products have their own module, so it's best to go get the package(s) you want to use:

    $ go get cloud.google.com/go/firestore # Replace with the package you want to use.
    

NOTE: Some of these packages are under development, and may occasionally make backwards-incompatible changes.

NOTE: Github repo is a mirror of https://code.googlesource.com/gocloud.

Supported APIs

Google API Status Package
Asset alpha cloud.google.com/go/asset/v1beta
Automl stable cloud.google.com/go/automl/apiv1
BigQuery stable cloud.google.com/go/bigquery
Bigtable stable cloud.google.com/go/bigtable
Cloudbuild stable cloud.google.com/go/cloudbuild/apiv1
Cloudtasks stable cloud.google.com/go/cloudtasks/apiv2
Container stable cloud.google.com/go/container/apiv1
ContainerAnalysis beta cloud.google.com/go/containeranalysis/apiv1
Dataproc stable cloud.google.com/go/dataproc/apiv1
Datastore stable cloud.google.com/go/datastore
Debugger stable cloud.google.com/go/debugger/apiv2
Dialogflow stable cloud.google.com/go/dialogflow/apiv2
Data Loss Prevention stable cloud.google.com/go/dlp/apiv2
ErrorReporting alpha cloud.google.com/go/errorreporting
Firestore stable cloud.google.com/go/firestore
IAM stable cloud.google.com/go/iam
IoT stable cloud.google.com/go/iot/apiv1
IRM alpha cloud.google.com/go/irm/apiv1alpha2
KMS stable cloud.google.com/go/kms/apiv1
Natural Language stable cloud.google.com/go/language/apiv1
Logging stable cloud.google.com/go/logging
Memorystore alpha cloud.google.com/go/redis/apiv1
Monitoring alpha cloud.google.com/go/monitoring/apiv3
OS Login alpha cloud.google.com/go/oslogin/apiv1
Pub/Sub stable cloud.google.com/go/pubsub
Phishing Protection alpha cloud.google.com/go/phishingprotection/apiv1beta1
reCAPTCHA Enterprise alpha cloud.google.com/go/recaptchaenterprise/apiv1beta1
Recommender beta cloud.google.com/go/recommender/apiv1beta1
Scheduler stable cloud.google.com/go/scheduler/apiv1
Securitycenter alpha cloud.google.com/go/securitycenter/apiv1
Spanner stable cloud.google.com/go/spanner
Speech stable cloud.google.com/go/speech/apiv1
Storage stable cloud.google.com/go/storage
Talent alpha cloud.google.com/go/talent/apiv4beta1
Text To Speech alpha cloud.google.com/go/texttospeech/apiv1
Trace alpha cloud.google.com/go/trace/apiv2
Translate stable cloud.google.com/go/translate
Video Intelligence alpha cloud.google.com/go/videointelligence/apiv1beta1
Vision stable cloud.google.com/go/vision/apiv1
Webrisk alpha cloud.google.com/go/webrisk/apiv1beta1

Alpha status: the API is still being actively developed. As a result, it might change in backward-incompatible ways and is not recommended for production use.

Beta status: the API is largely complete, but still has outstanding features and bugs to be addressed. There may be minor backwards-incompatible changes where necessary.

Stable status: the API is mature and ready for production use. We will continue addressing bugs and feature requests.

Documentation and examples are available at godoc.org/cloud.google.com/go

Go Versions Supported

We support the two most recent major versions of Go. If Google App Engine uses an older version, we support that as well.

Authorization

By default, each API will use Google Application Default Credentials for authorization credentials used in calling the API endpoints. This will allow your application to run in many environments without requiring explicit configuration.

client, err := storage.NewClient(ctx)

To authorize using a JSON key file, pass option.WithCredentialsFile to the NewClient function of the desired package. For example:

client, err := storage.NewClient(ctx, option.WithCredentialsFile("path/to/keyfile.json"))

You can exert more control over authorization by using the golang.org/x/oauth2 package to create an oauth2.TokenSource. Then pass option.WithTokenSource to the NewClient function: snip:# (auth-ts)

tokenSource := ...
client, err := storage.NewClient(ctx, option.WithTokenSource(tokenSource))

Contributing

Contributions are welcome. Please, see the CONTRIBUTING document for details. We're using Gerrit for our code reviews. Please don't open pull requests against this repo, new pull requests will be automatically closed.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms. See Contributor Code of Conduct for more information.