Automated Spec Update (dropbox#324)

822caa80810d2248730a0c6c61309d45f0063f29

 Change Notes:

Files Namespace:
- Add paper/create, paper/update routes
- Add PaperCreateArg, PaperCreateResult, PaperCreateArg, PaperCreateResult, PaperUpdateArg, PaperUpdateResult structs
- Add ImportFormat, PaperContentError, PaperCreateError, PaperDocUpdatePolicy, PaperUpdateError unions
- Update Comments

Team Log Generated Namespace:
- Add GovernancePolicyContentDisposedDetails, GovernancePolicyContentDisposedType structs
- Add DispositionActionType union
- Update ClassificationType union to include pii
- Update EventDetails union to include governance_policy_content_disposed_details
- Update EventType union to include governance_policy_content_disposed
- Update EventTypeArg uniont to include governance_policy_content_disposed
- Update Comments

Team Reports Namespace:
- Deprecate reports/get_storage, reports/get_activity, reports/get_membership, reports/get_devices routes

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

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

Author: DropboxBot

dropbox/base.py

@@ -2335,6 +2335,73 @@ def files_move_batch_check(self,
         )
         return r
 
+    def files_paper_create(self,
+                           f,
+                           path,
+                           import_format):
+        """
+        Creates a new Paper doc with the provided content.
+
+        :param bytes f: Contents to upload.
+        :param str path: The fully qualified path to the location in the user's
+            Dropbox where the Paper Doc should be created. This should include
+            the document's title and end with .paper.
+        :param import_format: The format of the provided data.
+        :type import_format: :class:`dropbox.files.ImportFormat`
+        :rtype: :class:`dropbox.files.PaperCreateResult`
+        :raises: :class:`.exceptions.ApiError`
+
+        If this raises, ApiError will contain:
+            :class:`dropbox.files.PaperCreateError`
+        """
+        arg = files.PaperCreateArg(path,
+                                   import_format)
+        r = self.request(
+            files.paper_create,
+            'files',
+            arg,
+            f,
+        )
+        return r
+
+    def files_paper_update(self,
+                           f,
+                           path,
+                           import_format,
+                           doc_update_policy,
+                           paper_revision=None):
+        """
+        Updates an existing Paper doc with the provided content.
+
+        :param bytes f: Contents to upload.
+        :param str path: Path in the user's Dropbox to update. The path must
+            correspond to a Paper doc or an error will be returned.
+        :param import_format: The format of the provided data.
+        :type import_format: :class:`dropbox.files.ImportFormat`
+        :param doc_update_policy: How the provided content should be applied to
+            the doc.
+        :type doc_update_policy: :class:`dropbox.files.PaperDocUpdatePolicy`
+        :param Nullable[int] paper_revision: The latest doc revision. Required
+            when doc_update_policy is update. This value must match the current
+            revision of the doc or error revision_mismatch will be returned.
+        :rtype: :class:`dropbox.files.PaperUpdateResult`
+        :raises: :class:`.exceptions.ApiError`
+
+        If this raises, ApiError will contain:
+            :class:`dropbox.files.PaperUpdateError`
+        """
+        arg = files.PaperUpdateArg(path,
+                                   import_format,
+                                   doc_update_policy,
+                                   paper_revision)
+        r = self.request(
+            files.paper_update,
+            'files',
+            arg,
+            f,
+        )
+        return r
+
     def files_permanently_delete(self,
                                  path,
                                  parent_rev=None):

dropbox/base_team.py

@@ -1927,7 +1927,8 @@ def team_reports_get_activity(self,
                                   start_date=None,
                                   end_date=None):
         """
-        Retrieves reporting data about a team's user activity.
+        Retrieves reporting data about a team's user activity. Deprecated: Will
+        be removed on July 1st 2021.
 
         :param Nullable[datetime] start_date: Optional starting date
             (inclusive). If start_date is None or too long ago, this field will
@@ -1957,7 +1958,8 @@ def team_reports_get_devices(self,
                                  start_date=None,
                                  end_date=None):
         """
-        Retrieves reporting data about a team's linked devices.
+        Retrieves reporting data about a team's linked devices. Deprecated: Will
+        be removed on July 1st 2021.
 
         :param Nullable[datetime] start_date: Optional starting date
             (inclusive). If start_date is None or too long ago, this field will
@@ -1987,7 +1989,8 @@ def team_reports_get_membership(self,
                                     start_date=None,
                                     end_date=None):
         """
-        Retrieves reporting data about a team's membership.
+        Retrieves reporting data about a team's membership. Deprecated: Will be
+        removed on July 1st 2021.
 
         :param Nullable[datetime] start_date: Optional starting date
             (inclusive). If start_date is None or too long ago, this field will
@@ -2017,7 +2020,8 @@ def team_reports_get_storage(self,
                                  start_date=None,
                                  end_date=None):
         """
-        Retrieves reporting data about a team's storage usage.
+        Retrieves reporting data about a team's storage usage. Deprecated: Will
+        be removed on July 1st 2021.
 
         :param Nullable[datetime] start_date: Optional starting date
             (inclusive). If start_date is None or too long ago, this field will