…ts (#7167)

This PR establishes new unexported connection and connection pool abstractions.  The implementation is partial, and key areas where implementation is missing is generally marked with TODOs.

This PR does not alter existing functionality, but continues to lay groundwork for later refactors.

Towards: https://togithub.com/googleapis/google-cloud-go/issues/7103

Enables a few tests for gRPC now that their fixes are in production.

One test is now only blocked on some behavior documented in #6205.

The docs build is failing because of a missing `go.sum` entry.

- Allow read stats integration tests to use the emulator.
- Relax the checks for CellsSeenCount and RowsSeenCount.

The gRPC variant of this test always fails.

Updates: #7033

There was an API change so that checksums can now only be provided by the StartResumableUpload request rather than while uploading. Send the checksum at this stage instead.

Fixes #7033

In #7193 I moved the checksum logic to send on the request that
initiates the upload, but I inadvertently removed sending the
checksum for one-shot uploads. This PR restores the checksum
logic for simple uploads.

Fixes #7194

This PR augments the base client with fuller support for view-based
resolution of GetWriteStream metadata.  This PR also adds an integration
test that compares behaviors between different stream types (default vs
explicitly created).

Towards: #7103

* chore(all): auto-regenerate gapics

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: googleapis/go-genproto#957

Changes:

docs(notebooks): Minor formatting fixes to reference documentation
  PiperOrigin-RevId: 499362676
  Source-Link: googleapis/googleapis@870a5ed

chore(gsuiteaddons): Configure Ruby client library generation for gsuiteaddons
  PiperOrigin-RevId: 499356666
  Source-Link: googleapis/googleapis@c3845dd

feat(batch): support secret and encrypted environment variables in v1
  PiperOrigin-RevId: 499338464
  Source-Link: googleapis/googleapis@af050dc

feat(bigquery/datatransfer): Add location methods
  PiperOrigin-RevId: 499272288
  Source-Link: googleapis/googleapis@62c5867

feat(artifactregistry): Add location methods
  PiperOrigin-RevId: 499263614
  Source-Link: googleapis/googleapis@ba2db0d

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: googleapis/googleapis@9a294bf

* go mod tidy

Co-authored-by: Cody Oss <[email protected]>

Changes:

docs(notebooks): Minor formatting fixes to reference documentation
  PiperOrigin-RevId: 499362676
  Source-Link: googleapis/googleapis@870a5ed

chore(gsuiteaddons): Configure Ruby client library generation for gsuiteaddons
  PiperOrigin-RevId: 499356666
  Source-Link: googleapis/googleapis@c3845dd

feat(batch): support secret and encrypted environment variables in v1
  PiperOrigin-RevId: 499338464
  Source-Link: googleapis/googleapis@af050dc

feat(bigquery/datatransfer): Add location methods
  PiperOrigin-RevId: 499272288
  Source-Link: googleapis/googleapis@62c5867

feat(artifactregistry): Add location methods
  PiperOrigin-RevId: 499263614
  Source-Link: googleapis/googleapis@ba2db0d

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: googleapis/googleapis@9a294bf

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