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


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

Changes:

chore(gkehub): Update gkehub_v1beta1 BUILD.bazel for python
  PiperOrigin-RevId: 363411666
  Source-Link: https://github.com/googleapis/googleapis/commit/b4d9498d1f6feaff727d3d8421938a687e3ae503

fix(cloudbuild/apiv1): Specify `build` as the body of a `CreateBuild` call. The Cloud Build API has always assumed this, but now we are actually specifying it.
  feat: Add `ReceiveTriggerWebhook` for webhooks activating specific triggers.
  
  docs: Update field docs on required-ness behavior and fix typos.
  
  docs: Add `$PROJECT_NUMBER` as a substitution variable.
  
  feat: Add `SecretManager`-related resources and messages for corresponding integration.
  
  docs: Clarify lifetime/expiration behavior around `ListBuilds` page tokens.
  
  feat: Add `COMMENTS_ENABLED_FOR_EXTERNAL_CONTRIBUTORS_ONLY` for corresponding comment control behavior with triggered builds.
  
  feat: Add `E2_HIGHCPU_8` and `E2_HIGHCPU_32` machine types.
  
  Committer: @lozord
  PiperOrigin-RevId: 363244566
  Source-Link: https://github.com/googleapis/googleapis/commit/913f5553d5ff5940cddd8245313136449b2a3571

chore(metastore): Update metastore_v1beta BUILD.bazel for python
  PiperOrigin-RevId: 363228697
  Source-Link: https://github.com/googleapis/googleapis/commit/c77177963e3ccfa9835afba1ce05defc799c66e9

chore(artifactregistry): Update artifactregistry_v1beta2 BUILD.bazel for python
  PiperOrigin-RevId: 363175301
  Source-Link: https://github.com/googleapis/googleapis/commit/53a8072a03a8720a581041f5352e65f7cfff64cc

chore(gkehub): Use correct markdown for code block
  PiperOrigin-RevId: 363012458
  Source-Link: https://github.com/googleapis/googleapis/commit/e1654206ff59f3a2a226828f9c9f354c253b36e4

chore(appengine): remove obsolete configuration file
  Committer: @alexander-fenster
  PiperOrigin-RevId: 362980545
  Source-Link: https://github.com/googleapis/googleapis/commit/a4ee234c9499483cc966669669e7900b3b781192

feat(monitoring/dashboard):added mosaic layout docs:clarified alignment_period max value and updated IAM docs link
  PiperOrigin-RevId: 362979558
  Source-Link: https://github.com/googleapis/googleapis/commit/0dafa3963ef6fcb8a7f5daaa4bec12adb04de518

fix!(dialogflow): remove resource_reference for invisible resources.
  Committer: @sheimi
  PiperOrigin-RevId: 362967283
  Source-Link: https://github.com/googleapis/googleapis/commit/a1ba4568e228b25124f9a6689cfe3bcab75498a6

chore(managedidentities): Remove titles in docstring.
  PiperOrigin-RevId: 362943541
  Source-Link: https://github.com/googleapis/googleapis/commit/cb631dd3ffe0d6f77f7b01c5168e357771c74b51

162 files changed
tree: 5884cea91b861c552e67684e6ca74a70c700f08a
  1. .github/
  2. accessapproval/
  3. analytics/
  4. apigateway/
  5. appengine/
  6. area120/
  7. artifactregistry/
  8. asset/
  9. assuredworkloads/
  10. automl/
  11. bigquery/
  12. bigtable/
  13. billing/
  14. binaryauthorization/
  15. channel/
  16. civil/
  17. cloudbuild/
  18. cloudtasks/
  19. cmd/
  20. compute/
  21. container/
  22. containeranalysis/
  23. datacatalog/
  24. datalabeling/
  25. dataproc/
  26. dataqna/
  27. datastore/
  28. debugger/
  29. dialogflow/
  30. dlp/
  31. documentai/
  32. domains/
  33. errorreporting/
  34. firestore/
  35. functions/
  36. gaming/
  37. gkehub/
  38. grafeas/
  39. httpreplay/
  40. iam/
  41. internal/
  42. iot/
  43. kms/
  44. language/
  45. logging/
  46. longrunning/
  47. managedidentities/
  48. mediatranslation/
  49. memcache/
  50. metastore/
  51. monitoring/
  52. networkconnectivity/
  53. notebooks/
  54. orgpolicy/
  55. osconfig/
  56. oslogin/
  57. phishingprotection/
  58. policytroubleshooter/
  59. profiler/
  60. pubsub/
  61. pubsublite/
  62. recaptchaenterprise/
  63. recommendationengine/
  64. recommender/
  65. redis/
  66. resourcemanager/
  67. retail/
  68. rpcreplay/
  69. scheduler/
  70. secretmanager/
  71. security/
  72. securitycenter/
  73. servicecontrol/
  74. servicedirectory/
  75. servicemanagement/
  76. spanner/
  77. speech/
  78. storage/
  79. talent/
  80. texttospeech/
  81. third_party/
  82. trace/
  83. translate/
  84. video/
  85. videointelligence/
  86. vision/
  87. webrisk/
  88. websecurityscanner/
  89. workflows/
  90. .gitignore
  91. CHANGES.md
  92. CODE_OF_CONDUCT.md
  93. CONTRIBUTING.md
  94. doc.go
  95. examples_test.go
  96. go.mod
  97. go.sum
  98. header_test.go
  99. LICENSE
  100. README.md
  101. RELEASING.md
  102. testing.md
  103. 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
Pub/Sub Litebetacloud.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