Google Git
Sign in
code / gocloud / 06a54a16a5866cce966547c51e203b9e09a25bc0
commit06a54a16a5866cce966547c51e203b9e09a25bc0[log] [tgz]
authorCody Oss <6331106+codyoss@users.noreply.github.com>Wed Jan 04 21:11:54 2023 +0000
committerGitHub <noreply@github.com>Wed Jan 04 15:11:54 2023 -0600
tree16410dcfbed8ec4c10b33bc70572851478c2098e
parentfd71cba7b6d5a015dcdb24b9eacc7fae1aa54c89 [diff]
chore: fixup commit messages (#7210)

Changes:

docs(notebooks): Minor formatting fixes to reference documentation
  PiperOrigin-RevId: 499362676
  Source-Link: https://github.com/googleapis/googleapis/commit/870a5ed7e141b4faf70e2a0858854e9b5bb18612

chore(gsuiteaddons): Configure Ruby client library generation for gsuiteaddons
  PiperOrigin-RevId: 499356666
  Source-Link: https://github.com/googleapis/googleapis/commit/c3845dd3b8e9361486943f119813bf6279a0ffd5

feat(batch): support secret and encrypted environment variables in v1
  PiperOrigin-RevId: 499338464
  Source-Link: https://github.com/googleapis/googleapis/commit/af050dcf9b72d192ef20b79149a6655a9afee870

feat(bigquery/datatransfer): Add location methods
  PiperOrigin-RevId: 499272288
  Source-Link: https://github.com/googleapis/googleapis/commit/62c5867e6adcd7910203ae6adc10f2b1533c29e6

feat(artifactregistry): Add location methods
  PiperOrigin-RevId: 499263614
  Source-Link: https://github.com/googleapis/googleapis/commit/ba2db0d89a145c14ef11c0ec2eda0c80fe16f17e

feat(container): add etags for cluster and node pool update operations
  Clients may now optionally specify the previously read etag for a cluster or node pool during update requests. The etag is regenerated every time the object is updated. If an etag is provided, it will be checked against the current etag, and the request will be rejected on mismatch. This is particularly useful for allowing two clients to concurrently update a repeated field without overwriting each other.

  PiperOrigin-RevId: 498249600
  Source-Link: https://github.com/googleapis/googleapis/commit/9a294bf14b3343b3f144aa6e80fa858332d21274

feat(accessapproval): add REST client

feat(accesscontextmanager): add REST client

feat(aiplatform): add REST client

feat(analytics): add REST client

feat(apigateway): add REST client

feat(apigeeconnect): add REST client

feat(apigeeregistry): add REST client

feat(apikeys): add REST client

feat(appengine): add REST client

feat(area120): add REST client

feat(artifactregistry): add REST client

feat(asset): add REST client

feat(assuredworkloads): add REST client

feat(automl): add REST client

feat(baremetalsolution): add REST client

feat(batch): add REST client

feat(beyondcorp): add REST client

feat(bigquery): add REST client

feat(billing): add REST client

feat(binaryauthorization): add REST client

feat(certificatemanager): add REST client

feat(channel): add REST client

feat(cloudbuild): add REST client

feat(clouddms): add REST client

feat(cloudtasks): add REST client

feat(compute): add REST client

feat(contactcenterinsights): add REST client

feat(container): add REST client

feat(containeranalysis): add REST client

feat(datacatalog): add REST client

feat(dataflow): add REST client

feat(dataform): add REST client

feat(datafusion): add REST client

feat(datalabeling): add REST client

feat(dataplex): add REST client

feat(dataproc): add REST client

feat(dataqna): add REST client

feat(datastore): add REST client

feat(datastream): add REST client

feat(debugger): add REST client

feat(deploy): add REST client

feat(dialogflow): add REST client

feat(dlp): add REST client

feat(documentai): add REST client

feat(domains): add REST client

feat(edgecontainer): add REST client

feat(errorreporting): add REST client

feat(essentialcontacts): add REST client

feat(eventarc): add REST client

feat(filestore): add REST client

feat(firestore): add REST client

feat(functions): add REST client

feat(gaming): add REST client

feat(gkebackup): add REST client

feat(gkeconnect): add REST client

feat(gkehub): add REST client

feat(gkemulticloud): add REST client

feat(gsuiteaddons): add REST client

feat(iam): add REST client

feat(iap): add REST client

feat(ids): add REST client

feat(iot): add REST client

feat(kms): add REST client

feat(language): add REST client

feat(lifesciences): add REST client

feat(logging): add REST client

feat(longrunning): add REST client

feat(managedidentities): add REST client

feat(maps): add REST client

feat(mediatranslation): add REST client

feat(memcache): add REST client

feat(metastore): add REST client

feat(monitoring): add REST client

feat(networkconnectivity): add REST client

feat(networkmanagement): add REST client

feat(networksecurity): add REST client

feat(notebooks): add REST client

feat(optimization): add REST client

feat(orchestration): add REST client

feat(orgpolicy): add REST client

feat(osconfig): add REST client

feat(oslogin): add REST client

feat(phishingprotection): add REST client

feat(policytroubleshooter): add REST client

feat(privatecatalog): add REST client

feat(pubsub): add REST client

feat(pubsublite): add REST client

feat(recaptchaenterprise/v2): add REST client

feat(recommendationengine): add REST client

feat(recommender): add REST client

feat(redis): add REST client

feat(resourcemanager): add REST client

feat(resourcesettings): add REST client

feat(retail): add REST client

feat(run): add REST client

feat(scheduler): add REST client

feat(secretmanager): add REST client

feat(security): add REST client

feat(securitycenter): add REST client

feat(servicecontrol): add REST client

feat(servicedirectory): add REST client

feat(servicemanagement): add REST client

feat(serviceusage): add REST client

feat(shell): add REST client

feat(spanner): add REST client

feat(speech): add REST client

feat(storage): add REST client

feat(storagetransfer): add REST client

feat(talent): add REST client

feat(texttospeech): add REST client

feat(tpu): add REST client

feat(trace): add REST client

feat(translate): add REST client

feat(video): add REST client

feat(videointelligence): add REST client

feat(vision/v2): add REST client

feat(vmmigration): add REST client

feat(vmwareengine): add REST client

feat(vpcaccess): add REST client

feat(webrisk): add REST client

feat(websecurityscanner): add REST client

feat(workflows): add REST client
tree: 16410dcfbed8ec4c10b33bc70572851478c2098e
  1. .github/
  2. accessapproval/
  3. accesscontextmanager/
  4. aiplatform/
  5. analytics/
  6. apigateway/
  7. apigeeconnect/
  8. apigeeregistry/
  9. apikeys/
  10. appengine/
  11. area120/
  12. artifactregistry/
  13. asset/
  14. assuredworkloads/
  15. automl/
  16. baremetalsolution/
  17. batch/
  18. beyondcorp/
  19. bigquery/
  20. bigtable/
  21. billing/
  22. binaryauthorization/
  23. certificatemanager/
  24. channel/
  25. civil/
  26. cloudbuild/
  27. clouddms/
  28. cloudtasks/
  29. cmd/
  30. compute/
  31. contactcenterinsights/
  32. container/
  33. containeranalysis/
  34. datacatalog/
  35. dataflow/
  36. dataform/
  37. datafusion/
  38. datalabeling/
  39. dataplex/
  40. dataproc/
  41. dataqna/
  42. datastore/
  43. datastream/
  44. debugger/
  45. deploy/
  46. dialogflow/
  47. dlp/
  48. documentai/
  49. domains/
  50. edgecontainer/
  51. errorreporting/
  52. essentialcontacts/
  53. eventarc/
  54. filestore/
  55. firestore/
  56. functions/
  57. gaming/
  58. gkebackup/
  59. gkeconnect/
  60. gkehub/
  61. gkemulticloud/
  62. grafeas/
  63. gsuiteaddons/
  64. httpreplay/
  65. iam/
  66. iap/
  67. ids/
  68. internal/
  69. iot/
  70. kms/
  71. language/
  72. lifesciences/
  73. logging/
  74. longrunning/
  75. managedidentities/
  76. maps/
  77. mediatranslation/
  78. memcache/
  79. metastore/
  80. monitoring/
  81. networkconnectivity/
  82. networkmanagement/
  83. networksecurity/
  84. notebooks/
  85. optimization/
  86. orchestration/
  87. orgpolicy/
  88. osconfig/
  89. oslogin/
  90. phishingprotection/
  91. policytroubleshooter/
  92. privatecatalog/
  93. profiler/
  94. pubsub/
  95. pubsublite/
  96. recaptchaenterprise/
  97. recommendationengine/
  98. recommender/
  99. redis/
  100. resourcemanager/
  101. resourcesettings/
  102. retail/
  103. rpcreplay/
  104. run/
  105. scheduler/
  106. secretmanager/
  107. security/
  108. securitycenter/
  109. servicecontrol/
  110. servicedirectory/
  111. servicemanagement/
  112. serviceusage/
  113. shell/
  114. spanner/
  115. speech/
  116. storage/
  117. storagetransfer/
  118. talent/
  119. texttospeech/
  120. third_party/
  121. tpu/
  122. trace/
  123. translate/
  124. video/
  125. videointelligence/
  126. vision/
  127. vmmigration/
  128. vmwareengine/
  129. vpcaccess/
  130. webrisk/
  131. websecurityscanner/
  132. workflows/
  133. .gitignore
  134. .release-please-manifest-individual.json
  135. .release-please-manifest-submodules.json
  136. .release-please-manifest.json
  137. CHANGES.md
  138. CODE_OF_CONDUCT.md
  139. CONTRIBUTING.md
  140. doc.go
  141. go.mod
  142. go.sum
  143. LICENSE
  144. migration.md
  145. README.md
  146. release-please-config-individual.json
  147. release-please-config-yoshi-submodules.json
  148. release-please-config.json
  149. RELEASING.md
  150. SECURITY.md
  151. testing.md
README.md

Google Cloud Client Libraries for Go

Go Reference

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.

Supported APIs

For an updated list of all of our released APIs please see our reference docs.

Go Versions Supported

Our libraries are compatible with at least the three most recent, major Go releases. They are currently compatible with:

  • Go 1.19
  • Go 1.18
  • Go 1.17
  • Go 1.16
  • Go 1.15

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.

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.

Links