Tags from java-firestore

1.3-Instant

2021-02-20T08:11:27Z

v2.2.3-Instant

2021-02-20T12:02:40Z

v2.2.3: chore(master): release 2.2.3 (#544)

2021-02-19T22:32:06Z

chore(master): release 2.2.3 (googleapis#544)

🤖 I have created a release \*beep\* \*boop\*
---
### [2.2.3](https://www.github.com/googleapis/java-firestore/compare/v2.2.2...v2.2.3) (2021-02-19)

### Dependencies

* update dependency com.google.cloud:google-cloud-shared-dependencies to v0.19.0 ([googleapis#543](https://www.github.com/googleapis/java-firestore/issues/543)) ([7eed88c](https://www.github.com/googleapis/java-firestore/commit/7eed88c70cfe197a93b88b47db6e4edd89836063))
---

This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please).

v2.2.2: chore(master): release 2.2.2 (#540)

2021-02-19T16:40:02Z

chore(master): release 2.2.2 (googleapis#540)

🤖 I have created a release \*beep\* \*boop\*
---
### [2.2.2](https://www.github.com/googleapis/java-firestore/compare/v2.2.1...v2.2.2) (2021-02-19)

### Bug Fixes

* block close() on the termination of all RPC channels ([googleapis#512](https://www.github.com/googleapis/java-firestore/issues/512)) ([67bd06a](https://www.github.com/googleapis/java-firestore/commit/67bd06aac7a53a210e1a5c081929104c43a5d48a))
* **samples:** close firestore instance in test ([googleapis#476](https://www.github.com/googleapis/java-firestore/issues/476)) ([fb1cb17](https://www.github.com/googleapis/java-firestore/commit/fb1cb175c06e2782f7cd9cb3bbb9c751e9d33713))
---

This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please).

v2.2.1

2021-02-02T19:08:59Z

v2.2.0: chore: release 2.2.0 (#369)

2021-01-20T20:10:03Z

chore: release 2.2.0 (googleapis#369)

🤖 I have created a release \*beep\* \*boop\*
---
## [2.2.0](https://www.github.com/googleapis/java-firestore/compare/v2.1.0...v2.2.0) (2021-01-20)

### Features

### Bug Fixes

### Documentation

* **sample:** normalize firestore sample's region tags ([googleapis#453](https://www.github.com/googleapis/java-firestore/issues/453)) ([b529245](https://www.github.com/googleapis/java-firestore/commit/b529245c75f770e1b47ca5d9561bab55a7610677))

### Dependencies

This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please).

v2.1.0: chore: release 2.1.0 (#345)

2020-09-15T17:52:03Z

chore: release 2.1.0 (googleapis#345)

🤖 I have created a release \*beep\* \*boop\*
---
## [2.1.0](https://www.github.com/googleapis/java-firestore/compare/v2.0.0...v2.1.0) (2020-09-10)

### Features

### Bug Fixes

* **samples:** re-add maven exec config for Quickstart sample ([googleapis#347](https://www.github.com/googleapis/java-firestore/issues/347)) ([4c2329b](https://www.github.com/googleapis/java-firestore/commit/4c2329bf89ffab4bd3060e16e1cf231b7caf4653))
* add support to deserialize to custom Lists and Maps ([googleapis#337](https://www.github.com/googleapis/java-firestore/issues/337)) ([dc897e0](https://www.github.com/googleapis/java-firestore/commit/dc897e00a85e745f57f615460b29d17b7dd247c6))

### Dependencies

* update dependency com.google.cloud:google-cloud-shared-dependencies to v0.9.0 ([googleapis#352](https://www.github.com/googleapis/java-firestore/issues/352)) ([783d41e](https://www.github.com/googleapis/java-firestore/commit/783d41e167c7c79957faeeebd7a76ab72b5b157d))
---

This PR was generated with [Release Please](https://github.com/googleapis/release-please).

v2.0.0: chore: release 2.0.0 (#309)

2020-08-14T02:20:04Z

chore: release 2.0.0 (googleapis#309)

🤖 I have created a release \*beep\* \*boop\*
---
## [2.0.0](https://www.github.com/googleapis/java-firestore/compare/v1.35.2...v2.0.0) (2020-08-14)

### New Features

#### Query Partition API

New API and backend RPC which allows for fetching a set of cursor keys for a
Collection Group Query. Accessible via the new [`CollectionGroup#getPartitions(long,ApiStreamObserver)`](https://googleapis.dev/java/google-cloud-firestore/2.0.0/com/google/cloud/firestore/CollectionGroup.html#getPartitions-long-com.google.api.gax.rpc.ApiStreamObserver-) method.

#### Read-Only Transaction Options

[`TransactionOptions`](https://googleapis.dev/java/google-cloud-firestore/2.0.0/com/google/cloud/firestore/TransactionOptions.html)
has been refactored to provide the ability to configure options for read-only
transactions along with the existing configuration for read-write transactions.

This new ability is provided via the new [`TransactionOptions.createReadOnlyOptionsBuilder()`](https://googleapis.dev/java/google-cloud-firestore/2.0.0/com/google/cloud/firestore/TransactionOptions.html#createReadOnlyOptionsBuilder--)
type safe builder.

Along with the new type safe builder for read-only options, there is a new type
safe builder for read-write options as well accessible via [`TransactionOptions.createReadWriteOptionsBuilder()`](https://googleapis.dev/java/google-cloud-firestore/2.0.0/com/google/cloud/firestore/TransactionOptions.html#createReadWriteOptionsBuilder--). Each of the existing `TransactionOptions.create(...)`
methods for configuring read-write options has been deprecated in favor of the new builder.

#### EmulatorCredentials

`com.google.cloud.firestore.FirestoreOptions.Builder.FakeCredentials` has been
made static and renamed to `com.google.cloud.firestore.FirestoreOptions.EmulatorCredentials`
allowing instantiation outside `FirestoreOptions.Builder`.

When connecting to the Cloud Firestore Emulator via `FirestoreOptions` rather than
the environment variable `FIRESTORE_EMULATOR_HOST`, a custom credential implementation
must be specified to allow various admin operations in the emulator. Previously
this required users to create their own implementation due to it not being
possible to construct a `FakeCredential`. As part of this change, `EmulatorCredentials`
is static and therefore able to be constructed from any location.

### Breaking Changes

#### New Firestore Admin Client API Artifact

The Cloud Firestore Admin Client has been migrated to its own maven artifact `com.google.cloud:google-cloud-firestore-admin`
rather than being bundled in `com.google.cloud:google-cloud-firestore`. All
packages and classes have retained their existing names.

The new artifact is included in the `com.google.cloud:google-cloud-firestore-bom`,
`com.google.cloud:google-cloud-bom` and `com.google.cloud:libraries-bom`
artifacts and is accessible by adding the new dependency to your `pom.xml` file:

```xml
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-firestore-admin</artifactId>
</dependency>
```

#### Removal of v1beta1

Cloud Firestore has been GA for some time now, and the `google-cloud-firestore`
code base has been using the protos and generated classes for the v1 api since
that time. As such, we will no longer be publishing artifacts for the deprecated
v1beta1 protos. All functionality from v1beta1 is present in v1, and all users
should update any code to use v1.

#### Removal of support for `java.util.Date` in Snapshots

It is no longer possible to configure the ability for `java.util.Date` to be
returned from `DocumentSnapshot.get(FieldPath)` or `DocumentSnapshot.getData()`
for properties which are stored as Timestamps in Cloud Firestore.

The default behavior has been to return `com.google.cloud.Timestamp` by default
for some time, and is now the only option. Any code that is dependent on the old
behavior must be updated to use Timestamps instead of Date.

### Laundry List of Pull Requests

#### ⚠ BREAKING CHANGES

* add support for the Query Partition API (googleapis#202)
* `Firestore#collectionGroup(...)` has a new return type `CollectionGroup`
which requires any code that previously used the method be re-compiled to
pick up the new signature. `CollectionGroup` extends `Query` and as such
does not require your code to be updated, only the compiled class files.
* move FirestoreAdminClient and associated classes to new artifact google-cloud-firestore-admin (googleapis#311)
* remove deprecated v1beta1 protos and grpc client (googleapis#305)
* remove deprecated FirestoreOptions#setTimestampsInSnapshotsEnabled (googleapis#308)
* remove deprecated getCollections() methods (googleapis#307)
* various renames due to generator changes