chore(all): auto-regenerate gapics (#3697)

This is an auto-generated regeneration of the gapic clients by
cloud.google.com/go/internal/gapicgen. Once the corresponding genproto PR is
submitted, genbot will update this PR with a newer dependency to the newer
version of genproto and assign reviewers to this PR.

If you have been assigned to review this PR, please:

- Ensure that the version of genproto in go.mod has been updated.
- Ensure that CI is passing. If it's failing, it requires your manual attention.
- Approve and submit this PR if you believe it's ready to ship.

Corresponding genproto PR: https://github.com/googleapis/go-genproto/pull/530

Changes:

docs(billing/budgets): Update rules for currency_code in budget_amount.
  PiperOrigin-RevId: 357051517
  Source-Link: https://github.com/googleapis/googleapis/commit/f3a60f63c13fb434745ea59b990a82d6ffc803b5

fix(kms): do not retry on 13 INTERNAL
  Fixes https://github.com/googleapis/nodejs-kms/issues/375. The malformed request triggers `13 INTERNAL` from gRPC and we should not silently retry on this code.
  Committer: @alexander-fenster

  PiperOrigin-RevId: 357022763
  Source-Link: https://github.com/googleapis/googleapis/commit/3f914b89ae1ef459955f470f9ccb498314ad28d5

docs(billing/budgets): Update rules for currency_code in budget_amount.
  PiperOrigin-RevId: 356991675
  Source-Link: https://github.com/googleapis/googleapis/commit/dd89b0cc1bffc39d1fb5c91c6c2bb3532f237792

feat(dialogflow/cx): supports SentimentAnalysisResult in webhook request docs: minor updates in wording
  PiperOrigin-RevId: 356624136
  Source-Link: https://github.com/googleapis/googleapis/commit/e28aa8570dc86136fe677202c976f4ee00d77f61

fix(vision): sync vision v1 protos to get extra FaceAnnotation Landmark Types
  PiperOrigin-RevId: 356556588
  Source-Link: https://github.com/googleapis/googleapis/commit/9b95bf0e95501ec98537e0d2d9d36bb763ebd5b9

docs(binaryauthorization): Replace "whitelist" with "allowlist" in generated documentation
  PiperOrigin-RevId: 356545742
  Source-Link: https://github.com/googleapis/googleapis/commit/a5c1c14c4562a5ef25715792983bb3a69f3d75da

fix(errorreporting): Remove dependency on AppEngine's proto definitions. This also removes the source_references field.
  PiperOrigin-RevId: 356540804
  Source-Link: https://github.com/googleapis/googleapis/commit/4f60776fe99f1fd8261b6a0493a5f5f4d7e8d969

feat(memcache): added ApplySoftwareUpdate API docs: various clarifications, new documentation for ApplySoftwareUpdate chore: update proto annotations
  PiperOrigin-RevId: 356380191
  Source-Link: https://github.com/googleapis/googleapis/commit/84cf54e45ed5970980ae868e0a1e5ad1266a8830

feat(errorreporting): Make resolution status field available for error groups. Now callers can set the status of an error group by passing this to UpdateGroup. When not specified, it's treated like OPEN. feat: Make source location available for error groups created from GAE.
  PiperOrigin-RevId: 356330876
  Source-Link: https://github.com/googleapis/googleapis/commit/c1e59709c1d28795fe9b70eb479579556056bfad
149 files changed
tree: 90803c284d4859ac6b38b7efdc7036d63f84fc4b
  1. .github/
  2. accessapproval/
  3. analytics/
  4. appengine/
  5. area120/
  6. artifactregistry/
  7. asset/
  8. assuredworkloads/
  9. automl/
  10. bigquery/
  11. bigtable/
  12. billing/
  13. binaryauthorization/
  14. channel/
  15. civil/
  16. cloudbuild/
  17. cloudtasks/
  18. cmd/
  19. compute/
  20. container/
  21. containeranalysis/
  22. datacatalog/
  23. datalabeling/
  24. dataproc/
  25. dataqna/
  26. datastore/
  27. debugger/
  28. dialogflow/
  29. dlp/
  30. documentai/
  31. domains/
  32. errorreporting/
  33. firestore/
  34. functions/
  35. gaming/
  36. grafeas/
  37. httpreplay/
  38. iam/
  39. internal/
  40. iot/
  41. kms/
  42. language/
  43. logging/
  44. longrunning/
  45. managedidentities/
  46. mediatranslation/
  47. memcache/
  48. monitoring/
  49. networkconnectivity/
  50. notebooks/
  51. orgpolicy/
  52. osconfig/
  53. oslogin/
  54. phishingprotection/
  55. policytroubleshooter/
  56. profiler/
  57. pubsub/
  58. pubsublite/
  59. recaptchaenterprise/
  60. recommendationengine/
  61. recommender/
  62. redis/
  63. resourcemanager/
  64. retail/
  65. rpcreplay/
  66. scheduler/
  67. secretmanager/
  68. security/
  69. securitycenter/
  70. servicecontrol/
  71. servicedirectory/
  72. servicemanagement/
  73. spanner/
  74. speech/
  75. storage/
  76. talent/
  77. texttospeech/
  78. third_party/
  79. trace/
  80. translate/
  81. video/
  82. videointelligence/
  83. vision/
  84. webrisk/
  85. websecurityscanner/
  86. workflows/
  87. .gitignore
  88. CHANGES.md
  89. CODE_OF_CONDUCT.md
  90. CONTRIBUTING.md
  91. doc.go
  92. examples_test.go
  93. go.mod
  94. go.sum
  95. header_test.go
  96. LICENSE
  97. README.md
  98. RELEASING.md
  99. testing.md
  100. tools.go
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

Google APIStatusPackage
Assetstablecloud.google.com/go/asset/apiv1
Automlstablecloud.google.com/go/automl/apiv1
BigQuerystablecloud.google.com/go/bigquery
Bigtablestablecloud.google.com/go/bigtable
Cloudbuildstablecloud.google.com/go/cloudbuild/apiv1
Cloudtasksstablecloud.google.com/go/cloudtasks/apiv2
Containerstablecloud.google.com/go/container/apiv1
ContainerAnalysisbetacloud.google.com/go/containeranalysis/apiv1
Dataprocstablecloud.google.com/go/dataproc/apiv1
Datastorestablecloud.google.com/go/datastore
Debuggerstablecloud.google.com/go/debugger/apiv2
Dialogflowstablecloud.google.com/go/dialogflow/apiv2
Data Loss Preventionstablecloud.google.com/go/dlp/apiv2
ErrorReportingalphacloud.google.com/go/errorreporting
Firestorestablecloud.google.com/go/firestore
IAMstablecloud.google.com/go/iam
IoTstablecloud.google.com/go/iot/apiv1
IRMalphacloud.google.com/go/irm/apiv1alpha2
KMSstablecloud.google.com/go/kms/apiv1
Natural Languagestablecloud.google.com/go/language/apiv1
Loggingstablecloud.google.com/go/logging
Memorystorealphacloud.google.com/go/redis/apiv1
Monitoringstablecloud.google.com/go/monitoring/apiv3
OS Loginstablecloud.google.com/go/oslogin/apiv1
Pub/Substablecloud.google.com/go/pubsub
Phishing Protectionalphacloud.google.com/go/phishingprotection/apiv1beta1
reCAPTCHA Enterprisealphacloud.google.com/go/recaptchaenterprise/apiv1beta1
Recommenderbetacloud.google.com/go/recommender/apiv1beta1
Schedulerstablecloud.google.com/go/scheduler/apiv1
Securitycenterstablecloud.google.com/go/securitycenter/apiv1
Spannerstablecloud.google.com/go/spanner
Speechstablecloud.google.com/go/speech/apiv1
Storagestablecloud.google.com/go/storage
Talentalphacloud.google.com/go/talent/apiv4beta1
Text To Speechstablecloud.google.com/go/texttospeech/apiv1
Tracestablecloud.google.com/go/trace/apiv2
Translatestablecloud.google.com/go/translate
Video Intelligencebetacloud.google.com/go/videointelligence/apiv1beta2
Visionstablecloud.google.com/go/vision/apiv1
Webriskalphacloud.google.com/go/webrisk/apiv1beta1

Alpha status: the API is still being actively developed. As a result, it might change in backward-incompatible ways and is not recommended for production use.

Beta status: the API is largely complete, but still has outstanding features and bugs to be addressed. There may be minor backwards-incompatible changes where necessary.

Stable status: the API is mature and ready for production use. We will continue addressing bugs and feature requests.

Documentation and examples are available at pkg.go.dev/cloud.google.com/go

Go Versions Supported

We currently support Go versions 1.11 and newer.

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