Added notes about disabling expiration date and password on public resources

Author: ivknv

docs/locales/ru/LC_MESSAGES/api_reference.po

@@ -5,10 +5,10 @@
 #
 msgid ""
 msgstr ""
-"Project-Id-Version: YaDisk 3.3.0\n"
+"Project-Id-Version: YaDisk 3.4.0\n"
 "Report-Msgid-Bugs-To: [email protected]\n"
-"POT-Creation-Date: 2025-07-09 19:35+0500\n"
-"PO-Revision-Date: 2025-02-03 19:21+0500\n"
+"POT-Creation-Date: 2025-07-10 18:15+0500\n"
+"PO-Revision-Date: 2025-07-10 18:19+0500\n"
 "Last-Translator: Ivan Konovalov <[email protected]>\n"
 "Language-Team: Russian\n"
 "MIME-Version: 1.0\n"
@@ -6915,6 +6915,18 @@ msgstr ""
 msgid "`List[PublicSettingsAccess]`, list of access settings"
 msgstr "`List[PublicSettingsAccess]`, список настроек доступа"
 
+#: of yadisk.types.PublicSettings:17
+msgid ""
+"It appears that passing :code:`available_until` as an empty string "
+"disables the expiration date. Similarly, password can be disabled by "
+"passing :code:`False` or :code:`0`. This is not officially documented, "
+"though."
+msgstr ""
+"Как показывает практика, передача пустой строки в поле "
+":code:`available_until` отключает дату истечения доступа. Аналогично, "
+"пароль можно отключить, передав :code:`False` или :code:`0`. Но подобное "
+"поведение не задокументировано."
+
 #: of yadisk.types.PublicSettingsAccess:7
 msgid "`List[str]`, list of user IDs"
 msgstr "`List[str]`, список идентификаторов пользователей"

src/yadisk/types.py

@@ -281,12 +281,19 @@ class PublicSettings(TypedDict, total=False):
         :ivar external_organization_id_verbose: :any:`ExternalOrganizationIdVerbose`,
             verbose information about the external organization ID
         :ivar accesses: `List[PublicSettingsAccess]`, list of access settings
+
+        .. note::
+
+           It appears that passing :code:`available_until` as an empty string
+           disables the expiration date. Similarly, password can be disabled
+           by passing :code:`False` or :code:`0`. This is not officially
+           documented, though.
     """
 
-    available_until: int
+    available_until: Union[int, str]
     read_only: bool
     available_until_verbose: "AvailableUntilVerbose"
-    password: str
+    password: Union[str, Literal[False, 0]]
     password_verbose: "PasswordVerbose"
     external_organization_id: str
     external_organization_id_verbose: "ExternalOrganizationIdVerbose"