Google Git
Sign in
code / gocloud / 2cdc40a0b4288f5ab5f2b2b8f5c1d6453a9c81ec
commit2cdc40a0b4288f5ab5f2b2b8f5c1d6453a9c81ec[log] [tgz]
authorgcf-owl-bot[bot] <78513119+gcf-owl-bot[bot]@users.noreply.github.com>Tue Apr 02 23:32:16 2024 +0000
committerGitHub <noreply@github.com>Tue Apr 02 23:32:16 2024 +0000
treec0fd93b00e4176a2b0efaa6c0f86dd305f9db56a
parentfaa61a6ea882e3f307b4e531138a49887ef8fcd5 [diff]
docs(firestore/apiv1): Allow 14 week backup retention for Firestore daily backups (#9685)

- [ ] Regenerate this pull request now.

PiperOrigin-RevId: 621269025

Source-Link: https://togithub.com/googleapis/googleapis/commit/d0ed6724c4f2868bf4c6d8e0fe9223221f0f0e50

Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/73c87bc51e565666bf4e399b194b3d71e1340ee7
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNzNjODdiYzUxZTU2NTY2NmJmNGUzOTliMTk0YjNkNzFlMTM0MGVlNyJ9
BEGIN_NESTED_COMMIT
feat(spanner/executor): Add SessionPoolOptions, SpannerOptions protos in executor protos
PiperOrigin-RevId: 621265883

Source-Link: https://togithub.com/googleapis/googleapis/commit/fed9845c564d6acf8d03beee69b36666c8bd7fa4

Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/c66a76957e2e16347bc1dd3f4c638223f065ee80
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYzY2YTc2OTU3ZTJlMTYzNDdiYzFkZDNmNGM2MzgyMjNmMDY1ZWU4MCJ9
END_NESTED_COMMIT
BEGIN_NESTED_COMMIT
feat(cloudquotas): Add `rollout_info` field to `QuotaDetails` message
PiperOrigin-RevId: 621249697

Source-Link: https://togithub.com/googleapis/googleapis/commit/a74854dfc497c175b997b7fe1b264a898f594da6

Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/c9c7eb0653b6593d1e1d24551f31237513fe0a48
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYzljN2ViMDY1M2I2NTkzZDFlMWQyNDU1MWYzMTIzNzUxM2ZlMGE0OCJ9
END_NESTED_COMMIT
BEGIN_NESTED_COMMIT
feat(documentai): Support a new Layout Processor in Document AI
docs: keep the API doc up-to-date with recent changes

PiperOrigin-RevId: 621233157

Source-Link: https://togithub.com/googleapis/googleapis/commit/d5020fff4cbe108bdf506074791c56cff7840bef

Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/3beacfd02f8cf650bbae6ef8c37131c98723fa17
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiM2JlYWNmZDAyZjhjZjY1MGJiYWU2ZWY4YzM3MTMxYzk4NzIzZmExNyJ9
END_NESTED_COMMIT
BEGIN_NESTED_COMMIT
feat(security/privateca): Add encoding format to `.google.cloud.security.privateca.v1.CaPool` Resource
docs: A comment for field `maximum_lifetime` in message `.google.cloud.security.privateca.v1.CaPool` is changed
docs: A comment for field `maximum_lifetime` in message `.google.cloud.security.privateca.v1.CertificateTemplate` is changed
docs: A comment for field `subject_key_id` in message `.google.cloud.security.privateca.v1.CertificateConfig` is changed
docs: A comment for method `FetchCaCerts` in service `CertificateAuthorityService` is changed
docs: A comment for field `ignore_dependent_resources` in message `.google.cloud.security.privateca.v1.DisableCertificateAuthorityRequest` is changed
docs: A comment for field `ignore_dependent_resources` in message `.google.cloud.security.privateca.v1.DeleteCertificateAuthorityRequest` is changed
docs: A comment for field `ignore_dependent_resources` in message `.google.cloud.security.privateca.v1.DeleteCaPoolRequest` is changed
docs: A comment for field `ca_certs` in message `.google.cloud.security.privateca.v1.FetchCaCertsResponse` is changed

PiperOrigin-RevId: 620969058

Source-Link: https://togithub.com/googleapis/googleapis/commit/8d326d5a7e7146e41ecce7f921e51c97504f7487

Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/24634b50df6fde9fd2485a0ec2705a99722707f3
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMjQ2MzRiNTBkZjZmZGU5ZmQyNDg1YTBlYzI3MDVhOTk3MjI3MDdmMyJ9
END_NESTED_COMMIT
13 files changed
tree: c0fd93b00e4176a2b0efaa6c0f86dd305f9db56a
  1. .devcontainer/
  2. .github/
  3. accessapproval/
  4. accesscontextmanager/
  5. advisorynotifications/
  6. ai/
  7. aiplatform/
  8. alloydb/
  9. analytics/
  10. apigateway/
  11. apigeeconnect/
  12. apigeeregistry/
  13. apikeys/
  14. appengine/
  15. apphub/
  16. apps/
  17. area120/
  18. artifactregistry/
  19. asset/
  20. assuredworkloads/
  21. auth/
  22. automl/
  23. baremetalsolution/
  24. batch/
  25. beyondcorp/
  26. bigquery/
  27. bigtable/
  28. billing/
  29. binaryauthorization/
  30. certificatemanager/
  31. channel/
  32. civil/
  33. cloudbuild/
  34. cloudcontrolspartner/
  35. clouddms/
  36. cloudprofiler/
  37. cloudquotas/
  38. cloudtasks/
  39. commerce/
  40. compute/
  41. confidentialcomputing/
  42. config/
  43. contactcenterinsights/
  44. container/
  45. containeranalysis/
  46. datacatalog/
  47. dataflow/
  48. dataform/
  49. datafusion/
  50. datalabeling/
  51. dataplex/
  52. dataproc/
  53. dataqna/
  54. datastore/
  55. datastream/
  56. debugger/
  57. deploy/
  58. dialogflow/
  59. discoveryengine/
  60. dlp/
  61. documentai/
  62. domains/
  63. edgecontainer/
  64. edgenetwork/
  65. errorreporting/
  66. essentialcontacts/
  67. eventarc/
  68. filestore/
  69. firestore/
  70. functions/
  71. gkebackup/
  72. gkeconnect/
  73. gkehub/
  74. gkemulticloud/
  75. grafeas/
  76. gsuiteaddons/
  77. httpreplay/
  78. iam/
  79. iap/
  80. ids/
  81. internal/
  82. iot/
  83. kms/
  84. language/
  85. lifesciences/
  86. logging/
  87. longrunning/
  88. managedidentities/
  89. maps/
  90. mediatranslation/
  91. memcache/
  92. metastore/
  93. migrationcenter/
  94. monitoring/
  95. netapp/
  96. networkconnectivity/
  97. networkmanagement/
  98. networksecurity/
  99. notebooks/
  100. optimization/
  101. orchestration/
  102. orgpolicy/
  103. osconfig/
  104. oslogin/
  105. parallelstore/
  106. phishingprotection/
  107. policysimulator/
  108. policytroubleshooter/
  109. privatecatalog/
  110. profiler/
  111. pubsub/
  112. pubsublite/
  113. rapidmigrationassessment/
  114. recaptchaenterprise/
  115. recommendationengine/
  116. recommender/
  117. redis/
  118. resourcemanager/
  119. resourcesettings/
  120. retail/
  121. rpcreplay/
  122. run/
  123. scheduler/
  124. secretmanager/
  125. securesourcemanager/
  126. security/
  127. securitycenter/
  128. securitycentermanagement/
  129. securityposture/
  130. servicecontrol/
  131. servicedirectory/
  132. servicehealth/
  133. servicemanagement/
  134. serviceusage/
  135. shell/
  136. shopping/
  137. spanner/
  138. speech/
  139. storage/
  140. storageinsights/
  141. storagetransfer/
  142. support/
  143. talent/
  144. telcoautomation/
  145. texttospeech/
  146. third_party/
  147. tpu/
  148. trace/
  149. translate/
  150. vertexai/
  151. video/
  152. videointelligence/
  153. vision/
  154. visionai/
  155. vmmigration/
  156. vmwareengine/
  157. vpcaccess/
  158. webrisk/
  159. websecurityscanner/
  160. workflows/
  161. workstations/
  162. .gitignore
  163. .release-please-manifest-individual.json
  164. .release-please-manifest-submodules.json
  165. .release-please-manifest.json
  166. CHANGES.md
  167. CODE_OF_CONDUCT.md
  168. CONTRIBUTING.md
  169. debug.md
  170. doc.go
  171. go.mod
  172. go.sum
  173. go.work
  174. go.work.sum
  175. LICENSE
  176. migration.md
  177. README.md
  178. release-please-config-individual.json
  179. release-please-config-yoshi-submodules.json
  180. release-please-config.json
  181. RELEASING.md
  182. SECURITY.md
  183. 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.21
  • Go 1.20
  • Go 1.19

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:

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