Merge branch 'googleapis:main' into better_data_type

.github/.OwlBot.lock.yaml

@@ -13,5 +13,5 @@
 # limitations under the License.
 docker:
   image: gcr.io/cloud-devrel-public-resources/owlbot-python:latest
-  digest: sha256:a8a80fc6456e433df53fc2a0d72ca0345db0ddefb409f1b75b118dfd1babd952
-# created: 2024-03-15T16:25:47.905264637Z
+  digest: sha256:5a4c19d17e597b92d786e569be101e636c9c2817731f80a5adec56b2aa8fe070
+# created: 2024-04-12T11:35:58.922854369Z

.github/auto-label.yaml

@@ -13,3 +13,8 @@
 # limitations under the License.
 requestsize:
   enabled: true
+
+path:
+  pullrequest: true
+  paths:
+    samples: "samples"

.github/blunderbuss.yml

@@ -0,0 +1,20 @@
+# Blunderbuss config
+#
+# This file controls who is assigned for pull requests and issues.
+# Note: This file is autogenerated. To make changes to the assignee
+# team, please update `codeowner_team` in `.repo-metadata.json`.
+assign_issues:
+  - googleapis/api-firestore
+  - googleapis/api-firestore-partners
+
+assign_issues_by:
+  - labels:
+      - "samples"
+    to:
+      - googleapis/python-samples-reviewers
+      - googleapis/api-firestore
+      - googleapis/api-firestore-partners
+
+assign_prs:
+  - googleapis/api-firestore
+  - googleapis/api-firestore-partners

.kokoro/requirements.txt

@@ -252,9 +252,9 @@ googleapis-common-protos==1.61.0 \
     --hash=sha256:22f1915393bb3245343f6efe87f6fe868532efc12aa26b391b15132e1279f1c0 \
     --hash=sha256:8a64866a97f6304a7179873a465d6eee97b7a24ec6cfd78e0f575e96b821240b
     # via google-api-core
-idna==3.4 \
-    --hash=sha256:814f528e8dead7d329833b91c5faa87d60bf71824cd12a7530b5526063d02cb4 \
-    --hash=sha256:90b77e79eaa3eba6de819a0c442c0b4ceefc341a7a2ab77d7562bf49f425c5c2
+idna==3.7 \
+    --hash=sha256:028ff3aadf0609c1fd278d8ea3089299412a7a8b9bd005dd08b9f8285bcb5cfc \
+    --hash=sha256:82fee1fc78add43492d3a1898bfa6d8a904cc97d8427f683ed8e798d07761aa0
     # via requests
 importlib-metadata==6.8.0 \
     --hash=sha256:3ebb78df84a805d7698245025b975d9d67053cd94c79245ba4b3eb694abe68bb \

README.rst

@@ -15,7 +15,7 @@ Python Client for Cloud Firestore API
 .. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-firestore.svg
    :target: https://pypi.org/project/google-cloud-firestore/
 .. _Cloud Firestore API: https://cloud.google.com/firestore
-.. _Client Library Documentation: https://cloud.google.com/python/docs/reference/firestore/latest
+.. _Client Library Documentation: https://cloud.google.com/python/docs/reference/firestore/latest/summary_overview
 .. _Product Documentation:  https://cloud.google.com/firestore
 
 Quick Start

docs/index.rst

@@ -42,3 +42,8 @@ For a list of all ``google-cloud-firestore`` releases:
   :maxdepth: 2
 
   changelog
+
+.. toctree::
+  :hidden:
+
+  summary_overview.md

docs/summary_overview.md

@@ -0,0 +1,22 @@
+[
+This is a templated file. Adding content to this file may result in it being
+reverted. Instead, if you want to place additional content, create an
+"overview_content.md" file in `docs/` directory. The Sphinx tool will
+pick up on the content and merge the content.
+]: #
+
+# Cloud Firestore API
+
+Overview of the APIs available for Cloud Firestore API.
+
+## All entries
+
+Classes, methods and properties & attributes for
+Cloud Firestore API.
+
+[classes](https://cloud.google.com/python/docs/reference/firestore/latest/summary_class.html)
+
+[methods](https://cloud.google.com/python/docs/reference/firestore/latest/summary_method.html)
+
+[properties and
+attributes](https://cloud.google.com/python/docs/reference/firestore/latest/summary_property.html)

google/cloud/firestore_admin_v1/services/firestore_admin/async_client.py

@@ -2509,9 +2509,8 @@ async def create_backup_schedule(
     ) -> schedule.BackupSchedule:
         r"""Creates a backup schedule on a database.
         At most two backup schedules can be configured on a
-        database, one daily backup schedule with retention up to
-        7 days and one weekly backup schedule with retention up
-        to 14 weeks.
+        database, one daily backup schedule and one weekly
+        backup schedule.
 
         .. code-block:: python
 

google/cloud/firestore_admin_v1/services/firestore_admin/client.py

@@ -2978,9 +2978,8 @@ def create_backup_schedule(
     ) -> schedule.BackupSchedule:
         r"""Creates a backup schedule on a database.
         At most two backup schedules can be configured on a
-        database, one daily backup schedule with retention up to
-        7 days and one weekly backup schedule with retention up
-        to 14 weeks.
+        database, one daily backup schedule and one weekly
+        backup schedule.
 
         .. code-block:: python
 

google/cloud/firestore_admin_v1/services/firestore_admin/transports/grpc.py

@@ -828,9 +828,8 @@ def create_backup_schedule(
 
         Creates a backup schedule on a database.
         At most two backup schedules can be configured on a
-        database, one daily backup schedule with retention up to
-        7 days and one weekly backup schedule with retention up
-        to 14 weeks.
+        database, one daily backup schedule and one weekly
+        backup schedule.
 
         Returns:
             Callable[[~.CreateBackupScheduleRequest],

google/cloud/firestore_admin_v1/services/firestore_admin/transports/grpc_asyncio.py

@@ -860,9 +860,8 @@ def create_backup_schedule(
 
         Creates a backup schedule on a database.
         At most two backup schedules can be configured on a
-        database, one daily backup schedule with retention up to
-        7 days and one weekly backup schedule with retention up
-        to 14 weeks.
+        database, one daily backup schedule and one weekly
+        backup schedule.
 
         Returns:
             Callable[[~.CreateBackupScheduleRequest],