René's URL Explorer Experiment


Title: docs(firestore): standardize use of 'required' and 'optional' in docstrings; add py2 deprecation warning; add 3.8 unit tests (via synth) by yoshi-automation · Pull Request #10068 · googleapis/google-cloud-python · GitHub

Open Graph Title: docs(firestore): standardize use of 'required' and 'optional' in docstrings; add py2 deprecation warning; add 3.8 unit tests (via synth) by yoshi-automation · Pull Request #10068 · googleapis/google-cloud-python

X Title: docs(firestore): standardize use of 'required' and 'optional' in docstrings; add py2 deprecation warning; add 3.8 unit tests (via synth) by yoshi-automation · Pull Request #10068 · googleapis/google-cloud-python

Description: Google Cloud Client Libraries for Python. Contribute to googleapis/google-cloud-python development by creating an account on GitHub.

Open Graph Description: This PR was generated using Autosynth. 🌈 Log from Synthtool synthtool > Executing /tmpfs/src/git/autosynth/working_repo/firestore/synth.py. synthtool > Ensuring dependencies. synthtool > P...

X Description: This PR was generated using Autosynth. 🌈 Log from Synthtool synthtool > Executing /tmpfs/src/git/autosynth/working_repo/firestore/synth.py. synthtool > Ensuring dependencies. synthtoo...

Opengraph URL: https://github.com/googleapis/google-cloud-python/pull/10068

X: @github

direct link

Domain: github.com

