Changelog

3.21.0 (2024-04-26)

Features

Add Vector Index API (4964982)
Add VectorSearch API (4964982)

Bug Fixes

deps: Update the Java code generator (gapic-generator-java) to 2.39.0 (#1629) (4964982)

Documentation

Allow 14 week backup retention for Firestore daily backups (4964982)
Correct BackupSchedule recurrence docs that mentioned specific time of day (4964982)

3.20.2 (2024-04-19)

Dependencies

Update dependency com.google.cloud:sdk-platform-java-config to v3.29.0 (#1652) (1e3b0b9)

3.20.1 (2024-04-18)

Dependencies

Update beam.version to v2.55.1 (#1643) (88ce6c3)

3.20.0 (2024-03-26)

Features

Query Profiling (#1609) (55b1a49)

Dependencies

Update beam.version to v2.55.0 (#1631) (bdb2e43)

3.19.3 (2024-03-21)

Dependencies

Update dependency com.google.cloud:sdk-platform-java-config to v3.28.1 (#1625) (f390946)

3.19.2 (2024-03-18)

Dependencies

Update dependency com.google.cloud:sdk-platform-java-config to v3.28.1 (#1617) (44d5e8d)

3.19.1 (2024-03-15)

Dependencies

Update dependency com.google.cloud:sdk-platform-java-config to v3.28.0 (#1612) (06fa74e)

3.19.0 (2024-03-15)

Features

A new message Backup is added (#1611) (434a55b)
Add ExplainMetrics field to RunAggregationQueryResponse (f275b16)
Add ExplainMetrics field to RunQueryResponse (f275b16)
Add ExplainOptions field to RunAggregationQueryRequest (f275b16)
Add ExplainOptions field to RunQueryRequest (f275b16)
Add new types ExplainOptions, ExplainMetrics, PlanSummary, ExecutionStats (#1608) (f275b16)

Bug Fixes

Update DocFX profile (#1603) (0a2eb16)

3.18.0 (2024-03-04)

Features

Instant support (#1586) (77a9bfc)

Bug Fixes

deps: Update the Java code generator (gapic-generator-java) to 2.37.0 (#1597) (7574dfd)
Only override built-in retry settings when the customer provides them. (#1588) (103c37a)

Dependencies

Update dependency com.google.cloud:sdk-platform-java-config to v3.27.0 (#1596) (2672d71)

3.17.1 (2024-02-22)

Dependencies

Update dependency org.graalvm.buildtools:junit-platform-native to v0.10.1 (#1576) (f45af23)
Update dependency org.graalvm.buildtools:native-maven-plugin to v0.10.1 (#1577) (396d06b)

3.17.0 (2024-02-15)

Features

Add an API method for reordering firewall policies (#1572) (60d8ab1)

Bug Fixes

Transactions with readTime will omit begin and commit transaction requests, and instead pass readTime on individual read requests. (#1565) (d5fb01a)

Dependencies

Update beam.version to v2.54.0 (#1571) (e0d4daa)
Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.25.0 (#1567) (b6c1531)

3.16.3 (2024-02-05)

Dependencies

Update dependency org.junit.vintage:junit-vintage-engine to v5.10.2 (#1559) (502cf05)

3.16.2 (2024-02-01)

Bug Fixes

Remove QueryMode field from RunAggregationQueryRequest (32b539c)
Remove QueryMode field from RunQueryRequest (32b539c)
Remove ResultSetStats field from RunAggregationQueryResponse (32b539c)
Remove ResultSetStats field from RunQueryResponse (32b539c)
Remove types QueryMode, QueryPlan, ResultSetStats (32b539c)

Dependencies

Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.24.0 (#1551) (6874143)
Update dependency org.graalvm.buildtools:junit-platform-native to v0.10.0 (#1553) (701d820)
Update dependency org.graalvm.buildtools:native-maven-plugin to v0.10.0 (#1554) (581da1f)

3.16.1 (2024-01-25)

Bug Fixes

internalStream should handle duplicate onCompletes. (#1523) (b3067d7)
Allow an explicit MustExist precondition for update (#1542) (46e09aa)
deps: Update the Java code generator (gapic-generator-java) to 2.32.0 (#1534) (2281320)
Make rollback best effort. (#1515) (4c39af5)
Thread safe UpdateBuilder (#1537) (f9cdab5)

Dependencies

Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.22.0 (#1535) (04c0e07)
Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.23.0 (#1544) (79713bf)

Documentation

Fix formatting due to unclosed backtick (#1529) (3c78fe3)
Rring BulkWriter out of BetaApi status. (#1513) (c2812f7)

3.16.0 (2024-01-10)

Features

Add DeleteDatabase API and delete protection (#1508) (81a1b48)
Add new types QueryMode, QueryPlan, ResultSetStats (#1516) (3060e86)
Expose Firestore namespace ID fields in import/export APIs to stable (21ad25f)
Expose Firestore PITR fields in Database to stable (#1495) (21ad25f)
Expose Firestore snapshot_time field in export API to stable (21ad25f)
Logical termination for firestore.getAll(...). (#1517) (c6448fc)

Bug Fixes

Better error message when Transaction/WriteBatch is modified after commit. (#1503) (9693c7b)
deps: Update the Java code generator (gapic-generator-java) to 2.31.0 (#1520) (c4c5a0b)

Dependencies

Update beam.version to v2.53.0 (#1514) (7639e0d)
Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.21.0 (#1518) (866b2b4)

Documentation

Assorted typo fixes and whitespace updates (21ad25f)
Remove latin abbreviations from comments. (#1457) (1cfa03d)
Tweak Count API docs (#1522) (e25ae13)

3.15.7 (2023-12-01)

Dependencies

Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.20.0 (#1490) (73a85e7)

3.15.6 (2023-11-22)

Dependencies

Update beam.version to v2.52.0 (#1480) (45e33f7)
Update dependency org.apache.commons:commons-lang3 to v3.14.0 (#1482) (3ef71f8)

3.15.5 (2023-11-14)

Bug Fixes

Prevent watch stream from emitting events after close. (#1471) (ee3f8c0)

Dependencies

Update actions/github-script action to v7 (#1473) (1097a0b)
Update actions/github-script action to v7 (#1475) (d848d87)

3.15.4 (2023-11-07)

Dependencies

Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.19.0 (#1467) (a048707)

3.15.3 (2023-11-06)

Dependencies

Update dependency org.junit.vintage:junit-vintage-engine to v5.10.1 (#1463) (6180322)

3.15.2 (2023-10-20)

Dependencies

Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.18.0 (#1450) (d32d343)
Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.28 (#1451) (a008a69)
Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.28 (#1452) (59daefe)

3.15.1 (2023-10-11)

Dependencies

Update dependency org.apache.beam:beam-runners-direct-java to v2.51.0 (#1443) (738f93a)

3.15.0 (2023-10-10)

Features

Sum and Average aggregations (#1387) (afa5c01)

Dependencies

Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.17.0 (#1437) (cd006f9)

3.14.4 (2023-09-28)

Bug Fixes

Add tests for multiple inequality support (#1392) (e01b3a1)

Dependencies

Remove unused dependency that is blocking PR 1428 (#1429) (73ff8dc)
Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.16.1 (#1431) (38832f9)
Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.27 (#1425) (dc26bbb)
Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.27 (#1426) (5e8b299)

3.14.3 (2023-09-12)

Bug Fixes

Add reflections configs for generated firestore classes (#1419) (1c5e09f)

Dependencies

Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.15.0 (#1417) (3626776)

3.14.2 (2023-09-07)

Dependencies

Update beam.version to v2.50.0 (#1410) (fa14cad)
Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.26 (#1413) (501af1a)
Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.26 (#1414) (afb93d2)

3.14.1 (2023-08-25)

Dependencies

Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.25 (#1405) (01720e5)
Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.25 (#1406) (438ad97)

3.14.0 (2023-08-08)

Features

Publish proto definitions for SUM/AVG in Firestore (#1304) (b025d11)

Dependencies

Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.14.0 (#1385) (d215982)
Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.24 (#1388) (24be02b)
Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.24 (#1389) (34e30e0)

3.13.8 (2023-07-28)

Dependencies

Update dependency org.apache.commons:commons-lang3 to v3.13.0 (#1380) (f6f07fb)

3.13.7 (2023-07-27)

Dependencies

Update beam.version to v2.49.0 (#1357) (6eaf446)

3.13.6 (2023-07-24)

Dependencies

Update dependency org.junit.vintage:junit-vintage-engine to v5.10.0 (#1368) (188a8e9)

3.13.5 (2023-07-20)

Dependencies

Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.13.1 (#1364) (7dde6ee)

3.13.4 (2023-07-20)

Bug Fixes

Remove 'x-goog-request-params' header from GRPC requests due to incorrect format. (#1358) (1a1bf5f)

3.13.3 (2023-07-13)

Dependencies

Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.13.0 (#1351) (7c11f8a)

3.13.2 (2023-06-22)

Dependencies

Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.12.0 (#1338) (0ef1882)

3.13.1 (2023-06-21)

Dependencies

Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.23 (#1329) (ea5e78f)
Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.23 (#1330) (63a01e6)

3.13.0 (2023-06-12)

Features

Add toString methods to classes comprising WriteBatch (#1281) (9df8028)

Dependencies

Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.11.0 (#1322) (c2bca72)

3.12.1 (2023-06-05)

Dependencies

Update beam.version to v2.48.0 (#1311) (0a20e1a)

3.12.0 (2023-05-30)

Features

Add ApiScope and COLLECTION_RECURSIVE query_scope for Firestore index (#1300) (b84a7cd)

Dependencies

Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.10.1 (#1305) (b734212)

3.11.0 (2023-05-12)

Features

Add bloom filter related proto fields (#1285) (9b14c1b)

Dependencies

Update beam.version to v2.47.0 (#1292) (e9f11e8)
Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.9.0 (#1291) (6dd0e8f)
Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.22 (#1293) (e8e5f9b)
Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.22 (#1294) (f0ceb7f)

3.10.0 (2023-04-27)

Features

Add bloom filter related proto fields (only in the preview API surface) (#1274) (41909b7)

3.9.6 (2023-04-26)

Dependencies

Update dependency org.junit.vintage:junit-vintage-engine to v5.9.3 (#1275) (1f32893)

3.9.5 (2023-04-25)

Dependencies

Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.8.0 (#1268) (8a92dc9)

3.9.4 (2023-04-12)

Dependencies

Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.7.0 (#1257) (52db039)
Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.21 (#1258) (12bcf02)
Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.21 (#1259) (19b5da2)

3.9.3 (2023-03-29)

Dependencies

Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.6.0 (#1247) (aa098e0)

3.9.2 (2023-03-20)

Dependencies

Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.5.0 (#1239) (61b1439)

3.9.1 (2023-03-15)

Dependencies

Update beam.version to v2.46.0 (#1228) (ffc853f)

3.9.0 (2023-03-06)

Features

Enable OR Query support. (#1007) (e502cd4)

3.8.2 (2023-03-02)

Dependencies

Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.4.0 (#1219) (fe84125)

3.8.1 (2023-02-17)

Dependencies

Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.3.0 (#1206) (a118ce0)

3.8.0 (2023-02-15)

Features

Add OR query support (#1198) (566b788)

Dependencies

Update beam.version to v2.45.0 (#1201) (196a75d)
Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.20 (#1196) (51fe67c)
Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.20 (#1197) (a66b8b4)

3.7.10 (2023-02-06)

Dependencies

Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.2.0 (#1185) (42c34da)

3.7.9 (2023-01-27)

Bug Fixes

java: Fix error message returned for invalid snapshot listener inequality filter (#1093) (bf7f4a3)
java: Skip fixing poms for special modules (#1744) (#1172) (222be48)

3.7.8 (2023-01-20)

Dependencies

Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.1.2 (#1174) (187a9be)

3.7.7 (2023-01-18)

Dependencies

Update beam.version to v2.44.0 (#1166) (3364d6e)

3.7.6 (2023-01-13)

Dependencies

Update dependency org.junit.vintage:junit-vintage-engine to v5.9.2 (#1158) (418b2bf)

3.7.5 (2023-01-13)

Dependencies

Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.1.1 (#1157) (c7c688b)

3.7.4 (2022-12-08)

Dependencies

Update multiple dependencies atomically (#1145) (36bb40b)

3.7.3 (2022-11-21)

Dependencies

Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.18 (#1132) (6b57290)
Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.18 (#1133) (8cb45ae)

3.7.2 (2022-11-18)

Dependencies

Update beam.version to v2.43.0 (#1127) (ff1df71)

3.7.1 (2022-11-08)

Dependencies

Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.0.6 (#1092) (019840f)
Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.17 (#1087) (a78be32)

3.7.0 (2022-10-22)

Features

Add retry logic to COUNT queries (#1062) (5789e4b)

Bug Fixes

Fix limitToLast queries with cursors (#1072) (e9e1548)

Dependencies

Update beam.version to v2.42.0 (#1066) (03de01a)
Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.0.5 (#1071) (4c3f122)
Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.16 (#1064) (a7ddc9e)
Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.15 (#1065) (d9e7803)
Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.16 (#1069) (97ef50a)

3.6.0 (2022-10-04)

Features

Count queries (not available for use yet) (#1033) (8b60612)
Make count queries publicly available for use (#1042) (1c8d242)

Documentation

AggregateQuery.java: describe why we ignore subsequent responses (#1041) (8150544)

Dependencies

Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.0.4 (#1053) (9b4c26e)
Update dependency org.graalvm.buildtools:junit-platform-native to v0.9.14 (#1045) (04b3861)
Update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.14 (#1046) (6631a58)
Update dependency org.junit.vintage:junit-vintage-engine to v5.9.1 (#1039) (84423f4)

3.5.0 (2022-09-16)

Features

Add firestore aggregation query apis to the stable googleapis branch (#1030) (0e3e2ac)

Dependencies

Update actions/setup-java action to v3 (#1031) (1aae546)
Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.0.2 (#1032) (9b68360)
Update dependency com.google.cloud:google-cloud-shared-dependencies to v3.0.3 (#1034) (5acd8e4)

3.4.2 (2022-08-24)

Dependencies

update beam.version to v2.41.0 (#1022) (fb14e2f)

3.4.1 (2022-08-19)

Bug Fixes

declare gson as runtime rather than test (#1004) (e37e997)

3.4.0 (2022-08-03)

Features

Support for Composite Filters. (#975) (9d0653a)

Bug Fixes

update gapic-generator-java with mock service generation fixes (#960) (a9338ff)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v3 (#1000) (a3c4ec5)
update dependency org.graalvm.buildtools:junit-platform-native to v0.9.12 (#972) (8cf33b0)
update dependency org.graalvm.buildtools:junit-platform-native to v0.9.13 (#988) (f8d9496)
update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.13 (#989) (4c768e3)
update dependency org.junit.vintage:junit-vintage-engine to v5.9.0 (#997) (d4dd4d8)

3.3.0 (2022-07-01)

Features

add logical termination for RunQueryResponse (#956) (1d869c8)

Bug Fixes

add build script for JDK 17 native image testing (#965) (963e384)

Performance Improvements

Change how proto was called in Query.java (#970) (f6f6352)

Dependencies

update beam.version to v2.40.0 (#978) (44276f8)
update dependency com.google.cloud:google-cloud-shared-dependencies to v2.13.0 (#974) (6def73d)
update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.12 (#973) (bfb4ec9)

3.2.0 (2022-05-23)

Features

enable RunQueryResponse.done (#942) (055b029)

Documentation

sample: remove unused native-image-support module (#952) (17c2de9)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v2.12.0 (#959) (f1d6b17)

3.1.0 (2022-04-21)

Features

relocate Firestore native image configuration from java-core (#941) (900a7a8)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v2.10.0 (#945) (5b2e318)
update dependency com.google.cloud:native-image-support to v0.13.1 (#944) (b3b474f)

3.0.21 (2022-03-30)

Bug Fixes

change REST binding for ListDocuments to support root collection (#900) (aabd4ac)
java: move test native image configs to test/resources (#929) (9ed6c5e)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v2.9.0 (#932) (abebae7)
update dependency com.google.cloud:native-image-support to v0.12.11 (#931) (0e1e3c5)

3.0.20 (2022-03-24)

Dependencies

update dependency org.graalvm.buildtools:junit-platform-native to v0.9.11 (#923) (43f24b1)
update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.11 (#924) (70b0d00)

3.0.19 (2022-03-14)

Bug Fixes

java: fix native image Kokoro test setup (#919) (7d905a5)

Dependencies

update dependency com.google.cloud:native-image-support to v0.12.10 (#917) (0a650e0)

3.0.18 (2022-03-10)

Dependencies

update dependency com.google.cloud:native-image-support to v0.12.9 (#912) (fedf824)

3.0.17 (2022-03-09)

Dependencies

update dependency com.google.cloud:native-image-support to v0.12.8 (#909) (2580d8f)

3.0.16 (2022-03-08)

Dependencies

update dependency com.google.cloud:native-image-support to v0.12.7 (#902) (843dd0e)

3.0.15 (2022-03-02)

Documentation

sample: Use Java 8 for native image sample (#893) (5955f54)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v2.8.0 (#895) (bf1951d)
update dependency com.google.cloud:native-image-support to v0.12.6 (#898) (73606e5)

3.0.14 (2022-03-01)

Bug Fixes

fix groupID for artifacts (#890) (bb46bcb)
java: add reflection configuration for native image tests (#878) (1938113)

Dependencies

update actions/setup-java action to v3 (#888) (07130f9)
update dependency com.google.cloud:native-image-support to v0.12.5 (#889) (5f4ffcb)
update dependency org.graalvm.buildtools:junit-platform-native to v0.9.10 (#880) (a3a9684)

3.0.13 (2022-02-22)

Bug Fixes

retry watch on InternalException (#875) (a76a0fd)

Documentation

sample: Add sample for native image support in Firestore (#872) (a01fe88)

Dependencies

update dependency com.google.cloud:native-image-support to v0.12.4 (#882) (b2aeb1a)
update dependency org.graalvm.buildtools:native-maven-plugin to v0.9.10 (#881) (036f7f8)

3.0.12 (2022-02-04)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v2.7.0 (#860) (bf48381)
update dependency org.apache.commons:commons-lang3 to v3.12.0 (#846) (efc73bd)

3.0.11 (2022-01-27)

Bug Fixes

close the Watch stream when we receive an error (#834) (077c9be)

3.0.10 (2022-01-07)

Bug Fixes

java: add -ntp flag to native image testing command (#829) (a0fb54f)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v2.6.0 (#841) (ea34d81)

3.0.9 (2021-12-03)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v2.5.1 (#825) (1b8e3a3)

3.0.8 (2021-11-16)

Bug Fixes

respect total request timeout for Query retries (#806) (feb1921)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v2.5.0 (#814) (c1f4dac)

3.0.7 (2021-10-27)

Bug Fixes

java: java 17 dependency arguments (#802) (ec07294)
set timeouts for BatchGetDocuments/RunQuery (#799) (6cd2a45)

3.0.6 (2021-10-19)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v2.4.0 (#793) (1af36a9)

3.0.5 (2021-09-22)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v2.3.0 (#775) (35469d6)

3.0.4 (2021-09-14)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v2.2.1 (#765) (e7a6537)

3.0.3 (2021-08-31)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v2.2.0 (#753) (6744bfa)
update google-cloud-conformance-tests to 0.2.0 (#752) (135bc6b)

3.0.2 (2021-08-23)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v2.1.0 (#739) (99b5820)

3.0.1 (2021-08-11)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v2.0.1 (#728) (167683d)

3.0.0 (2021-08-09)

⚠ BREAKING CHANGES

update Java compile to 1.8 (#710)
update gapic generator to 2.0.0, java 8 features (#719)

Features

update Java compile to 1.8 (#710)
gapic-generator-java v1.0.13, mtls support (#712) (a27dd9c)
update gapic generator to 2.0.0, java 8 features (#719) (0d5b378)

Dependencies

update shared dependencies to 2.0.0 (#720) (e4f985e)

2.6.2 (2021-07-29)

Bug Fixes

Add shopt -s nullglob to dependencies script (8f4b199)
Ensures bundles are encoded as UTF8 bytes. (#695) (0946a17)
lower batch size on BulkWriter retry (#688) (146b21d)
Update dependencies.sh to not break on mac (#694) (8f4b199)

Documentation

began merging variant client samples (#696) (0a10dd8)

2.6.1 (2021-06-30)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v1.4.0 (#680) (b8ffcb4)

2.6.0 (2021-06-29)

Features

add shutdown() and shutdownNow() (#673) (4f20858)

Bug Fixes

handle thrown exceptions in runAsyncTransaction callback (#671) (969f7fd)

2.5.1 (2021-06-22)

Bug Fixes

return results from getPartitions() in order (#653) (12d17d1)

Dependencies

update dependency com.google.cloud:google-cloud-conformance-tests to v0.1.1 (#650) (b93ca8a)
update dependency com.google.cloud:google-cloud-shared-dependencies to v1.3.0 (#660) (0f13fd0)

2.5.0 (2021-06-01)

Features

add gcf-owl-bot[bot] to ignoreAuthors (#641) (6f40f0f)
add recursiveDelete() to Firestore (#622) (#649) (9ff2f41)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v1.2.0 (#640) (9bd881a)

2.4.0 (2021-05-17)

Features

add buffering layer to BulkWriter (#611) (a7caff2)

Bug Fixes

add flush check in BulkWriter.sendBatchLocked() callback (#631) (ac3db81)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v1.1.0 (#626) (00dbe33)

2.3.0 (2021-04-23)

Features

add backoff to BulkWriter (#600) (e295aa5)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v1 (#607) (21e8cde)

2.2.7 (2021-04-20)

Bug Fixes

release scripts from issuing overlapping phases (#595) (4372479)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v0.21.1 (#597) (dbd3d33)

2.2.6 (2021-04-13)

Bug Fixes

Removed Jackson dependency (#508) (7ada73d)
typo (#587) (520ac44)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v0.21.0 (#584) (c83a222)

2.2.5 (2021-03-11)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v0.20.1 (#567) (7370d21)

2.2.4 (2021-02-25)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v0.20.0 (#554) (0ae4ea3)

2.2.3 (2021-02-19)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v0.19.0 (#543) (7eed88c)

2.2.2 (2021-02-19)

Bug Fixes

block close() on the termination of all RPC channels (#512) (67bd06a)
samples: close firestore instance in test (#476) (fb1cb17)

2.2.1 (2021-02-02)

Bug Fixes

don't throw NPE in DocumentSnapshot.getDate() when value is missing (#513) (a41b07e)

2.2.0 (2021-01-20)

Features

Add bundle proto building (#271) (994835c)
add bundle.proto from googleapis/googleapis (#407) (37da386)
add CollectionGroup#getPartitions(long) (#478) (bab064e)
add implicit ordering for startAt(DocumentReference) calls (#417) (aae6dc9)
add max/min throttling options to BulkWriterOptions (#400) (27a9397)
add success and error callbacks to BulkWriter (#483) (3c05037)
Implementation of Firestore Bundle Builder (#293) (fd5ef90)
Release bundles (#466) (3af065e)

Bug Fixes

add @BetaApi, make BulkWriter public, and refactor Executor (#497) (27ff9f6)
build: sample checkstyle violations (#457) (777ecab)
bulkWriter: writing to the same doc doesn't create a new batch (#394) (259ece8)
empty commit to trigger release-please (fcef0d3)
make BulkWriterOptions public (#502) (6ea05be)
retry Query streams (#426) (3513cd3)
retry transactions that fail with expired transaction IDs (#447) (5905438)
verify partition count before invoking GetPartition RPC (#418) (2054ae9)

Documentation

sample: normalize firestore sample's region tags (#453) (b529245)

Dependencies

remove explicit version for jackson (#479) (e2aecfe)
update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.12 (#367) (2bdd846)
update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.13 (#411) (e6157b5)
update dependency com.google.cloud:google-cloud-shared-dependencies to v0.10.0 (#383) (cb39ee8)
update dependency com.google.cloud:google-cloud-shared-dependencies to v0.10.2 (#403) (991dd81)
update dependency com.google.cloud:google-cloud-shared-dependencies to v0.12.1 (#425) (b897ffa)
update dependency com.google.cloud:google-cloud-shared-dependencies to v0.13.0 (#430) (0f8f218)
update dependency com.google.cloud:google-cloud-shared-dependencies to v0.14.1 (#446) (e241f8e)
update dependency com.google.cloud:google-cloud-shared-dependencies to v0.15.0 (#460) (b82fc35)
update dependency com.google.cloud:google-cloud-shared-dependencies to v0.16.0 (#481) (ae98824)
update dependency com.google.cloud:google-cloud-shared-dependencies to v0.16.1 (4ace93c)
update dependency com.google.cloud:google-cloud-shared-dependencies to v0.17.0 (#487) (e11e472)
update dependency com.google.cloud:google-cloud-shared-dependencies to v0.18.0 (#495) (f78720a)
update jackson dependencies to v2.11.3 (#396) (2e176e2)

2.1.0 (2020-09-10)

Features

add method to set emulator host programmatically (#319) (#336) (97037f4), closes #210 #190
add opencensus tracing support (#360) (edaa539)
add support for != and NOT_IN queries (#350) (68aff5b)
generate protos to add NOT_EQUAL, NOT_IN, IS_NOT_NAN, IS_NOT_NULL query operators (#343) (3fb1b63)

Bug Fixes

samples: re-add maven exec config for Quickstart sample (#347) (4c2329b)
add support to deserialize to custom Lists and Maps (#337) (dc897e0)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v0.9.0 (#352) (783d41e)

2.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) method.

Read-Only Transaction Options

TransactionOptions 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() 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(). 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:

<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 (#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 (#311)
remove deprecated v1beta1 protos and grpc client (#305)
remove deprecated FirestoreOptions#setTimestampsInSnapshotsEnabled (#308)
remove deprecated getCollections() methods (#307)
various renames due to generator changes

Features

add support for read-only transactions in TransactionOptions (#320) (c25dca3)
add support for the Query Partition API (#202) (3996548)

Bug Fixes

refactor FakeCredentials (#325) (269e62c), closes #190

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v0.8.5 (#322) (1b21350)
update dependency com.google.cloud:google-cloud-shared-dependencies to v0.8.6 (#324) (b945fdb)
update jackson dependencies to v2.11.2 (#314) (15d68cd)

Miscellaneous Chores

enable gapicv2 (#188) (92224bc)
move FirestoreAdminClient and associated classes to new artifact google-cloud-firestore-admin (#311) (03ef755)
remove deprecated FirestoreOptions#setTimestampsInSnapshotsEnabled (#308) (7255a42)
remove deprecated getCollections() methods (#307) (bb4ddf1)
remove deprecated v1beta1 protos and grpc client (#305) (96adacb)
add BulkWriter (#323) (e7054df)
make BulkWriter package private (#330) (ef0869a)

1.35.2 (2020-07-16)

Bug Fixes

add Internal#autoId() (#292) (b91c57c)
add support for deleting nested fields that contain periods (#295) (84f602e)
use test credentials when connecting to the Emulator from the Firebase Admin SDK (#296) (a0a6e80)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v0.8.3 (#289) (2ddb8f1)

1.35.1 (2020-07-01)

Dependencies

update dependency com.google.cloud:google-cloud-shared-dependencies to v0.8.2 (#280) (9296f7a)
update jackson dependencies to v2.11.1 (#272) (1065704)
adopt flatten plugin and google-cloud-shared-dependencies (#261) (78b2ebf)

1.35.0 (2020-06-17)

Features

ability to serialize Query to Proto (#241) (bae22e0)
add support for fieldmask to document reference (#245) (4a846b1)

Dependencies

update core dependencies (#254) (9b275ca)
update dependency com.google.api:api-common to v1.9.2 (#238) (c47d327)
update dependency io.grpc:grpc-bom to v1.30.0 (#244) (b5749d4)

1.34.0 (2020-05-29)

Features

add support for BigDecimal to CustomClassMapper (#196) (a471f1e)
Create CODEOWNERS (#207) (cd19eae)

Bug Fixes

add RateLimiter (#230) (47d4a11)
catch null Firestore in system tests (#215) (2a4a7b5)
Fields used in whereIn should be equality filters (#216) (4a62633)
replace usages of transform proto with update_transform (#213) (46a3c51)
support array of references for IN queries (#211) (b376003)

Dependencies

update core dependencies to v1.93.5 (#229) (b078213)
update dependency com.google.api:api-common to v1.9.1 (#228) (7e4568d)
update dependency com.google.api.grpc:proto-google-common-protos to v1.18.0 (#204) (1e05de4)
update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.10 (#197) (69372af)
update dependency com.google.guava:guava-bom to v29 (#180) (3c204b4)
update dependency io.grpc:grpc-bom to v1.29.0 (#206) (5d8c50f)
update dependency org.threeten:threetenbp to v1.4.4 (#194) (c867bd5)
update jackson dependencies to v2.11.0 (#195) (5066812)
update protobuf.version to v3.12.0 (#220) (2c0b35d)
update protobuf.version to v3.12.2 (#226) (2eeea19)

Documentation

update README to include code formatting (#209) (04f8b3b)

1.33.0 (2020-04-08)

Features

add new Firestore.runAsyncTransaction (#103) (b28b660)
- NOTICE This change will require any users of the library that implement com.google.cloud.firestore.Firestore to have to implement the new runAsyncTransaction methods, and is a binary incompatible change in Java 7. Those users who only use com.google.cloud.firestore.Firestore through the instance returned from FirestoreOptions.getDefaultInstance().getService() will not have to recompile their code.
add Query.limitToLast() (#151) (c104615)
base transaction retries on error codes (#129) (00b6eb3), closes googleapis/nodejs-firestore#953
use SecureRandom instead of Random to reduce the chance of auto-id collisions (#156) (0088ee7)

Bug Fixes

add missing @InternalExtensionOnly annotation to com.google.cloud.firestore.Firestore (#141) (d3458cb)
add support for updating an individual field with pojo in all update method (#136) (7d6c2c1)
mark v1beta1 as deprecated (#154) (495f7f9)

Dependencies

update core dependencies (#127) (7995db0)
update core dependencies (#167) (11f16fd)
update core dependencies to v1.55.0 (#158) (f3a20d3)
update core dependencies to v1.93.3 (#132) (50394e1)
update core dependencies to v1.93.4 (#168) (2118232)
update dependency com.google.api:api-common to v1.9.0 (#153) (8ca0ea8)
update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.8 (#123) (0bbf4b0)
update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.9 (#152) (d41c41f)
update dependency com.google.cloud.samples:shared-configuration to v1.0.13 (#148) (6bd8e7f)
update dependency org.threeten:threetenbp to v1.4.2 (#142) (41b2a9a)
update dependency org.threeten:threetenbp to v1.4.3 (#165) (d8bfa80)

1.32.5 (2020-03-05)

Bug Fixes

deflake-ify ITSystemTest#queryWatch (#107) (f701c67)

Dependencies

update core dependencies (#120) (293ba55)
update core dependencies to v1.93.1 (#124) (6ce14ce)
update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.6 (#118) (7dad920)
update dependency io.grpc:grpc-bom to v1.27.2 (#116) (83ef310)
update jackson dependencies to v2.10.3 (#122) (85a3ced)

1.32.4 (2020-02-18)

Bug Fixes

add cause to transaction errors on transaction commit (#108) (00b3c6f)
remove error_prone_annotations exclusion rules from poms (#97) (0f9b474)

Dependencies

update core dependencies to v1.92.5 (#101) (e767078)
update dependency io.grpc:grpc-bom to v1.27.1 (#106) (46a7c48)
update opencensus.version to v0.25.0 (#105) (fcdbab3)
update protobuf.version to v3.11.4 (#109) (4f498b4)

Documentation

regen: update sample code to set total timeout, add API client header test (#100) (d14a4a1)

1.32.3 (2020-02-03)

Dependencies

update core dependencies (#89) (7593432)
update dependency com.google.auth:google-auth-library-credentials to v0.20.0 (#86) (f32bd9b)
update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.5 (#90) (f701446)
update protobuf.version to v3.11.3 (#94) (6155816)

1.32.2 (2020-01-14)

Dependencies

update core dependencies (#63) (4c1fb09)
update dependency com.fasterxml.jackson.core:jackson-core to v2.10.2 (#69) (5e296b8)
update dependency com.fasterxml.jackson.core:jackson-databind to v2.10.2 (#70) (2f3a14b)
update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.4 (#82) (6050055)
update dependency com.google.guava:guava-bom to v28.2-android (#76) (c1dcb9f), closes #33
update dependency com.google.truth:truth to v1.0.1 (#81) (5d16063)
update dependency org.threeten:threetenbp to v1.4.1 (#78) (0db7256)

1.32.1 (2020-01-02)

Bug Fixes

add google-cloud-firestore to bom (#65) (b273a58)
set google-cloud-conformance-tests to test scope (#44) (03983c3)

Dependencies

update dependencies (#51) (ce4c37b), closes #49 #50
update dependency com.google.auth:google-auth-library-credentials to v0.19.0 (#48) (d68b457)
update dependency com.google.cloud:google-cloud-conformance-tests to v0.0.3 (#55) (6e6644f)
update dependency junit:junit to v4.13 (#62) (7f80e44)

Documentation

bump bom version in README to 3.1.0 (#47) (d8bebb3)

1.32.0 (2019-12-04)

Features

firestore: allow passing POJOs as field values throughout API reference (#6843) (180f5a9)

Dependencies

update gax.version to v1.51.0 (#31) (d5125c5)
update protobuf packages to v3.11.0 (#26) (862ebce)
update protobuf packages to v3.11.1 (#28) (c0c3b2c)