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

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/654

Changes:

fix(pubsub): replace IAMPolicy in API config
  PiperOrigin-RevId: 389961627
  Source-Link: https://github.com/googleapis/googleapis/commit/e41be609f1e2ae7618bf323748871c591f44742a

feat(dialogflow/cx): added support for DLP templates; expose `Locations` service to get/list avaliable locations of Dialogflow products
  PiperOrigin-RevId: 389939863
  Source-Link: https://github.com/googleapis/googleapis/commit/626df528c5ae8839254f28b1f8daa1bac75be3a4

feat(dialogflow/cx): added support for DLP templates; expose `Locations` service to get/list avaliable locations of Dialogflow products docs: reorder some fields
  PiperOrigin-RevId: 389907245
  Source-Link: https://github.com/googleapis/googleapis/commit/114b1416f8f2725e1272b0bf2be74676cff0ed2c

feat(dialogflow): expose `Locations` service to get/list avaliable locations of Dialogflow products; fixed some API annotations
  PiperOrigin-RevId: 389905442
  Source-Link: https://github.com/googleapis/googleapis/commit/4c984f3be8e1bd85eb8fe78a2911a83b9785a7ea

feat(pubsub): Add topic retention options
  PiperOrigin-RevId: 389879008
  Source-Link: https://github.com/googleapis/googleapis/commit/7b6a2ceed6cacf676b3918b1703b3ddd6322444c

feat(speech): add total_billed_time response field
  Committer: @cherba
  PiperOrigin-RevId: 389755489
  Source-Link: https://github.com/googleapis/googleapis/commit/10185d07a4db1d76a888a119aeab1f2287b35105

build(dataproc): update from broken v1beta2 links to v1
  PiperOrigin-RevId: 389649385
  Source-Link: https://github.com/googleapis/googleapis/commit/2c1c2ac112b63ae304226b90dfbb9462a6418864

feat(video/transcoder): Add video cropping feature feat: Add video padding feature feat: Add ttl_after_completion_days field to Job docs: Update proto documentation docs: Indicate v1beta1 deprecation
  PiperOrigin-RevId: 389250478
  Source-Link: https://github.com/googleapis/googleapis/commit/9a7d19079b5e3c22a5a08eaa94273f5d1eebb317

build(networkmanagement): correct artifact name for npm
  PiperOrigin-RevId: 389230095
  Source-Link: https://github.com/googleapis/googleapis/commit/f642cc61dfae622ba8fe5f7addcdaeece2f6e5a3

feat(kms): add support for HMAC, Variable Key Destruction, and GenerateRandom
  PiperOrigin-RevId: 389008671
  Source-Link: https://github.com/googleapis/googleapis/commit/2efb6951f151116fb7b5766fb4e377db465d49e9
26 files changed
tree: d1408c6561f2822335766670615a3009824c1e23
  1. .github/
  2. accessapproval/
  3. aiplatform/
  4. analytics/
  5. apigateway/
  6. apigeeconnect/
  7. appengine/
  8. area120/
  9. artifactregistry/
  10. asset/
  11. assuredworkloads/
  12. automl/
  13. bigquery/
  14. bigtable/
  15. billing/
  16. binaryauthorization/
  17. channel/
  18. civil/
  19. cloudbuild/
  20. clouddms/
  21. cloudtasks/
  22. cmd/
  23. compute/
  24. container/
  25. containeranalysis/
  26. datacatalog/
  27. dataflow/
  28. datafusion/
  29. datalabeling/
  30. dataproc/
  31. dataqna/
  32. datastore/
  33. datastream/
  34. debugger/
  35. dialogflow/
  36. dlp/
  37. documentai/
  38. domains/
  39. errorreporting/
  40. essentialcontacts/
  41. eventarc/
  42. firestore/
  43. functions/
  44. gaming/
  45. gkeconnect/
  46. gkehub/
  47. grafeas/
  48. gsuiteaddons/
  49. httpreplay/
  50. iam/
  51. iap/
  52. internal/
  53. iot/
  54. kms/
  55. language/
  56. lifesciences/
  57. logging/
  58. longrunning/
  59. managedidentities/
  60. mediatranslation/
  61. memcache/
  62. metastore/
  63. monitoring/
  64. networkconnectivity/
  65. networkmanagement/
  66. notebooks/
  67. orgpolicy/
  68. osconfig/
  69. oslogin/
  70. phishingprotection/
  71. policytroubleshooter/
  72. privatecatalog/
  73. profiler/
  74. pubsub/
  75. pubsublite/
  76. recaptchaenterprise/
  77. recommendationengine/
  78. recommender/
  79. redis/
  80. resourcemanager/
  81. resourcesettings/
  82. retail/
  83. rpcreplay/
  84. scheduler/
  85. secretmanager/
  86. security/
  87. securitycenter/
  88. servicecontrol/
  89. servicedirectory/
  90. servicemanagement/
  91. serviceusage/
  92. shell/
  93. spanner/
  94. speech/
  95. storage/
  96. storagetransfer/
  97. talent/
  98. texttospeech/
  99. third_party/
  100. tpu/
  101. trace/
  102. translate/
  103. video/
  104. videointelligence/
  105. vision/
  106. vpcaccess/
  107. webrisk/
  108. websecurityscanner/
  109. workflows/
  110. .gitignore
  111. CHANGES.md
  112. CODE_OF_CONDUCT.md
  113. CONTRIBUTING.md
  114. doc.go
  115. examples_test.go
  116. go.mod
  117. go.sum
  118. header_test.go
  119. LICENSE
  120. README.md
  121. RELEASING.md
  122. SECURITY.md
  123. testing.md
  124. 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
Compute Enginealphacloud.google.com/go/compute/apiv1
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
Pub/Sub Litestablecloud.google.com/go/pubsublite
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