Automated Spec Update (#421)

eec4b43685b7af842d320efaaa86db27232cb465

 Change Notes:

file_properties Namespace
- Update Comments

file_tagging Namespace
- Update Comments

files Namespace
- Update Metadata struct to include preview_url
- Update Comments

team_log_generated Namespace
- Add DropboxPasswordsPolicyChangedDetails, DropboxPasswordsPolicyChangedType structs
- Add DropboxPasswordsPolicy unions

Co-authored-by: DropboxBot <[email protected]>

dropbox/base.py

@@ -3054,8 +3054,9 @@ def files_tags_add(self,
                        path,
                        tag_text):
         """
-        Add a tag to an item. A tag is a string. No more than 20 tags can be
-        added to a given item.
+        Add a tag to an item. A tag is a string. The strings are automatically
+        converted to lowercase letters. No more than 20 tags can be added to a
+        given item.
 
         Route attributes:
             scope: files.metadata.write

dropbox/file_properties.py

@@ -532,8 +532,8 @@ class LookupError(bb.Union):
     :ivar file_properties.LookupError.not_folder: We were expecting a folder,
         but the given path refers to something that isn't a folder.
     :ivar file_properties.LookupError.restricted_content: The file cannot be
-        transferred because the content is restricted.  For example, sometimes
-        there are legal restrictions due to copyright claims.
+        transferred because the content is restricted. For example, we might
+        restrict a file due to legal requirements.
     """
 
     _catch_all = 'other'

dropbox/files.py

@@ -1533,13 +1533,15 @@ class Metadata(bb.Struct):
     :ivar files.Metadata.parent_shared_folder_id: Please use
         ``FileSharingInfo.parent_shared_folder_id`` or
         ``FolderSharingInfo.parent_shared_folder_id`` instead.
+    :ivar files.Metadata.preview_url: The preview URL of the file.
     """
 
     __slots__ = [
         '_name_value',
         '_path_lower_value',
         '_path_display_value',
         '_parent_shared_folder_id_value',
+        '_preview_url_value',
     ]
 
     _has_required_fields = True
@@ -1548,11 +1550,13 @@ def __init__(self,
                  name=None,
                  path_lower=None,
                  path_display=None,
-                 parent_shared_folder_id=None):
+                 parent_shared_folder_id=None,
+                 preview_url=None):
         self._name_value = bb.NOT_SET
         self._path_lower_value = bb.NOT_SET
         self._path_display_value = bb.NOT_SET
         self._parent_shared_folder_id_value = bb.NOT_SET
+        self._preview_url_value = bb.NOT_SET
         if name is not None:
             self.name = name
         if path_lower is not None:
@@ -1561,6 +1565,8 @@ def __init__(self,
             self.path_display = path_display
         if parent_shared_folder_id is not None:
             self.parent_shared_folder_id = parent_shared_folder_id
+        if preview_url is not None:
+            self.preview_url = preview_url
 
     # Instance attribute type: str (validator is set below)
     name = bb.Attribute("name")
@@ -1574,6 +1580,9 @@ def __init__(self,
     # Instance attribute type: str (validator is set below)
     parent_shared_folder_id = bb.Attribute("parent_shared_folder_id", nullable=True)
 
+    # Instance attribute type: str (validator is set below)
+    preview_url = bb.Attribute("preview_url", nullable=True)
+
     def _process_custom_annotations(self, annotation_type, field_path, processor):
         super(Metadata, self)._process_custom_annotations(annotation_type, field_path, processor)
 
@@ -1594,11 +1603,13 @@ def __init__(self,
                  name=None,
                  path_lower=None,
                  path_display=None,
-                 parent_shared_folder_id=None):
+                 parent_shared_folder_id=None,
+                 preview_url=None):
         super(DeletedMetadata, self).__init__(name,
                                               path_lower,
                                               path_display,
-                                              parent_shared_folder_id)
+                                              parent_shared_folder_id,
+                                              preview_url)
 
     def _process_custom_annotations(self, annotation_type, field_path, processor):
         super(DeletedMetadata, self)._process_custom_annotations(annotation_type, field_path, processor)
@@ -2489,6 +2500,7 @@ def __init__(self,
                  path_lower=None,
                  path_display=None,
                  parent_shared_folder_id=None,
+                 preview_url=None,
                  media_info=None,
                  symlink_info=None,
                  sharing_info=None,
@@ -2501,7 +2513,8 @@ def __init__(self,
         super(FileMetadata, self).__init__(name,
                                            path_lower,
                                            path_display,
-                                           parent_shared_folder_id)
+                                           parent_shared_folder_id,
+                                           preview_url)
         self._id_value = bb.NOT_SET
         self._client_modified_value = bb.NOT_SET
         self._server_modified_value = bb.NOT_SET
@@ -2732,13 +2745,15 @@ def __init__(self,
                  path_lower=None,
                  path_display=None,
                  parent_shared_folder_id=None,
+                 preview_url=None,
                  shared_folder_id=None,
                  sharing_info=None,
                  property_groups=None):
         super(FolderMetadata, self).__init__(name,
                                              path_lower,
                                              path_display,
-                                             parent_shared_folder_id)
+                                             parent_shared_folder_id,
+                                             preview_url)
         self._id_value = bb.NOT_SET
         self._shared_folder_id_value = bb.NOT_SET
         self._sharing_info_value = bb.NOT_SET
@@ -4662,8 +4677,8 @@ class LookupError(bb.Union):
     :ivar files.LookupError.not_folder: We were expecting a folder, but the
         given path refers to something that isn't a folder.
     :ivar files.LookupError.restricted_content: The file cannot be transferred
-        because the content is restricted.  For example, sometimes there are
-        legal restrictions due to copyright claims.
+        because the content is restricted. For example, we might restrict a file
+        due to legal requirements.
     :ivar files.LookupError.unsupported_content_type: This operation is not
         supported for this content type.
     :ivar files.LookupError.locked: The given path is locked.
@@ -11070,18 +11085,21 @@ def _process_custom_annotations(self, annotation_type, field_path, processor):
 Metadata.path_lower.validator = bv.Nullable(bv.String())
 Metadata.path_display.validator = bv.Nullable(bv.String())
 Metadata.parent_shared_folder_id.validator = bv.Nullable(common.SharedFolderId_validator)
+Metadata.preview_url.validator = bv.Nullable(bv.String())
 Metadata._field_names_ = set([
     'name',
     'path_lower',
     'path_display',
     'parent_shared_folder_id',
+    'preview_url',
 ])
 Metadata._all_field_names_ = Metadata._field_names_
 Metadata._fields_ = [
     ('name', Metadata.name.validator),
     ('path_lower', Metadata.path_lower.validator),
     ('path_display', Metadata.path_display.validator),
     ('parent_shared_folder_id', Metadata.parent_shared_folder_id.validator),
+    ('preview_url', Metadata.preview_url.validator),
 ]
 Metadata._all_fields_ = Metadata._fields_