updated spec

Author: rob

dropbox/async.py

@@ -1,5 +1,6 @@
 # -*- coding: utf-8 -*-
 # Auto-generated by Stone, do not modify.
+# @generated
 # flake8: noqa
 # pylint: skip-file
 try:

dropbox/auth.py

@@ -1,5 +1,6 @@
 # -*- coding: utf-8 -*-
 # Auto-generated by Stone, do not modify.
+# @generated
 # flake8: noqa
 # pylint: skip-file
 try:

dropbox/base.py

@@ -139,8 +139,8 @@ def file_properties_properties_remove(self,
                                           path,
                                           property_template_ids):
         """
-        Remove the specified property group from the file. To remove specific
-        property field key value pairs, see
+        Permanently removes the specified property group from the file. To
+        remove specific property field key value pairs, see
         :meth:`file_properties_properties_update`. To update a template, see
         :meth:`file_properties_templates_update_for_user` or
         :meth:`file_properties_templates_update_for_team`. Templates can't be
@@ -192,6 +192,31 @@ def file_properties_properties_search(self,
         )
         return r
 
+    def file_properties_properties_search_continue(self,
+                                                   cursor):
+        """
+        Once a cursor has been retrieved from
+        :meth:`file_properties_properties_search`, use this to paginate through
+        all search results.
+
+        :param str cursor: The cursor returned by your last call to
+            :meth:`file_properties_properties_search` or
+            :meth:`file_properties_properties_search_continue`.
+        :rtype: :class:`dropbox.file_properties.PropertiesSearchResult`
+        :raises: :class:`dropbox.exceptions.ApiError`
+
+        If this raises, ApiError.reason is of type:
+            :class:`dropbox.file_properties.PropertiesSearchContinueError`
+        """
+        arg = file_properties.PropertiesSearchContinueArg(cursor)
+        r = self.request(
+            file_properties.properties_search_continue,
+            'file_properties',
+            arg,
+            None,
+        )
+        return r
+
     def file_properties_properties_update(self,
                                           path,
                                           update_property_groups):
@@ -230,7 +255,7 @@ def file_properties_templates_add_for_team(self,
         """
         Add a template associated with a team. See
         :meth:`file_properties_properties_add` to add properties to a file or
-        folder.
+        folder. Note: this endpoint will create team-owned templates.
 
         :rtype: :class:`dropbox.file_properties.AddTemplateResult`
         :raises: :class:`dropbox.exceptions.ApiError`
@@ -363,6 +388,58 @@ def file_properties_templates_list_for_user(self):
         )
         return r
 