route-pattern/_view_fragments/voltron/pull_requests/show/:user_id/:repository/:id/pull_request_layout(.:format)
route-controllervoltron_pull_requests_fragments
route-actionpull_request_layout
fetch-noncev2:5452c1ac-7e82-a39e-a558-fb63611e2258
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idD7E2:16C3D3:64369FE:8CDEFDE:6A502CA8
html-safe-nonce145db2a558d2ad56667bda2da252abaca962990852103f946a51a4006fb4154d
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJEN0UyOjE2QzNEMzo2NDM2OUZFOjhDREVGREU6NkE1MDJDQTgiLCJ2aXNpdG9yX2lkIjoiNDI4OTUzMjMxMzAyMzI5NDYzMiIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9
visitor-hmac0c6f9f6e17af2700480f0a87ec2bbd5254103271e1abd00c48580e01e4188945
hovercard-subject-tagpull_request:360456089
github-keyboard-shortcutsrepository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///voltron/pull_requests_fragments/pull_request_layout
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/_view_fragments/voltron/pull_requests/show/googleapis/google-cloud-python/10068/pull_request_layout
twitter:imagehttps://opengraph.githubassets.com/0b672efb116862a1e50a6fc985edf8e0b8afb7ef1cd3ac90a588c78d18c23a15/googleapis/google-cloud-python/pull/10068
twitter:cardsummary_large_image
og:imagehttps://opengraph.githubassets.com/0b672efb116862a1e50a6fc985edf8e0b8afb7ef1cd3ac90a588c78d18c23a15/googleapis/google-cloud-python/pull/10068
og:image:altThis PR was generated using Autosynth. 🌈 Log from Synthtool synthtool > Executing /tmpfs/src/git/autosynth/working_repo/firestore/synth.py. synthtool > Ensuring dependencies. synthtool > P...
og:image:width1200
og:image:height600
og:site_nameGitHub
og:typeobject
og:author:usernameyoshi-automation
hostnamegithub.com
expected-hostnamegithub.com
Noned6dc8294eb500fa36bbc57472d61fe87c522f9c3c1d64f70f4926f66a66a7efb
turbo-cache-controlno-cache
go-importgithub.com/googleapis/google-cloud-python git https://github.com/googleapis/google-cloud-python.git
octolytics-dimension-user_id16785467
octolytics-dimension-user_logingoogleapis
octolytics-dimension-repository_id16316451
octolytics-dimension-repository_nwogoogleapis/google-cloud-python
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id16316451
octolytics-dimension-repository_network_root_nwogoogleapis/google-cloud-python
turbo-body-classeslogged-out env-production page-responsive
disable-turbofalse
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
released90666eaf032b7eb8975a378efe38e37f4ebb96c
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/googleapis/google-cloud-python/pull/10068#start-of-content
https://github.com/
Sign in https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fgoogleapis%2Fgoogle-cloud-python%2Fpull%2F10068
GitHub CopilotWrite better code with AIhttps://github.com/features/copilot
GitHub Copilot appDirect agents from issue to mergehttps://github.com/features/ai/github-app
MCP RegistryNewIntegrate external toolshttps://github.com/mcp
ActionsAutomate any workflowhttps://github.com/features/actions
CodespacesInstant dev environmentshttps://github.com/features/codespaces
IssuesPlan and track workhttps://github.com/features/issues
Code ReviewManage code changeshttps://github.com/features/code-review
GitHub Advanced SecurityFind and fix vulnerabilitieshttps://github.com/security/advanced-security
Code securitySecure your code as you buildhttps://github.com/security/advanced-security/code-security
Secret protectionStop leaks before they starthttps://github.com/security/advanced-security/secret-protection
Why GitHubhttps://github.com/why-github
Documentationhttps://docs.github.com
Bloghttps://github.blog
Changeloghttps://github.blog/changelog
Marketplacehttps://github.com/marketplace
View all featureshttps://github.com/features
Enterpriseshttps://github.com/enterprise
Small and medium teamshttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
App Modernizationhttps://github.com/solutions/use-case/app-modernization
DevSecOpshttps://github.com/solutions/use-case/devsecops
DevOpshttps://github.com/solutions/use-case/devops
CI/CDhttps://github.com/solutions/use-case/ci-cd
View all use caseshttps://github.com/solutions/use-case
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
View all industrieshttps://github.com/solutions/industry
View all solutionshttps://github.com/solutions
AIhttps://github.com/resources/articles?topic=ai
Software Developmenthttps://github.com/resources/articles?topic=software-development
DevOpshttps://github.com/resources/articles?topic=devops
Securityhttps://github.com/resources/articles?topic=security
View all topicshttps://github.com/resources/articles
Customer storieshttps://github.com/customer-stories
Events & webinarshttps://github.com/resources/events
Ebooks & reportshttps://github.com/resources/whitepapers
Business insightshttps://github.com/solutions/executive-insights
GitHub Skillshttps://skills.github.com
Documentationhttps://docs.github.com
Customer supporthttps://support.github.com
Community forumhttps://github.com/orgs/community/discussions
Trust centerhttps://github.com/trust-center
Partnershttps://github.com/partners
View all resourceshttps://github.com/resources
GitHub SponsorsFund open source developershttps://github.com/open-source/sponsors
Security Labhttps://securitylab.github.com
Maintainer Communityhttps://maintainers.github.com
Acceleratorhttps://github.com/open-source/accelerator
GitHub Starshttps://stars.github.com
Archive Programhttps://archiveprogram.github.com
Topicshttps://github.com/topics
Trendinghttps://github.com/trending
Collectionshttps://github.com/collections
Enterprise platformAI-powered developer platformhttps://github.com/enterprise
GitHub Advanced SecurityEnterprise-grade security featureshttps://github.com/security/advanced-security
Copilot for BusinessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Pricinghttps://github.com/pricing
Search syntax tipshttps://docs.github.com/search-github/github-code-search/understanding-github-code-search-syntax
documentationhttps://docs.github.com/search-github/github-code-search/understanding-github-code-search-syntax
Sign in https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fgoogleapis%2Fgoogle-cloud-python%2Fpull%2F10068
Sign up https://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fvoltron%2Fpull_requests_fragments%2Fpull_request_layout&source=header-repo&source_repo=googleapis%2Fgoogle-cloud-python
Reloadhttps://github.com/googleapis/google-cloud-python/pull/10068
Reloadhttps://github.com/googleapis/google-cloud-python/pull/10068
Reloadhttps://github.com/googleapis/google-cloud-python/pull/10068
Please reload this pagehttps://github.com/googleapis/google-cloud-python/pull/10068
googleapis https://github.com/googleapis
google-cloud-pythonhttps://github.com/googleapis/google-cloud-python
Notifications https://github.com/login?return_to=%2Fgoogleapis%2Fgoogle-cloud-python
Fork 1.7k https://github.com/login?return_to=%2Fgoogleapis%2Fgoogle-cloud-python
Star 5.3k https://github.com/login?return_to=%2Fgoogleapis%2Fgoogle-cloud-python
Code https://github.com/googleapis/google-cloud-python
Issues 444 https://github.com/googleapis/google-cloud-python/issues
Pull requests 137 https://github.com/googleapis/google-cloud-python/pulls
Discussions https://github.com/googleapis/google-cloud-python/discussions
Actions https://github.com/googleapis/google-cloud-python/actions
Projects https://github.com/googleapis/google-cloud-python/projects
Security and quality 0 https://github.com/googleapis/google-cloud-python/security
Insights https://github.com/googleapis/google-cloud-python/pulse
Code https://github.com/googleapis/google-cloud-python
Issues https://github.com/googleapis/google-cloud-python/issues
Pull requests https://github.com/googleapis/google-cloud-python/pulls
Discussions https://github.com/googleapis/google-cloud-python/discussions
Actions https://github.com/googleapis/google-cloud-python/actions
Projects https://github.com/googleapis/google-cloud-python/projects
Security and quality https://github.com/googleapis/google-cloud-python/security
Insights https://github.com/googleapis/google-cloud-python/pulse
busunkim96https://github.com/busunkim96
masterhttps://github.com/googleapis/google-cloud-python/tree/master
autosynth-firestorehttps://github.com/googleapis/google-cloud-python/tree/autosynth-firestore
Conversationhttps://github.com/googleapis/google-cloud-python/pull/10068
Commits1 (1)https://github.com/googleapis/google-cloud-python/pull/10068/commits
Checkshttps://github.com/googleapis/google-cloud-python/pull/10068/checks
Files changedhttps://github.com/googleapis/google-cloud-python/pull/10068/files
docs(firestore): standardize use of 'required' and 'optional' in docstrings; add py2 deprecation warning; add 3.8 unit tests (via synth)https://github.com/googleapis/google-cloud-python/pull/10068#top
busunkim96https://github.com/busunkim96
masterhttps://github.com/googleapis/google-cloud-python/tree/master
autosynth-firestorehttps://github.com/googleapis/google-cloud-python/tree/autosynth-firestore
https://github.com/yoshi-automation
yoshi-automationhttps://github.com/yoshi-automation
Jan 8, 2020https://github.com/googleapis/google-cloud-python/pull/10068#issue-546857263
Please reload this pagehttps://github.com/googleapis/google-cloud-python/pull/10068
https://github.com/yoshi-automation
[CHANGE ME] Re-generated firestore to pick up changes in the API or c…https://github.com/googleapis/google-cloud-python/pull/10068/commits/fd67fbd81c372f6c4675c8fa65518c03c1ce0330
fd67fbdhttps://github.com/googleapis/google-cloud-python/pull/10068/commits/fd67fbd81c372f6c4675c8fa65518c03c1ce0330
https://github.com/yoshi-automation
yoshi-automationhttps://github.com/yoshi-automation
crwilcoxhttps://github.com/crwilcox
frankynhttps://github.com/frankyn
tseaverhttps://github.com/tseaver
code ownershttps://github.com/googleapis/google-cloud-python/blob/21e4ff30e0296b04d1bcfdcb86beaa018e7f7fa9/.github/CODEOWNERS#L20
January 8, 2020 13:21https://github.com/googleapis/google-cloud-python/pull/10068#event-2931127947
https://github.com/yoshi-automation
yoshi-automationhttps://github.com/yoshi-automation
api: firestore https://github.com/googleapis/google-cloud-python/issues?q=state%3Aopen%20label%3A%22api%3A%20firestore%22
Jan 8, 2020https://github.com/googleapis/google-cloud-python/pull/10068#event-2931128052
https://github.com/googlebot
googlebothttps://github.com/googlebot
cla: yes https://github.com/googleapis/google-cloud-python/issues?q=state%3Aopen%20label%3A%22cla%3A%20yes%22
Jan 8, 2020https://github.com/googleapis/google-cloud-python/pull/10068#event-2931128143
https://github.com/busunkim96
busunkim96https://github.com/busunkim96
Jan 30, 2020https://github.com/googleapis/google-cloud-python/pull/10068#event-2991639716
https://github.com/busunkim96
busunkim96https://github.com/busunkim96
Jan 30, 2020 https://github.com/googleapis/google-cloud-python/pull/10068#pullrequestreview-350527931
View reviewed changes https://github.com/googleapis/google-cloud-python/pull/10068/files/fd67fbd81c372f6c4675c8fa65518c03c1ce0330
https://github.com/busunkim96
busunkim96https://github.com/busunkim96
4d90329https://github.com/googleapis/google-cloud-python/commit/4d9032997a425aac3370f5c08d0c4ffd4e26cb74
Jan 30, 2020https://github.com/googleapis/google-cloud-python/pull/10068#event-2991640612
chore(automl): change line breaks in docstrings (via synth) #10252 https://github.com/googleapis/google-cloud-python/pull/10252
chore(bigquerydatatransfer): change line breaks in docstrings (via synth) #10253 https://github.com/googleapis/google-cloud-python/pull/10253
chore(bigtable): bump copyright year to 2020; change formatting of docstrings (via synth) #10254 https://github.com/googleapis/google-cloud-python/pull/10254
chore(cloudbuild): bump copyright year to 2020; change docstring formatting (via synth) #10255 https://github.com/googleapis/google-cloud-python/pull/10255
[CHANGE ME] Re-generated container to pick up changes in the API or client library generator. #10256 https://github.com/googleapis/google-cloud-python/pull/10256
chore(containeranalysis): bump copyright year to 2020 (via synth) #10257 https://github.com/googleapis/google-cloud-python/pull/10257
chore(datacatalog): change docstring line breaks (via synth) #10258 https://github.com/googleapis/google-cloud-python/pull/10258
chore(datalabeling): change docstring line breaks (via synth) #10259 https://github.com/googleapis/google-cloud-python/pull/10259
chore(dataproc): bump copyright year to 2020; change docstring line breaks (via synth) #10260 https://github.com/googleapis/google-cloud-python/pull/10260
[CHANGE ME] Re-generated datastore to pick up changes in the API or client library generator. #10261 https://github.com/googleapis/google-cloud-python/pull/10261
chore(dlp): bump copyright year to 2020; change line breaks in docstrings (via synth) #10262 https://github.com/googleapis/google-cloud-python/pull/10262
chore(documentai): change line breaks in docstring (via synth) #10263 https://github.com/googleapis/google-cloud-python/pull/10263
chore(grafeas): bump copyright year to 2020; change docstring line breaks (via synth) #10265 https://github.com/googleapis/google-cloud-python/pull/10265
chore(irm): change docstring line breaks (via synth) #10266 https://github.com/googleapis/google-cloud-python/pull/10266
chore(kms): bump copyright year to 2020; change docstring line breaks (via synth) #10267 https://github.com/googleapis/google-cloud-python/pull/10267
chore(speech): change docstring line breaks (via synth) #10270 https://github.com/googleapis/google-cloud-python/pull/10270
fix(tasks): change default timeout values; bump copyright year to 2020; change line breaks in docstrings (via synth) #10271 https://github.com/googleapis/google-cloud-python/pull/10271
chore(texttospeech): change docstring line breaks (via synth) #10272 https://github.com/googleapis/google-cloud-python/pull/10272
chore(trace): change docstring line breaks (via synth) #10273 https://github.com/googleapis/google-cloud-python/pull/10273
chore(vision): change docstring line breaks (via synth) #10275 https://github.com/googleapis/google-cloud-python/pull/10275
chore(websecurityscanner): change line breaks in docstrings (via synth) #10277 https://github.com/googleapis/google-cloud-python/pull/10277
[CHANGE ME] Re-generated billingbudgets to pick up changes in the API or client library generator. #10288 https://github.com/googleapis/google-cloud-python/pull/10288
[CHANGE ME] Re-generated iot to pick up changes in the API or client library generator. #10293 https://github.com/googleapis/google-cloud-python/pull/10293
[CHANGE ME] Re-generated language to pick up changes in the API or client library generator. #10294 https://github.com/googleapis/google-cloud-python/pull/10294
[CHANGE ME] Re-generated phishingprotection to pick up changes in the API or client library generator. #10297 https://github.com/googleapis/google-cloud-python/pull/10297
[CHANGE ME] Re-generated redis to pick up changes in the API or client library generator. #10319 https://github.com/googleapis/google-cloud-python/pull/10319
[CHANGE ME] Re-generated language to pick up changes in the API or client library generator. #10332 https://github.com/googleapis/google-cloud-python/pull/10332
[CHANGE ME] Re-generated phishingprotection to pick up changes in the API or client library generator. #10335 https://github.com/googleapis/google-cloud-python/pull/10335
[CHANGE ME] Re-generated iot to pick up changes in the API or client library generator. #10341 https://github.com/googleapis/google-cloud-python/pull/10341
[CHANGE ME] Re-generated language to pick up changes in the API or client library generator. #10344 https://github.com/googleapis/google-cloud-python/pull/10344
[CHANGE ME] Re-generated phishingprotection to pick up changes in the API or client library generator. #10353 https://github.com/googleapis/google-cloud-python/pull/10353
[CHANGE ME] Re-generated asset to pick up changes in the API or client library generator. #10359 https://github.com/googleapis/google-cloud-python/pull/10359
[CHANGE ME] Re-generated language to pick up changes in the API or client library generator. #10361 https://github.com/googleapis/google-cloud-python/pull/10361
[CHANGE ME] Re-generated recommender to pick up changes in the API or client library generator. #10363 https://github.com/googleapis/google-cloud-python/pull/10363
partheahttps://github.com/parthea
Nov 24, 2025 https://github.com/googleapis/google-cloud-python/pull/10068#ref-commit-0bfb527
https://github.com/yoshi-automation
docs(firestore): standardize use of 'required' and 'optional' in docs…https://github.com/googleapis/google-cloud-python/commit/0bfb5271debef07fffc3a87a154ea4f23e9b9e7c
0bfb527https://github.com/googleapis/google-cloud-python/commit/0bfb5271debef07fffc3a87a154ea4f23e9b9e7c
#10068https://github.com/googleapis/google-cloud-python/pull/10068
https://github.co/hiddenchars
https://github.com/googleapis/google-cloud-python/pull/{{ revealButtonHref }}
Sign up for freehttps://github.com/join?source=comment-repo
Sign in to commenthttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fgoogleapis%2Fgoogle-cloud-python%2Fpull%2F10068
https://github.com/crwilcox
crwilcox https://github.com/crwilcox
https://github.com/frankyn
frankyn https://github.com/frankyn
https://github.com/tseaver
tseaver https://github.com/tseaver
https://github.com/busunkim96
busunkim96 https://github.com/busunkim96
https://github.com/googleapis/google-cloud-python/pull/10068/files/fd67fbd81c372f6c4675c8fa65518c03c1ce0330
api: firestore https://github.com/googleapis/google-cloud-python/issues?q=state%3Aopen%20label%3A%22api%3A%20firestore%22
cla: yes https://github.com/googleapis/google-cloud-python/issues?q=state%3Aopen%20label%3A%22cla%3A%20yes%22
Please reload this pagehttps://github.com/googleapis/google-cloud-python/pull/10068
https://github.com/yoshi-automation
https://github.com/busunkim96
https://github.com/googlebot
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width

URLs of crawlers that visited me.