|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | 03-May-2022 | - |
| .github/ | H | 18-Oct-2021 | - | 336 | 304 |
| accessapproval/ | H | 18-Oct-2021 | - | 1,577 | 1,177 |
| accesscontextmanager/ | H | 18-Oct-2021 | - | 3,933 | 2,723 |
| aiplatform/ | H | 18-Oct-2021 | - | 18,311 | 12,478 |
| analytics/ | H | 18-Oct-2021 | - | 7,816 | 6,046 |
| apigateway/ | H | 18-Oct-2021 | - | 2,870 | 2,114 |
| apigeeconnect/ | H | 18-Oct-2021 | - | 1,449 | 1,071 |
| appengine/ | H | 18-Oct-2021 | - | 6,097 | 4,019 |
| area120/ | H | 18-Oct-2021 | - | 1,919 | 1,475 |
| artifactregistry/ | H | 18-Oct-2021 | - | 3,029 | 2,298 |
| asset/ | H | 18-Oct-2021 | - | 4,210 | 3,011 |
| assuredworkloads/ | H | 18-Oct-2021 | - | 1,525 | 1,156 |
| automl/ | H | 18-Oct-2021 | - | 11,205 | 8,204 |
| bigquery/ | H | 18-Oct-2021 | - | 71,464 | 60,709 |
| bigtable/ | H | 18-Oct-2021 | - | 20,425 | 16,413 |
| billing/ | H | 18-Oct-2021 | - | 3,946 | 2,782 |
| binaryauthorization/ | H | 18-Oct-2021 | - | 1,593 | 1,218 |
| channel/ | H | 18-Oct-2021 | - | 5,633 | 3,681 |
| civil/ | H | 18-Oct-2021 | - | 794 | 608 |
| cloudbuild/ | H | 18-Oct-2021 | - | 4,070 | 2,888 |
| clouddms/ | H | 18-Oct-2021 | - | 3,091 | 2,224 |
| cloudtasks/ | H | 18-Oct-2021 | - | 9,829 | 7,274 |
| cmd/go-cloud-debug-agent/ | H | 18-Oct-2021 | - | 23,259 | 19,089 |
| compute/ | H | 18-Oct-2021 | - | 74,944 | 52,897 |
| contactcenterinsights/ | H | 18-Oct-2021 | - | 3,540 | 2,756 |
| container/ | H | 18-Oct-2021 | - | 6,194 | 5,005 |
| containeranalysis/ | H | 18-Oct-2021 | - | 5,304 | 3,970 |
| datacatalog/ | H | 18-Oct-2021 | - | 8,319 | 5,960 |
| dataflow/ | H | 18-Oct-2021 | - | 3,482 | 2,402 |
| datafusion/ | H | 18-Oct-2021 | - | 1,902 | 1,403 |
| datalabeling/ | H | 18-Oct-2021 | - | 4,279 | 3,264 |
| dataproc/ | H | 18-Oct-2021 | - | 7,015 | 5,108 |
| dataqna/ | H | 18-Oct-2021 | - | 1,657 | 1,197 |
| datastore/ | H | 03-May-2022 | - | 15,434 | 12,122 |
| datastream/ | H | 18-Oct-2021 | - | 3,562 | 2,599 |
| debugger/apiv2/ | H | 18-Oct-2021 | - | 1,888 | 1,264 |
| deploy/ | H | 18-Oct-2021 | - | 3,048 | 2,271 |
| dialogflow/ | H | 18-Oct-2021 | - | 40,149 | 28,247 |
| dlp/ | H | 18-Oct-2021 | - | 5,777 | 4,535 |
| documentai/ | H | 18-Oct-2021 | - | 2,806 | 1,968 |
| domains/ | H | 18-Oct-2021 | - | 2,395 | 1,701 |
| errorreporting/ | H | 18-Oct-2021 | - | 3,270 | 2,331 |
| essentialcontacts/ | H | 18-Oct-2021 | - | 1,500 | 1,188 |
| eventarc/ | H | 18-Oct-2021 | - | 1,610 | 1,205 |
| filestore/ | H | 18-Oct-2021 | - | 2,456 | 1,770 |
| firestore/ | H | 18-Oct-2021 | - | 33,818 | 28,161 |
| functions/ | H | 18-Oct-2021 | - | 2,365 | 1,731 |
| gaming/ | H | 18-Oct-2021 | - | 8,743 | 6,011 |
| gkeconnect/ | H | 18-Oct-2021 | - | 1,275 | 979 |
| gkehub/ | H | 18-Oct-2021 | - | 1,929 | 1,429 |
| grafeas/ | H | 18-Oct-2021 | - | 2,797 | 2,215 |
| gsuiteaddons/ | H | 18-Oct-2021 | - | 1,673 | 1,291 |
| httpreplay/ | H | 18-Oct-2021 | - | 2,472 | 1,849 |
| iam/ | H | 18-Oct-2021 | - | 4,491 | 3,263 |
| iap/ | H | 18-Oct-2021 | - | 2,031 | 1,533 |
| internal/ | H | 18-Oct-2021 | - | 179,860 | 82,110 |
| iot/ | H | 18-Oct-2021 | - | 3,898 | 3,090 |
| kms/ | H | 18-Oct-2021 | - | 5,301 | 4,155 |
| language/ | H | 18-Oct-2021 | - | 3,364 | 2,516 |
| lifesciences/ | H | 18-Oct-2021 | - | 1,213 | 894 |
| logging/ | H | 18-Oct-2021 | - | 11,837 | 8,679 |
| longrunning/ | H | 18-Oct-2021 | - | 1,760 | 1,143 |
| managedidentities/ | H | 18-Oct-2021 | - | 2,303 | 1,629 |
| mediatranslation/ | H | 18-Oct-2021 | - | 1,103 | 842 |
| memcache/ | H | 18-Oct-2021 | - | 3,394 | 2,297 |
| metastore/ | H | 18-Oct-2021 | - | 7,474 | 5,121 |
| monitoring/ | H | 18-Oct-2021 | - | 15,787 | 11,350 |
| networkconnectivity/ | H | 18-Oct-2021 | - | 3,914 | 2,733 |
| networkmanagement/ | H | 18-Oct-2021 | - | 1,811 | 1,306 |
| networksecurity/ | H | 18-Oct-2021 | - | 2,789 | 2,037 |
| notebooks/ | H | 18-Oct-2021 | - | 3,384 | 2,409 |
| orchestration/ | H | 18-Oct-2021 | - | 1,973 | 1,427 |
| orgpolicy/ | H | 18-Oct-2021 | - | 1,678 | 1,277 |
| osconfig/ | H | 18-Oct-2021 | - | 7,385 | 5,330 |
| oslogin/ | H | 18-Oct-2021 | - | 3,215 | 2,423 |
| phishingprotection/ | H | 18-Oct-2021 | - | 1,250 | 944 |
| policytroubleshooter/ | H | 18-Oct-2021 | - | 1,056 | 827 |
| privatecatalog/ | H | 18-Oct-2021 | - | 1,471 | 1,085 |
| profiler/ | H | 18-Oct-2021 | - | 4,280 | 3,416 |
| pubsub/ | H | 18-Oct-2021 | - | 32,402 | 26,578 |
| pubsublite/ | H | 18-Oct-2021 | - | 24,300 | 17,509 |
| recaptchaenterprise/ | H | 18-Oct-2021 | - | 3,017 | 2,257 |
| recommendationengine/ | H | 18-Oct-2021 | - | 3,246 | 2,354 |
| recommender/ | H | 18-Oct-2021 | - | 3,249 | 2,381 |
| redis/ | H | 18-Oct-2021 | - | 5,910 | 4,302 |
| resourcemanager/ | H | 18-Oct-2021 | - | 8,526 | 5,688 |
| resourcesettings/ | H | 18-Oct-2021 | - | 1,326 | 1,009 |
| retail/ | H | 18-Oct-2021 | - | 4,708 | 3,194 |
| rpcreplay/ | H | 18-Oct-2021 | - | 2,862 | 2,166 |
| scheduler/ | H | 18-Oct-2021 | - | 3,971 | 2,991 |
| secretmanager/ | H | 18-Oct-2021 | - | 3,586 | 2,600 |
| security/ | H | 18-Oct-2021 | - | 7,548 | 5,550 |
| securitycenter/ | H | 18-Oct-2021 | - | 11,613 | 8,843 |
| servicecontrol/ | H | 18-Oct-2021 | - | 1,426 | 1,023 |
| servicedirectory/ | H | 18-Oct-2021 | - | 4,813 | 3,619 |
| servicemanagement/ | H | 18-Oct-2021 | - | 2,729 | 1,956 |
| serviceusage/ | H | 18-Oct-2021 | - | 1,722 | 1,271 |
| shell/ | H | 18-Oct-2021 | - | 1,671 | 1,229 |
| spanner/ | H | 18-Oct-2021 | - | 57,786 | 45,071 |
| speech/ | H | 18-Oct-2021 | - | 3,853 | 2,805 |
| storage/ | H | 18-Oct-2021 | - | 50,493 | 45,513 |
| storagetransfer/ | H | 18-Oct-2021 | - | 1,620 | 1,235 |
| talent/ | H | 18-Oct-2021 | - | 11,065 | 8,002 |
| texttospeech/ | H | 18-Oct-2021 | - | 1,448 | 1,116 |
| third_party/ | H | 18-Oct-2021 | - | 4,413 | 2,894 |
| tpu/ | H | 18-Oct-2021 | - | 2,282 | 1,693 |
| trace/ | H | 18-Oct-2021 | - | 2,587 | 1,826 |
| translate/ | H | 18-Oct-2021 | - | 3,503 | 2,661 |
| video/ | H | 18-Oct-2021 | - | 2,569 | 1,887 |
| videointelligence/ | H | 18-Oct-2021 | - | 2,209 | 1,530 |
| vision/ | H | 18-Oct-2021 | - | 7,093 | 5,231 |
| vpcaccess/ | H | 18-Oct-2021 | - | 1,491 | 1,120 |
| webrisk/ | H | 18-Oct-2021 | - | 2,159 | 1,576 |
| websecurityscanner/ | H | 18-Oct-2021 | - | 2,111 | 1,669 |
| workflows/ | H | 18-Oct-2021 | - | 2,974 | 2,021 |
| .gitignore | H A D | 18-Oct-2021 | 92 | 13 | 10 |
| CHANGES.md | H A D | 18-Oct-2021 | 128.8 KiB | 2,273 | 1,744 |
| CODE_OF_CONDUCT.md | H A D | 18-Oct-2021 | 1.9 KiB | 45 | 35 |
| CONTRIBUTING.md | H A D | 18-Oct-2021 | 13.3 KiB | 328 | 257 |
| LICENSE | H A D | 18-Oct-2021 | 11.1 KiB | 203 | 169 |
| README.md | H A D | 18-Oct-2021 | 5.6 KiB | 133 | 108 |
| RELEASING.md | H A D | 18-Oct-2021 | 6.5 KiB | 142 | 121 |
| SECURITY.md | H A D | 18-Oct-2021 | 329 | 8 | 4 |
| doc.go | H A D | 18-Oct-2021 | 7.9 KiB | 202 | 1 |
| go.mod | H A D | 18-Oct-2021 | 532 | 19 | 16 |
| go.sum | H A D | 18-Oct-2021 | 54.2 KiB | 554 | 553 |
| header_test.go | H A D | 18-Oct-2021 | 2.5 KiB | 92 | 63 |
| testing.md | H A D | 18-Oct-2021 | 8.9 KiB | 237 | 199 |
README.md
1# Google Cloud Client Libraries for Go
2
3[![Go Reference](https://pkg.go.dev/badge/cloud.google.com/go.svg)](https://pkg.go.dev/cloud.google.com/go)
4
5Go packages for [Google Cloud Platform](https://cloud.google.com) services.
6
7``` go
8import "cloud.google.com/go"
9```
10
11To install the packages on your system, *do not clone the repo*. Instead:
12
131. Change to your project directory:
14
15 ```bash
16 cd /my/cloud/project
17 ```
181. Get the package you want to use. Some products have their own module, so it's
19 best to `go get` the package(s) you want to use:
20
21 ```
22 $ go get cloud.google.com/go/firestore # Replace with the package you want to use.
23 ```
24
25**NOTE:** Some of these packages are under development, and may occasionally
26make backwards-incompatible changes.
27
28## Supported APIs
29
30For an updated list of all of our released APIs please see our
31[reference docs](https://cloud.google.com/go/docs/reference).
32
33## [Go Versions Supported](#supported-versions)
34
35We currently support Go versions 1.11 and newer.
36
37## Authorization
38
39By default, each API will use [Google Application Default Credentials](https://developers.google.com/identity/protocols/application-default-credentials)
40for authorization credentials used in calling the API endpoints. This will allow your
41application to run in many environments without requiring explicit configuration.
42
43[snip]:# (auth)
44```go
45client, err := storage.NewClient(ctx)
46```
47
48To authorize using a
49[JSON key file](https://cloud.google.com/iam/docs/managing-service-account-keys),
50pass
51[`option.WithCredentialsFile`](https://pkg.go.dev/google.golang.org/api/option#WithCredentialsFile)
52to the `NewClient` function of the desired package. For example:
53
54[snip]:# (auth-JSON)
55```go
56client, err := storage.NewClient(ctx, option.WithCredentialsFile("path/to/keyfile.json"))
57```
58
59You can exert more control over authorization by using the
60[`golang.org/x/oauth2`](https://pkg.go.dev/golang.org/x/oauth2) package to
61create an `oauth2.TokenSource`. Then pass
62[`option.WithTokenSource`](https://pkg.go.dev/google.golang.org/api/option#WithTokenSource)
63to the `NewClient` function:
64[snip]:# (auth-ts)
65```go
66tokenSource := ...
67client, err := storage.NewClient(ctx, option.WithTokenSource(tokenSource))
68```
69
70## Contributing
71
72Contributions are welcome. Please, see the
73[CONTRIBUTING](https://github.com/GoogleCloudPlatform/google-cloud-go/blob/master/CONTRIBUTING.md)
74document for details.
75
76Please note that this project is released with a Contributor Code of Conduct.
77By participating in this project you agree to abide by its terms.
78See [Contributor Code of Conduct](https://github.com/GoogleCloudPlatform/google-cloud-go/blob/master/CONTRIBUTING.md#contributor-code-of-conduct)
79for more information.
80
81[cloud-asset]: https://cloud.google.com/security-command-center/docs/how-to-asset-inventory
82[cloud-automl]: https://cloud.google.com/automl
83[cloud-build]: https://cloud.google.com/cloud-build/
84[cloud-bigquery]: https://cloud.google.com/bigquery/
85[cloud-bigtable]: https://cloud.google.com/bigtable/
86[cloud-compute]: https://cloud.google.com/compute
87[cloud-container]: https://cloud.google.com/containers/
88[cloud-containeranalysis]: https://cloud.google.com/container-registry/docs/container-analysis
89[cloud-dataproc]: https://cloud.google.com/dataproc/
90[cloud-datastore]: https://cloud.google.com/datastore/
91[cloud-dialogflow]: https://cloud.google.com/dialogflow-enterprise/
92[cloud-debugger]: https://cloud.google.com/debugger/
93[cloud-dlp]: https://cloud.google.com/dlp/
94[cloud-errors]: https://cloud.google.com/error-reporting/
95[cloud-firestore]: https://cloud.google.com/firestore/
96[cloud-iam]: https://cloud.google.com/iam/
97[cloud-iot]: https://cloud.google.com/iot-core/
98[cloud-irm]: https://cloud.google.com/incident-response/docs/concepts
99[cloud-kms]: https://cloud.google.com/kms/
100[cloud-pubsub]: https://cloud.google.com/pubsub/
101[cloud-pubsublite]: https://cloud.google.com/pubsub/lite
102[cloud-storage]: https://cloud.google.com/storage/
103[cloud-language]: https://cloud.google.com/natural-language
104[cloud-logging]: https://cloud.google.com/logging/
105[cloud-natural-language]: https://cloud.google.com/natural-language/
106[cloud-memorystore]: https://cloud.google.com/memorystore/
107[cloud-monitoring]: https://cloud.google.com/monitoring/
108[cloud-oslogin]: https://cloud.google.com/compute/docs/oslogin/rest
109[cloud-phishingprotection]: https://cloud.google.com/phishing-protection/
110[cloud-securitycenter]: https://cloud.google.com/security-command-center/
111[cloud-scheduler]: https://cloud.google.com/scheduler
112[cloud-spanner]: https://cloud.google.com/spanner/
113[cloud-speech]: https://cloud.google.com/speech
114[cloud-talent]: https://cloud.google.com/solutions/talent-solution/
115[cloud-tasks]: https://cloud.google.com/tasks/
116[cloud-texttospeech]: https://cloud.google.com/texttospeech/
117[cloud-talent]: https://cloud.google.com/solutions/talent-solution/
118[cloud-trace]: https://cloud.google.com/trace/
119[cloud-translate]: https://cloud.google.com/translate
120[cloud-recaptcha]: https://cloud.google.com/recaptcha-enterprise/
121[cloud-recommender]: https://cloud.google.com/recommendations/
122[cloud-video]: https://cloud.google.com/video-intelligence/
123[cloud-vision]: https://cloud.google.com/vision
124[cloud-webrisk]: https://cloud.google.com/web-risk/
125
126## Links
127
128- [Go on Google Cloud](https://cloud.google.com/go/home)
129- [Getting started with Go on Google Cloud](https://cloud.google.com/go/getting-started)
130- [App Engine Quickstart](https://cloud.google.com/appengine/docs/standard/go/quickstart)
131- [Cloud Functions Quickstart](https://cloud.google.com/functions/docs/quickstart-go)
132- [Cloud Run Quickstart](https://cloud.google.com/run/docs/quickstarts/build-and-deploy#go)
133