+    def file_properties_templates_remove_for_team(self,
+                                                  template_id):
+        """
+        Permanently removes the specified template created from
+        :meth:`file_properties_templates_add_for_user`. All properties
+        associated with the template will also be removed. This action cannot be
+        undone.
+
+        :param str template_id: An identifier for a template created by
+            :meth:`file_properties_templates_add_for_user` or
+            :meth:`file_properties_templates_add_for_team`.
+        :rtype: None
+        :raises: :class:`dropbox.exceptions.ApiError`
+
+        If this raises, ApiError.reason is of type:
+            :class:`dropbox.file_properties.TemplateError`
+        """
+        arg = file_properties.RemoveTemplateArg(template_id)
+        r = self.request(
+            file_properties.templates_remove_for_team,
+            'file_properties',
+            arg,
+            None,
+        )
+        return None
+
+    def file_properties_templates_remove_for_user(self,
+                                                  template_id):
+        """
+        Permanently removes the specified template created from
+        :meth:`file_properties_templates_add_for_user`. All properties
+        associated with the template will also be removed. This action cannot be
+        undone.
+
+        :param str template_id: An identifier for a template created by
+            :meth:`file_properties_templates_add_for_user` or
+            :meth:`file_properties_templates_add_for_team`.
+        :rtype: None
+        :raises: :class:`dropbox.exceptions.ApiError`
+
+        If this raises, ApiError.reason is of type:
+            :class:`dropbox.file_properties.TemplateError`
+        """
+        arg = file_properties.RemoveTemplateArg(template_id)
+        r = self.request(
+            file_properties.templates_remove_for_user,
+            'file_properties',
+            arg,
+            None,
+        )
+        return None
+
     def file_properties_templates_update_for_team(self,
                                                   template_id,
                                                   name=None,
@@ -554,6 +631,7 @@ def files_alpha_get_metadata(self,
                                  include_media_info=False,
                                  include_deleted=False,
                                  include_has_explicit_shared_members=False,
+                                 include_property_groups=None,
                                  include_property_templates=None):
         """
         Returns the metadata for a file or folder. This is an alpha endpoint
@@ -569,10 +647,15 @@ def files_alpha_get_metadata(self,
         If this raises, ApiError.reason is of type:
             :class:`dropbox.files.AlphaGetMetadataError`
         """
+        warnings.warn(
+            'alpha/get_metadata is deprecated. Use get_metadata.',
+            DeprecationWarning,
+        )
         arg = files.AlphaGetMetadataArg(path,
                                         include_media_info,
                                         include_deleted,
                                         include_has_explicit_shared_members,
+                                        include_property_groups,
                                         include_property_templates)
         r = self.request(
             files.alpha_get_metadata,
@@ -598,14 +681,16 @@ def files_alpha_upload(self,
         :meth:`files_upload_session_start`.
 
         :param bytes f: Contents to upload.
-        :param Nullable property_groups: List of custom properties to add to
-            file.
         :rtype: :class:`dropbox.files.FileMetadata`
         :raises: :class:`dropbox.exceptions.ApiError`
 
         If this raises, ApiError.reason is of type:
             :class:`dropbox.files.UploadErrorWithProperties`
         """
+        warnings.warn(
+            'alpha/upload is deprecated. Use alpha/upload.',
+            DeprecationWarning,
+        )
         arg = files.CommitInfoWithProperties(path,
                                              mode,
                                              autorename,
@@ -1032,7 +1117,8 @@ def files_get_metadata(self,
                            path,
                            include_media_info=False,
                            include_deleted=False,
-                           include_has_explicit_shared_members=False):
+                           include_has_explicit_shared_members=False,
+                           include_property_groups=None):
         """
         Returns the metadata for a file or folder. Note: Metadata for the root
         folder is unsupported.
@@ -1047,6 +1133,10 @@ def files_get_metadata(self,
         :param bool include_has_explicit_shared_members: If true, the results
             will include a flag for each file indicating whether or not  that
             file has any explicit members.
+        :param Nullable include_property_groups: If set to a valid list of
+            template IDs, ``FileMetadata.property_groups`` is set if there
+            exists property data associated with the file and each of the listed
+            templates.
         :rtype: :class:`dropbox.files.Metadata`
         :raises: :class:`dropbox.exceptions.ApiError`
 
@@ -1056,7 +1146,8 @@ def files_get_metadata(self,
         arg = files.GetMetadataArg(path,
                                    include_media_info,
                                    include_deleted,
-                                   include_has_explicit_shared_members)
+                                   include_has_explicit_shared_members,
+                                   include_property_groups)
         r = self.request(
             files.get_metadata,
             'files',
@@ -1266,7 +1357,8 @@ def files_list_folder(self,
                           include_has_explicit_shared_members=False,
                           include_mounted_folders=True,
                           limit=None,
-                          shared_link=None):
+                          shared_link=None,
+                          include_property_groups=None):
         """
         Starts returning the contents of a folder. If the result's
         ``ListFolderResult.has_more`` field is ``True``, call
@@ -1315,6 +1407,10 @@ def files_list_folder(self,
             this field is present, ``ListFolderArg.path`` will be relative to
             root of the shared link. Only non-recursive mode is supported for
             shared link.
+        :param Nullable include_property_groups: If set to a valid list of
+            template IDs, ``FileMetadata.property_groups`` is set if there
+            exists property data associated with the file and each of the listed
+            templates.
         :rtype: :class:`dropbox.files.ListFolderResult`
         :raises: :class:`dropbox.exceptions.ApiError`
 
@@ -1328,7 +1424,8 @@ def files_list_folder(self,
                                   include_has_explicit_shared_members,
                                   include_mounted_folders,
                                   limit,
-                                  shared_link)
+                                  shared_link,
+                                  include_property_groups)
         r = self.request(
             files.list_folder,
             'files',
@@ -1369,7 +1466,8 @@ def files_list_folder_get_latest_cursor(self,
                                             include_has_explicit_shared_members=False,
                                             include_mounted_folders=True,
                                             limit=None,
-                                            shared_link=None):
+                                            shared_link=None,
+                                            include_property_groups=None):
         """
         A way to quickly get a cursor for the folder's state. Unlike
         :meth:`files_list_folder`, :meth:`files_list_folder_get_latest_cursor`
@@ -1399,6 +1497,10 @@ def files_list_folder_get_latest_cursor(self,
             this field is present, ``ListFolderArg.path`` will be relative to
             root of the shared link. Only non-recursive mode is supported for
             shared link.
+        :param Nullable include_property_groups: If set to a valid list of
+            template IDs, ``FileMetadata.property_groups`` is set if there
+            exists property data associated with the file and each of the listed
+            templates.
         :rtype: :class:`dropbox.files.ListFolderGetLatestCursorResult`
         :raises: :class:`dropbox.exceptions.ApiError`
 
@@ -1412,7 +1514,8 @@ def files_list_folder_get_latest_cursor(self,
                                   include_has_explicit_shared_members,
                                   include_mounted_folders,
                                   limit,
-                                  shared_link)
+                                  shared_link,
+                                  include_property_groups)
         r = self.request(
             files.list_folder_get_latest_cursor,
             'files',
@@ -1928,7 +2031,8 @@ def files_upload(self,
                      mode=files.WriteMode.add,
                      autorename=False,
                      client_modified=None,
-                     mute=False):
+                     mute=False,
+                     property_groups=None):
         """
         Create a new file with the contents provided in the request. Do not use
         this to upload a file larger than 150 MB. Instead, create an upload
@@ -1951,6 +2055,8 @@ def files_upload(self,
             modifications in their Dropbox account via notifications in the
             client software. If ``True``, this tells the clients that this
             modification shouldn't result in a user notification.
+        :param Nullable property_groups: List of custom properties to add to
+            file.
         :rtype: :class:`dropbox.files.FileMetadata`
         :raises: :class:`dropbox.exceptions.ApiError`
 
@@ -1961,7 +2067,8 @@ def files_upload(self,
                                mode,
                                autorename,
                                client_modified,
-                               mute)
+                               mute,
+                               property_groups)
         r = self.request(
             files.upload,
             'files',

dropbox/base_team.py

@@ -681,6 +681,91 @@ def team_linked_apps_revoke_linked_app_batch(self,
         )
         return r
 
+    def team_member_space_limits_excluded_users_add(self,
+                                                    users=None):
+        """
+        Add users to member space limits excluded users list.
+
+        :param Nullable users: List of users to be added/removed.
+        :rtype: :class:`dropbox.team.ExcludedUsersUpdateResult`
+        :raises: :class:`dropbox.exceptions.ApiError`
+
+        If this raises, ApiError.reason is of type:
+            :class:`dropbox.team.ExcludedUsersUpdateError`
+        """
+        arg = team.ExcludedUsersUpdateArg(users)
+        r = self.request(
+            team.member_space_limits_excluded_users_add,
+            'team',
+            arg,
+            None,
+        )
+        return r
+
+    def team_member_space_limits_excluded_users_list(self,
+                                                     limit=1000):
+        """
+        List member space limits excluded users.
+
+        :param long limit: Number of results to return per call.
+        :rtype: :class:`dropbox.team.ExcludedUsersListResult`
+        :raises: :class:`dropbox.exceptions.ApiError`
+
+        If this raises, ApiError.reason is of type:
+            :class:`dropbox.team.ExcludedUsersListError`
+        """
+        arg = team.ExcludedUsersListArg(limit)
+        r = self.request(
+            team.member_space_limits_excluded_users_list,
+            'team',
+            arg,
+            None,
+        )
+        return r
+
+    def team_member_space_limits_excluded_users_list_continue(self,
+                                                              cursor):
+        """
+        Continue listing member space limits excluded users.
+
+        :param str cursor: Indicates from what point to get the next set of
+            users.
+        :rtype: :class:`dropbox.team.ExcludedUsersListResult`
+        :raises: :class:`dropbox.exceptions.ApiError`
+
+        If this raises, ApiError.reason is of type:
+            :class:`dropbox.team.ExcludedUsersListContinueError`
+        """
+        arg = team.ExcludedUsersListContinueArg(cursor)
+        r = self.request(
+            team.member_space_limits_excluded_users_list_continue,
+            'team',
+            arg,
+            None,
+        )
+        return r
+
+    def team_member_space_limits_excluded_users_remove(self,
+                                                       users=None):
+        """
+        Remove users from member space limits excluded users list.
+
+        :param Nullable users: List of users to be added/removed.
+        :rtype: :class:`dropbox.team.ExcludedUsersUpdateResult`
+        :raises: :class:`dropbox.exceptions.ApiError`
+
+        If this raises, ApiError.reason is of type:
+            :class:`dropbox.team.ExcludedUsersUpdateError`
+        """
+        arg = team.ExcludedUsersUpdateArg(users)
+        r = self.request(
+            team.member_space_limits_excluded_users_remove,
+            'team',
+            arg,
+            None,
+        )
+        return r
+
     def team_member_space_limits_get_custom_quota(self,
                                                   users):
         """
@@ -728,15 +813,15 @@ def team_member_space_limits_remove_custom_quota(self,
     def team_member_space_limits_set_custom_quota(self,
                                                   users_and_quotas):
         """
-        Set users custom quota. Custom quota has to be at least 25GB. A maximum
+        Set users custom quota. Custom quota has to be at least 15GB. A maximum
         of 1000 members can be specified in a single call.
 
         :param list users_and_quotas: List of users and their custom quotas.
         :rtype: list
         :raises: :class:`dropbox.exceptions.ApiError`
 
         If this raises, ApiError.reason is of type:
-            :class:`dropbox.team.CustomQuotaError`
+            :class:`dropbox.team.SetCustomQuotaError`
         """
         arg = team.SetCustomQuotaArg(users_and_quotas)
         r = self.request(