v2.4.0

New Libraries

We are happy to announce the following GA libraries. Unless specifically noted,
the APIs in these libraries are stable, and are ready for production use.

• Certificate Manager API
• Cloud Deploy API
• Datastream API

In addition, these existing libraries are now GA:

• Cloud Batch

BigQuery

• doc: add endpoint override snippets to generated libs (#10129)
• feat(bigquery): add migration service (#10034)

Bigtable

• doc(bigtable): add *Client samples (#10149)
• feat(bigtable): support GOOGLE_CLOUD_ENABLE_DIRECT_PATH (#9978)

IAM

• doc: add endpoint override snippets to generated libs (#10129)

Pub/Sub

• doc(pubsub): samples for endpoint and auth (#10136)
• feat(pubsub): install pubsub_mocks pkg (#10008)
• feat(pubsub): implement blocking publisher (#10055)
• feat(pubsub): implement per-call options for Subscriber (#10043)
• fix(pubsub): limit ModifyAckDeadlineRequest size (#10032)
• fix(pubsub): faster shutdowns for Publisher (#9991)

Spanner

• doc(spanner): add *Client samples (#10145)
• feat(spanner): add support for RowStream::RowsModified() (#10102)
• feat(spanner): support for the PG.JSONB data type (#10098)

Storage

• doc(storage): common initialization examples (#10107)
• fix(rest): too many debug headers (#10054)
• fix(rest): return complete payloads for errors (#10051)
• feat(storage): support Autoclass feature (#10003)
• feat(storage): faster InsertObject() uploads (#9997)
• fix(storage): respect MIME message boundary size limits (#9965)

Common Libraries

• feat(generator): generate authentication example (#10138)
• doc: workaround Doxygen formatting quirk (#10137)
• doc: add endpoint override snippets to generated libs (#10129)
• feat(generator): generate simple samples for *Client (#10118)
• feat: add mock library w/ StreamRange (#9998)
• doc(common): make authentication docs easier to find (#10110)
• fix: configure context in async retries (#10100)
• doc: document when GrpcNumChannelsOption applies (#10000)
• feat(generator): make idempotency policy non-abstract (#9981)
• fix(common): preserve ErrorInfo on retry errors (#9971)

v2.3.0

New Libraries

We are happy to announce the following GA libraries. Unless specifically noted, the APIs in these libraries are stable, and are ready for production use.

• Distributed Cloud Edge Container API
• Network Connectivity API

BigQuery

The library has been expanded to include Analytics Hub, an API that facilitates data sharing within and across organizations. (#9882)

Spanner

• fix(spanner): remove session from pool upon "not found" refresh failure (#9954)
• feat(spanner): add support for Customer Managed Multi-Region (CMMR) read-only replicas at instance creation time (#9872)

Storage

• feat(storage): easier mocks for HmacKeyMetadata (#9949)
• feat(storage): easier mocks for *AccessControl (#9910)
• feat(storage): easier mocks with ObjectMetadata (#9899)
• fix(storage): decay type before testing supported-options membership (#9893)
• feat(storage): easier mocks with BucketMetadata (#9886)
• fix(storage): error message for resumable uploads (#9855)
• feat(storage): release *StallMinimumThroughputOption (#9813)
• fix(storage): no workaround needed with libc++ and MSVC (#9768)

Common Libraries

• fix(common): better defaults for curl initialization (#9798)

v1.42.1 Release

What's Changed

• Update Protobuf version in Bazel configuration to v21.6 (#9863)

Full Changelog: v1.42.0...v1.42.1

v2.2.1 Release

What's Changed

• Update Protobuf version in Bazel configuration to v21.6 (#9856)

Full Changelog: v2.2.0...v2.2.1

v2.2.0

New Libraries

We are introducing new client libraries for GCP services. While we do not
anticipate any API changes to these libraries before declaring them GA, we are
releasing them early in case they elicit some feedback that requires changes.

• API Keys

We are happy to announce the following GA libraries. Unless specifically noted,
the APIs in these libraries are stable, and are ready for production use.

Expand to see the full list of new GA libraries...

• Bare Metal Solution
• Beyond Corp
• Optimization AI
• Cloud Run
• Video Services

Bigtable

• fix(bigtable): DataConnection refreshes channels (#9718)
• fix(bigtable): Use retry policy on all streams with failing mutations (#9706)
• feat(bigtable): per-operation Options (#9627) (#9623)

Dataproc

• feat(dataproc): mark the dataproc services as location dependent (#9722)

Spanner

• feat(spanner): fine-grained access control (#9669)
• feat(spanner): equality for copyable classes (#9648)

Storage

• We have a new implementation for HTTP requests. This new implementation
  provides comparable download performance, and improves some uploads. See
  [#9659] for details. We have rigorously tested this new implementation. In the
  unlikely event that this new implementation breaks your application, we have
  included an environment variable to revert to the legacy implementation. Set
  GOOGLE_CLOUD_CPP_STORAGE_USE_LEGACY_HTTP to any value to use the legacy
  implementation. We are planning to remove the legacy code and the
  GOOGLE_CLOUD_CPP_STORAGE_USE_LEGACY_HTTP environment variable by 2022-12.
• feat(storage): improve error messages on stalled uploads (#9744)
• feat(storage): equality for Native IAM types (#9649)
• feat(storage): SA credentials default to self-signed JWTs (#9629)

Common Libraries

• feat: group GUAC Options in an OptionsList (#9643)
• fix(rest): cache credentials (#9620)
• doc: add table of contents to landing page (#9671)

v2.1.0

New Libraries

We are introducing new client libraries for GCP services. While we do not
anticipate any API changes to these libraries before declaring them GA, we are
releasing them early in case they elicit some feedback that requires changes.

• Batch (#9474)
• Beyond Corp (#9555)
• Cloud Run (#9460)

Assured Workloads

• fix(assuredworkloads): reenable on windows (#9467)

Bigtable

• fix(bigtable): the mocks library is no longer header-only (#9568)

Cloud Asset

• fix(asset): reenable on macOS (#9468)

Pub/Sub

• fix(pubsub): missing subscription name in lease extensions (#9523)
• feat(pubsub): exactly-once delivery (#9436)

Spanner

• fix(spanner): avoid evaluation-order issue in function arguments (#9452)

Stackdriver Debugger

• doc(debugger): announce deprecation (#9552)

Storage

• feat(storage): experimental options to tune stall timeouts (#9593)
• feat(storage): add debugging headers to ObjectWriteStream (#9580)
• fix(storage): no char for std::uniform_int_distribution (#9509)
• feat(storage): support Bucket custom placement config (#9481)

Common Libraries

• feat(common): make the RPC log even more readable (#9561)
• feat: improve error messages for access token errors (#9485)
• feat(common): make the RPC log even more readable (#9477)

v2.0.1

What's Changed

• fix(pubsub): missing subscription name in lease extensions (#9523) by @coryan in #9533

Full Changelog: v2.0.0...v2.0.1

v2.0.0

BREAKING CHANGES

As previously announced, google-cloud-cpp now requires C++ >= 14. This is
motivated by similar changes in our dependencies, and because C++ 14 has been
the default C++ version in all the compilers we support for several years.

We think this change is large enough that deserves a major version bump to
signal the new requirements.

If you are already using C++ >= 14 you need to make no changes. If you are
using C++11: please consider updating as soon as possible. To ease your
transition to C++ >= 14 we will, if requested, backport critical fixes to
v1.42.0 until 2023-07-01. After 2023-07-01 we will drop all support to v1.42.0
and earlier versions.

Debian 9 (Stretch) is EOL

Debian 9 (Stretch) reached EOL on 2022-06-30. Therefore, we have stopped testing
or supporting this distribution. This was the last distribution we supported
that required GCC < 7.3, and/or CMake < 3.10. Starting with this release we
require CMake >= 3.10, and only test with GCC >= 7.3.

OTHER CHANGES

Bigtable

We introduced a new constructor for Table which accepts a
DataConnection instead of a DataClient. The DataConnection is a new
interface that more closely matches the client surface of Table. Read more
about *Connection classes in our
Architecture Design document.

What are the benefits of DataConnection?

The new API greatly simplifies mocking. Every Table::Foo(..) call has an
associated DataConnection::Foo(...) call. This allows you to set expectations
on the exact values returned by the client call. See
Mocking the Cloud Bigtable C++ Client for a complete
example on how to mock the behavior of Table with
bigtable_mocks::MockDataConnection.

The new DataConnection API offers more consistency across our libraries. It
also enables the use of some common library features, such as our
UnifiedCredentialsOption. Also, any new features will be added to
the DataConnection API first.

Do I need to update my code?

No. If the benefits are not appealing enough, you do not need to update your
code. All code that currently uses DataClient will continue to function as
before. This includes uses of testing::MockDataClient.

However, if you are using testing::MockDataClient to mock the behavior of
Table in your tests:

1. Be aware that we have announced our intention to remove classes derived from
   DataClient on or around 2023-05. Your tests will break then.
2. Please consider using bigtable_mocks::MockDataConnection. It will greatly
   simplify your tests.

How do I update existing DataClient code?

See Migrating from DataClient to DataConnection.

• doc(bigtable): how to mock the Data API (#9415)
• feat(bigtable): modern Table constructor (#9403)
• feat(generator): support explicit routing headers (#9368)
• fix(bigtable)!: pass app profile id to connection as options (#9388)
• feat(bigtable): add AppProfileIdOption (#9382)
• feat(bigtable): table resource name as a class (#9377)
• feat(bigtable): instance name as a class (#9374)
• feat(bigtable): introduce MockDataConnection and MakeTestRowReader (#9335)
• feat(bigtable): introduce DataConnection (#9323)
• feat(bigtable): modern Data API policy options (#9320)

Pub/Sub

• doc(pubsub): improve documentation for *AckHandler (#9404)
• feat(pubsub): update subscription builders (#9326)

Common Libraries

• fix(generator): handle explicit routing params for nested fields (#9408)
• feat(common): truncation support for plain strings in the RPC log (#9351)

New Libraries

We are introducing a new client library. While we do not anticipate any API
changes to this library before declaring it GA, we are releasing it early in
case it elicits some feedback that requires changes.

• Video Services

v1.42.0

We are happy to announce the following GA libraries. Unless specifically noted,
the APIs in these libraries are stable, and are ready for production use.

Expand to see the full list of new GA libraries...

• Dataplex
• DialogFlow CX
• DialogFlow ES

Bigtable

• feat(bigtable): add AsyncWaitForConsistency() helper for Table Admin (#9310)
• doc: broken link in Bigtable README (#9265)

Pub/Sub

• feat(pubsub): implement per-batch compression (#9270)

Storage

• doc: broken link in GCS README file (#9264)
• fix(storage): respect policies in deprecated constructor (#9255)
• fix: handle transient failures in the GCE credentials (#9252)
• fix: relax parsing for GCE informational fields (#9251)
• feat(storage): per-operation options for Client (#9220) (#9214) (#9209) (#9208) (#9207) (#9206) (#9205) (#9204) (#9203) (#9202) (#9199) (#9247)
• fix(storage): do not duplicate debugging headers (#9162)
• fix(storage): disable MSVC C++17 deprecation warnings (#9143)
• doc(storage): missing options for several functions (#9146)

Common Libraries

• feat(common): include status error payloads in the RPC log (#9186) (#9169)
• fix(common): workaround GCC "ambiguous" overload errors (#9144)
• fix(common): compile with GCC (MinGW-w64) under Windows (#9140)

v1.41.0

Bigtable

• fix(bigtable): remove unnecessary sleeps from BulkApply (#9091)
• feat(bigtable): configure *Clients with EndpointOption (#9082)
• feat(bigtable): default construct a RowReader (#8958)
• doc(bigtable): compiler warnings for ClientOptions (#8914)
• doc(bigtable): deprecate RowReader public ctors (#8887)
• doc(bigtable): deprecate AsyncRowReader (#8870)

Document AI

• fix(documentai): make quickstart functional (#9108)

IAM

The library has been expanded to include IAM Policy, an API to grant, change,
and revoke access to all GCP resources that accept allow policies.

Cloud Monitoring

• feat(monitoring): generate async version of CreateTimeSeries() (#8983)

Pub/Sub

• doc(pubsub): fix typos Pub/Sub vs. Pubsub (#9034)
• doc(pubsub): implement IAM examples (#8917)
• doc(pubsub): deprecate SubscriberOptions (#8916)
• doc(pubsub): deprecate PublisherOptions (#8911)
• doc(pubsub): deprecate functions consuming ConnectionOptions (#8900)

Spanner

• doc(spanner): add a comment about building a "NaN" PgNumeric (#8891)
• feat(spanner): spanner::Value support for spanner::PgNumeric (#8872)
• feat(spanner): add support for spanner::PgNumeric (#8856)

Storage

• feat(storage): implement suffix and prefix OLM rules (#9030)
• feat(storage): helper functions for new lifecycle action (#9028)
• fix: format multiple scopes correctly in service account assertions (#8975)
• fix(storage): avoid crashes when parsing ErrorInfo (#8968)
• fix(storage): all HmacKey requests accept UserProject (#8928)
• fix(storage): handle full but not finalized uploads (#8896)
• fix(storage): resume "gunzipped" downloads (#8894)
• fix(storage): use Status for CurlHandle::SetOption() (#8871)
• fix(storage): set buffersize once per handle (#8865)

Common Libraries

BREAKING CHANGES

• We have changed the preference order for determining the service endpoint from
  (1) ${emulator_env}, (2) EndpointOption, (3) ${endpoint_env}, and (4)
  default value, to (1) ${emulator_env}, (2) ${endpoint_env}, (3)
  EndpointOption, and (4) default value. That is, the more dynamic
  ${endpoint_env} is now preferred over any EndpointOption set in the code.

Other Changes:

• doc: links to other libraries preserve version (#9112)
• docs: document connection and mock connection (#9084)
• feat(generator): SetIamPolicy() can be idempotent (#9078)
• fix(common): compilation error with coroutines and futures (#9046)
• fix: support absolute paths for CMAKE_INSTALL_*DIR (#9022)
• fix(generator): missing #include in generated code (#8979)
• fix(common): compile with storage and without gRPC (#8923)
• doc(common): deprecate ConnectionOptions member functions (#8907)
• doc: make the minimum Bazel and CMake versions easier to find (#8909)

New Libraries

We are introducing 2 new client libraries for GCP services. While we do not
anticipate any API changes to these libraries before declaring them GA, we are
releasing them early in case they elicit some feedback that requires changes.

• Bare Metal Solution
• Optimization AI