|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | 03-May-2022 | - |
| .github/ | H | 29-Sep-2021 | - | 332 | 300 |
| accessapproval/ | H | 29-Sep-2021 | - | 1,574 | 1,174 |
| accesscontextmanager/ | H | 29-Sep-2021 | - | 3,925 | 2,715 |
| aiplatform/ | H | 29-Sep-2021 | - | 12,779 | 8,690 |
| analytics/ | H | 29-Sep-2021 | - | 7,809 | 6,039 |
| apigateway/ | H | 29-Sep-2021 | - | 2,863 | 2,107 |
| apigeeconnect/ | H | 29-Sep-2021 | - | 1,446 | 1,068 |
| appengine/ | H | 29-Sep-2021 | - | 6,090 | 4,012 |
| area120/ | H | 29-Sep-2021 | - | 1,912 | 1,468 |
| artifactregistry/ | H | 29-Sep-2021 | - | 3,022 | 2,291 |
| asset/ | H | 29-Sep-2021 | - | 4,203 | 3,004 |
| assuredworkloads/ | H | 29-Sep-2021 | - | 1,518 | 1,149 |
| automl/ | H | 29-Sep-2021 | - | 11,198 | 8,197 |
| bigquery/ | H | 29-Sep-2021 | - | 71,395 | 60,650 |
| bigtable/ | H | 29-Sep-2021 | - | 20,401 | 16,390 |
| billing/ | H | 29-Sep-2021 | - | 3,943 | 2,779 |
| binaryauthorization/ | H | 29-Sep-2021 | - | 1,586 | 1,211 |
| channel/ | H | 29-Sep-2021 | - | 5,626 | 3,674 |
| civil/ | H | 29-Sep-2021 | - | 794 | 608 |
| cloudbuild/ | H | 29-Sep-2021 | - | 4,063 | 2,881 |
| clouddms/ | H | 29-Sep-2021 | - | 3,083 | 2,216 |
| cloudtasks/ | H | 29-Sep-2021 | - | 9,826 | 7,271 |
| cmd/go-cloud-debug-agent/ | H | 29-Sep-2021 | - | 23,259 | 19,089 |
| compute/ | H | 29-Sep-2021 | - | 74,907 | 52,863 |
| contactcenterinsights/ | H | 29-Sep-2021 | - | 3,535 | 2,751 |
| container/ | H | 29-Sep-2021 | - | 6,187 | 4,998 |
| containeranalysis/ | H | 29-Sep-2021 | - | 5,297 | 3,963 |
| datacatalog/ | H | 29-Sep-2021 | - | 8,316 | 5,957 |
| dataflow/ | H | 29-Sep-2021 | - | 3,475 | 2,395 |
| datafusion/ | H | 29-Sep-2021 | - | 1,895 | 1,396 |
| datalabeling/ | H | 29-Sep-2021 | - | 4,272 | 3,257 |
| dataproc/ | H | 29-Sep-2021 | - | 6,399 | 4,708 |
| dataqna/ | H | 29-Sep-2021 | - | 1,650 | 1,190 |
| datastore/ | H | 03-May-2022 | - | 15,426 | 12,114 |
| datastream/ | H | 29-Sep-2021 | - | 3,555 | 2,592 |
| debugger/apiv2/ | H | 29-Sep-2021 | - | 1,888 | 1,264 |
| dialogflow/ | H | 29-Sep-2021 | - | 38,735 | 27,461 |
| dlp/ | H | 29-Sep-2021 | - | 5,774 | 4,532 |
| documentai/ | H | 29-Sep-2021 | - | 2,799 | 1,961 |
| domains/ | H | 29-Sep-2021 | - | 2,388 | 1,694 |
| errorreporting/ | H | 29-Sep-2021 | - | 3,263 | 2,324 |
| essentialcontacts/ | H | 29-Sep-2021 | - | 1,497 | 1,185 |
| eventarc/ | H | 29-Sep-2021 | - | 1,603 | 1,198 |
| firestore/ | H | 29-Sep-2021 | - | 33,808 | 28,152 |
| functions/ | H | 29-Sep-2021 | - | 2,358 | 1,724 |
| gaming/ | H | 29-Sep-2021 | - | 8,736 | 6,004 |
| gkeconnect/ | H | 29-Sep-2021 | - | 1,268 | 972 |
| gkehub/ | H | 29-Sep-2021 | - | 1,922 | 1,422 |
| grafeas/ | H | 29-Sep-2021 | - | 2,779 | 2,197 |
| gsuiteaddons/ | H | 29-Sep-2021 | - | 1,670 | 1,288 |
| httpreplay/ | H | 29-Sep-2021 | - | 2,472 | 1,849 |
| iam/ | H | 29-Sep-2021 | - | 4,491 | 3,263 |
| iap/ | H | 29-Sep-2021 | - | 2,028 | 1,530 |
| internal/ | H | 29-Sep-2021 | - | 174,396 | 79,810 |
| iot/ | H | 29-Sep-2021 | - | 3,891 | 3,083 |
| kms/ | H | 29-Sep-2021 | - | 5,245 | 4,099 |
| language/ | H | 29-Sep-2021 | - | 3,357 | 2,509 |
| lifesciences/ | H | 29-Sep-2021 | - | 1,206 | 887 |
| logging/ | H | 29-Sep-2021 | - | 11,829 | 8,671 |
| longrunning/ | H | 29-Sep-2021 | - | 1,760 | 1,143 |
| managedidentities/ | H | 29-Sep-2021 | - | 2,296 | 1,622 |
| mediatranslation/ | H | 29-Sep-2021 | - | 1,096 | 835 |
| memcache/ | H | 29-Sep-2021 | - | 3,387 | 2,290 |
| metastore/ | H | 29-Sep-2021 | - | 7,467 | 5,114 |
| monitoring/ | H | 29-Sep-2021 | - | 15,729 | 11,311 |
| networkconnectivity/ | H | 29-Sep-2021 | - | 3,907 | 2,726 |
| networkmanagement/ | H | 29-Sep-2021 | - | 1,804 | 1,299 |
| networksecurity/ | H | 29-Sep-2021 | - | 2,782 | 2,030 |
| notebooks/ | H | 29-Sep-2021 | - | 3,377 | 2,402 |
| orchestration/ | H | 29-Sep-2021 | - | 1,970 | 1,424 |
| orgpolicy/ | H | 29-Sep-2021 | - | 1,675 | 1,274 |
| osconfig/ | H | 29-Sep-2021 | - | 7,378 | 5,323 |
| oslogin/ | H | 29-Sep-2021 | - | 3,212 | 2,420 |
| phishingprotection/ | H | 29-Sep-2021 | - | 1,243 | 937 |
| policytroubleshooter/ | H | 29-Sep-2021 | - | 1,053 | 824 |
| privatecatalog/ | H | 29-Sep-2021 | - | 1,464 | 1,078 |
| profiler/ | H | 29-Sep-2021 | - | 4,245 | 3,386 |
| pubsub/ | H | 29-Sep-2021 | - | 32,381 | 26,578 |
| pubsublite/ | H | 29-Sep-2021 | - | 24,002 | 17,301 |
| recaptchaenterprise/ | H | 29-Sep-2021 | - | 3,014 | 2,254 |
| recommendationengine/ | H | 29-Sep-2021 | - | 3,228 | 2,336 |
| recommender/ | H | 29-Sep-2021 | - | 3,246 | 2,378 |
| redis/ | H | 29-Sep-2021 | - | 5,903 | 4,295 |
| resourcemanager/ | H | 29-Sep-2021 | - | 8,519 | 5,681 |
| resourcesettings/ | H | 29-Sep-2021 | - | 1,323 | 1,006 |
| retail/ | H | 29-Sep-2021 | - | 4,701 | 3,187 |
| rpcreplay/ | H | 29-Sep-2021 | - | 2,862 | 2,166 |
| scheduler/ | H | 29-Sep-2021 | - | 3,968 | 2,988 |
| secretmanager/ | H | 29-Sep-2021 | - | 3,579 | 2,593 |
| security/ | H | 29-Sep-2021 | - | 7,198 | 5,286 |
| securitycenter/ | H | 29-Sep-2021 | - | 11,605 | 8,835 |
| servicecontrol/ | H | 29-Sep-2021 | - | 1,423 | 1,020 |
| servicedirectory/ | H | 29-Sep-2021 | - | 4,810 | 3,616 |
| servicemanagement/ | H | 29-Sep-2021 | - | 2,722 | 1,949 |
| serviceusage/ | H | 29-Sep-2021 | - | 1,715 | 1,264 |
| shell/ | H | 29-Sep-2021 | - | 1,664 | 1,222 |
| spanner/ | H | 29-Sep-2021 | - | 57,460 | 44,782 |
| speech/ | H | 29-Sep-2021 | - | 3,846 | 2,798 |
| storage/ | H | 18-Jun-2020 | - | | |
| storagetransfer/ | H | 29-Sep-2021 | - | 1,613 | 1,228 |
| talent/ | H | 29-Sep-2021 | - | 11,058 | 7,995 |
| texttospeech/ | H | 29-Sep-2021 | - | 1,441 | 1,109 |
| third_party/ | H | 29-Sep-2021 | - | 4,413 | 2,894 |
| tpu/ | H | 29-Sep-2021 | - | 2,275 | 1,686 |
| trace/ | H | 29-Sep-2021 | - | 2,580 | 1,819 |
| translate/ | H | 29-Sep-2021 | - | 3,494 | 2,652 |
| video/ | H | 29-Sep-2021 | - | 2,566 | 1,884 |
| videointelligence/ | H | 29-Sep-2021 | - | 2,202 | 1,523 |
| vision/ | H | 29-Sep-2021 | - | 7,086 | 5,224 |
| vpcaccess/ | H | 29-Sep-2021 | - | 1,484 | 1,113 |
| webrisk/ | H | 29-Sep-2021 | - | 2,156 | 1,573 |
| websecurityscanner/ | H | 29-Sep-2021 | - | 2,108 | 1,666 |
| workflows/ | H | 29-Sep-2021 | - | 2,967 | 2,014 |
| .gitignore | H A D | 29-Sep-2021 | 92 | 13 | 10 |
| CHANGES.md | H A D | 29-Sep-2021 | 128.8 KiB | 2,273 | 1,744 |
| CODE_OF_CONDUCT.md | H A D | 29-Sep-2021 | 1.9 KiB | 45 | 35 |
| CONTRIBUTING.md | H A D | 29-Sep-2021 | 13.3 KiB | 328 | 257 |
| LICENSE | H A D | 29-Sep-2021 | 11.1 KiB | 203 | 169 |
| README.md | H A D | 29-Sep-2021 | 5.6 KiB | 133 | 108 |
| RELEASING.md | H A D | 29-Sep-2021 | 6.5 KiB | 142 | 121 |
| SECURITY.md | H A D | 29-Sep-2021 | 329 | 8 | 4 |
| doc.go | H A D | 29-Sep-2021 | 7.9 KiB | 202 | 1 |
| go.mod | H A D | 29-Sep-2021 | 532 | 19 | 16 |
| go.sum | H A D | 29-Sep-2021 | 53.8 KiB | 550 | 549 |
| header_test.go | H A D | 29-Sep-2021 | 2.5 KiB | 92 | 63 |
| testing.md | H A D | 29-Sep-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