Documentation ¶
Overview ¶
Package cloud is the root of the packages used to access Google Cloud Services. See https://godoc.org/cloud.google.com/go for a full list of sub-packages.
This package documents how to authorize and authenticate the sub packages.
Example (ApplicationDefaultCredentials) ¶
package main import ( "cloud.google.com/go/datastore" "golang.org/x/net/context" ) func main() { ctx := context.Background() // Use Google Application Default Credentials to authorize and authenticate the client. // More information about Application Default Credentials and how to enable is at // https://developers.google.com/identity/protocols/application-default-credentials. // // This is the recommended way of authorizing and authenticating. // // Note: The example uses the datastore client, but the same steps apply to // the other client libraries underneath this package. client, err := datastore.NewClient(ctx, "project-id") if err != nil { // TODO: handle error. } // Use the client. _ = client }
Output:
Example (ServiceAccountFile) ¶
package main import ( "cloud.google.com/go/datastore" "golang.org/x/net/context" "google.golang.org/api/option" ) func main() { // Warning: The better way to use service accounts is to set GOOGLE_APPLICATION_CREDENTIALS // and use the Application Default Credentials. ctx := context.Background() // Use a JSON key file associated with a Google service account to // authenticate and authorize. // Go to https://console.developers.google.com/permissions/serviceaccounts to create // and download a service account key for your project. // // Note: The example uses the datastore client, but the same steps apply to // the other client libraries underneath this package. client, err := datastore.NewClient(ctx, "project-id", option.WithServiceAccountFile("/path/to/service-account-key.json")) if err != nil { // TODO: handle error. } // Use the client. _ = client }
Output:
Directories ¶
Path | Synopsis |
---|---|
Package bigquery provides a client for the BigQuery service.
|
Package bigquery provides a client for the BigQuery service. |
Package bigtable is an API to Google Cloud Bigtable.
|
Package bigtable is an API to Google Cloud Bigtable. |
bttest
Package bttest contains test helpers for working with the bigtable package.
|
Package bttest contains test helpers for working with the bigtable package. |
cmd/cbt
Cbt is a tool for doing basic interactions with Cloud Bigtable.
|
Cbt is a tool for doing basic interactions with Cloud Bigtable. |
cmd/emulator
cbtemulator launches the in-memory Cloud Bigtable server on the given address.
|
cbtemulator launches the in-memory Cloud Bigtable server on the given address. |
cmd/loadtest
Loadtest does some load testing through the Go client library for Cloud Bigtable.
|
Loadtest does some load testing through the Go client library for Cloud Bigtable. |
cmd/scantest
Scantest does scan-related load testing against Cloud Bigtable.
|
Scantest does scan-related load testing against Cloud Bigtable. |
internal/cbtrc
Package cbtrc encapsulates common code for reading .cbtrc files.
|
Package cbtrc encapsulates common code for reading .cbtrc files. |
internal/gax
This is ia snapshot from github.com/googleapis/gax-go with minor modifications.
|
This is ia snapshot from github.com/googleapis/gax-go with minor modifications. |
internal/option
Package option contains common code for dealing with client options.
|
Package option contains common code for dealing with client options. |
cmd
|
|
go-cloud-debug-agent/internal/breakpoints
Package breakpoints handles breakpoint requests we get from the user through the Debuglet Controller, and manages corresponding breakpoints set in the code.
|
Package breakpoints handles breakpoint requests we get from the user through the Debuglet Controller, and manages corresponding breakpoints set in the code. |
go-cloud-debug-agent/internal/controller
Package debuglet is a library for interacting with the Google Cloud Debugger's Debuglet Controller service.
|
Package debuglet is a library for interacting with the Google Cloud Debugger's Debuglet Controller service. |
go-cloud-debug-agent/internal/valuecollector
Package valuecollector is used to collect the values of variables in a program.
|
Package valuecollector is used to collect the values of variables in a program. |
compute
|
|
metadata
Package metadata provides access to Google Compute Engine (GCE) metadata and API service accounts.
|
Package metadata provides access to Google Compute Engine (GCE) metadata and API service accounts. |
Package container contains a Google Container Engine client.
|
Package container contains a Google Container Engine client. |
Package datastore provides a client for Google Cloud Datastore.
|
Package datastore provides a client for Google Cloud Datastore. |
debugger
|
|
apiv2
Package debugger is an experimental, auto-generated package for the debugger API.
|
Package debugger is an experimental, auto-generated package for the debugger API. |
errorreporting
|
|
apiv1beta1
Package errorreporting is an experimental, auto-generated package for the errorreporting API.
|
Package errorreporting is an experimental, auto-generated package for the errorreporting API. |
Package errors is a Google Stackdriver Error Reporting library.
|
Package errors is a Google Stackdriver Error Reporting library. |
examples
|
|
bigquery/concat_table
concat_table is an example client of the bigquery client library.
|
concat_table is an example client of the bigquery client library. |
bigquery/load
load is an example client of the bigquery client library.
|
load is an example client of the bigquery client library. |
bigquery/query
query is an example client of the bigquery client library.
|
query is an example client of the bigquery client library. |
bigquery/read
read is an example client of the bigquery client library.
|
read is an example client of the bigquery client library. |
bigtable/helloworld
Hello world is a sample program demonstrating use of the Bigtable client library to perform basic CRUD operations
|
Hello world is a sample program demonstrating use of the Bigtable client library to perform basic CRUD operations |
bigtable/search
Search is a sample web server that uses Cloud Bigtable as the storage layer for a simple document-storage and full-text-search service.
|
Search is a sample web server that uses Cloud Bigtable as the storage layer for a simple document-storage and full-text-search service. |
bigtable/usercounter
User counter is a program that tracks how often a user has visited the index page.
|
User counter is a program that tracks how often a user has visited the index page. |
storage/appengine
[START sample] Package gcsdemo is an example App Engine app using the Google Cloud Storage API.
|
[START sample] Package gcsdemo is an example App Engine app using the Google Cloud Storage API. |
storage/appenginevm
Package main is an example Mananged VM app using the Google Cloud Storage API.
|
Package main is an example Mananged VM app using the Google Cloud Storage API. |
Package iam supports the resource-specific operations of Google Cloud IAM (Identity and Access Management) for the Google Cloud Libraries.
|
Package iam supports the resource-specific operations of Google Cloud IAM (Identity and Access Management) for the Google Cloud Libraries. |
admin/apiv1
Package admin is an experimental, auto-generated package for the admin API.
|
Package admin is an experimental, auto-generated package for the admin API. |
Package internal provides support for the cloud packages.
|
Package internal provides support for the cloud packages. |
optional
Package optional provides versions of primitive types that can be nil.
|
Package optional provides versions of primitive types that can be nil. |
pretty
Package pretty implements a simple pretty-printer.
|
Package pretty implements a simple pretty-printer. |
testutil
Package testutil contains helper functions for writing tests.
|
Package testutil contains helper functions for writing tests. |
language
|
|
apiv1beta1
Package language is an experimental, auto-generated package for the language API.
|
Package language is an experimental, auto-generated package for the language API. |
Package logging contains a Stackdriver Logging client suitable for writing logs.
|
Package logging contains a Stackdriver Logging client suitable for writing logs. |
apiv2
Package logging is an experimental, auto-generated package for the logging API.
|
Package logging is an experimental, auto-generated package for the logging API. |
internal/testing
Package testing provides support for testing the logging client.
|
Package testing provides support for testing the logging client. |
logadmin
Package logadmin contains a Stackdriver Logging client that can be used for reading logs and working with sinks, metrics and monitored resources.
|
Package logadmin contains a Stackdriver Logging client that can be used for reading logs and working with sinks, metrics and monitored resources. |
Package longrunning supports Long Running Operations for the Google Cloud Libraries.
|
Package longrunning supports Long Running Operations for the Google Cloud Libraries. |
monitoring
|
|
apiv3
Package monitoring is an experimental, auto-generated package for the monitoring API.
|
Package monitoring is an experimental, auto-generated package for the monitoring API. |
Package pubsub provides an easy way to publish and receive Google Cloud Pub/Sub messages, hiding the the details of the underlying server RPCs.
|
Package pubsub provides an easy way to publish and receive Google Cloud Pub/Sub messages, hiding the the details of the underlying server RPCs. |
apiv1
Package pubsub is an experimental, auto-generated package for the pubsub API.
|
Package pubsub is an experimental, auto-generated package for the pubsub API. |
speech
|
|
apiv1beta1
Package speech is an experimental, auto-generated package for the speech API.
|
Package speech is an experimental, auto-generated package for the speech API. |
Package storage contains a Google Cloud Storage client.
|
Package storage contains a Google Cloud Storage client. |
Package trace is a Google Stackdriver Trace library.
|
Package trace is a Google Stackdriver Trace library. |
apiv1
Package trace is an experimental, auto-generated package for the trace API.
|
Package trace is an experimental, auto-generated package for the trace API. |
Package vision provides a client for the Google Cloud Vision API.
|
Package vision provides a client for the Google Cloud Vision API. |
apiv1
Package vision is an experimental, auto-generated package for the vision API.
|
Package vision is an experimental, auto-generated package for the vision API. |
Click to show internal directories.
Click to hide internal directories.