Automated Spec Update (#179)

ed6e389b2d16d19b21e68413ae8f4743dd9b9223

 Change Notes:

File Namespace:
- Add UploadSessionStartError union
- Add UploadSessionType union
- Update UploadSessionFinishError union to include concurrent_sessions_data_not_allowed, concurrent_session_not_closed, concurrent_session_missing_data
- Update UploadSessionType struct to include session_type
- Update upload_session/start to include UploadSessionStartError
- Update Comments

Team Log Namespace:
- Add AdminAlertingAlertConfiguration, AdminAlertingChangedAlertConfigDetails, MemberChangeResellerRoleDetails, TeamProfileAddBackgroundDetails, TeamProfileChangeBackgroundDetails, TeamProfileRemoveBackgroundDetails, AdminAlertingChangedAlertConfigType, MemberChangeResellerRoleType, TeamProfileAddBackgroundType, TeamProfileChangeBackgroundType, TeamProfileRemoveBackgroundType structs
- Add AdminAlertingAlertStatePolicy, ResellerRole unions
- Update EventCategory union to include admin_alerting
- Update GovernancePolicyRemoveFoldersDetails struct to include reason
- Update EventDetails union to include admin_alerting_changed_alert_config_details, member_change_reseller_role_details, team_profile_add_background_details, team_profile_change_background_details, team_profile_remove_background_details
- Update EventType union to include admin_alerting_changed_alert_config, member_change_reseller_role, team_profile_add_background, team_profile_change_background, team_profile_remove_background
- Update EventTypeArg to include admin_alerting_changed_alert_config, member_change_reseller_role, team_profile_add_background, team_profile_change_background, team_profile_remove_background
- Update Examples

Co-authored-by: Brent Bumann <[email protected]>

 de3a7718946ee79f1a0d5ca499b9d22b41cc7c84

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

Author: DropboxBot

dropbox-sdk-dotnet/Dropbox.Api/Generated/Files/FilesUserRoutes.cs

@@ -6716,14 +6716,43 @@ public UploadSessionFinishBatchJobStatus EndUploadSessionFinishBatchCheck(sys.IA
         /// month. For more information, see the <a
         /// href="https://www.dropbox.com/developers/reference/data-transport-limit">Data
         /// transport limit page</a>.</para>
+        /// <para>By default, upload sessions require you to send content of the file in
+        /// sequential order via consecutive <see
+        /// cref="Dropbox.Api.Files.Routes.FilesUserRoutes.UploadSessionStartAsync" />, <see
+        /// cref="Dropbox.Api.Files.Routes.FilesUserRoutes.UploadSessionAppendV2Async" />, <see
+        /// cref="Dropbox.Api.Files.Routes.FilesUserRoutes.UploadSessionFinishAsync" /> calls.
+        /// For better performance, you can instead optionally use a <see
+        /// cref="Dropbox.Api.Files.UploadSessionType.Concurrent" /> upload session. To start a
+        /// new concurrent session, set <see
+        /// cref="Dropbox.Api.Files.UploadSessionStartArg.SessionType" /> to <see
+        /// cref="Dropbox.Api.Files.UploadSessionType.Concurrent" />. After that, you can send
+        /// file data in concurrent <see
+        /// cref="Dropbox.Api.Files.Routes.FilesUserRoutes.UploadSessionAppendV2Async" />
+        /// requests. Finally finish the session with <see
+        /// cref="Dropbox.Api.Files.Routes.FilesUserRoutes.UploadSessionFinishAsync" />.</para>
+        /// <para>There are couple of constraints with concurrent sessions to make them work.
+        /// You can not send data with <see
+        /// cref="Dropbox.Api.Files.Routes.FilesUserRoutes.UploadSessionStartAsync" /> or <see
+        /// cref="Dropbox.Api.Files.Routes.FilesUserRoutes.UploadSessionFinishAsync" /> call,
+        /// only with <see
+        /// cref="Dropbox.Api.Files.Routes.FilesUserRoutes.UploadSessionAppendV2Async" /> call.
+        /// Also data uploaded in <see
+        /// cref="Dropbox.Api.Files.Routes.FilesUserRoutes.UploadSessionAppendV2Async" /> call
+        /// must be multiple of 4194304 bytes (except for last <see
+        /// cref="Dropbox.Api.Files.Routes.FilesUserRoutes.UploadSessionAppendV2Async" /> with
+        /// <see cref="Dropbox.Api.Files.UploadSessionStartArg.Close" /> to <c>true</c>, that
+        /// may contain any remaining data).</para>
         /// </summary>
         /// <param name="uploadSessionStartArg">The request parameters</param>
         /// <param name="body">The content to upload.</param>
         /// <returns>The task that represents the asynchronous send operation. The TResult
         /// parameter contains the response from the server.</returns>
+        /// <exception cref="Dropbox.Api.ApiException{TError}">Thrown if there is an error
+        /// processing the request; This will contain a <see
+        /// cref="UploadSessionStartError"/>.</exception>
         public t.Task<UploadSessionStartResult> UploadSessionStartAsync(UploadSessionStartArg uploadSessionStartArg, io.Stream body)
         {
-            return this.Transport.SendUploadRequestAsync<UploadSessionStartArg, UploadSessionStartResult, enc.Empty>(uploadSessionStartArg, body, "content", "/files/upload_session/start", "user", global::Dropbox.Api.Files.UploadSessionStartArg.Encoder, global::Dropbox.Api.Files.UploadSessionStartResult.Decoder, enc.EmptyDecoder.Instance);
+            return this.Transport.SendUploadRequestAsync<UploadSessionStartArg, UploadSessionStartResult, UploadSessionStartError>(uploadSessionStartArg, body, "content", "/files/upload_session/start", "user", global::Dropbox.Api.Files.UploadSessionStartArg.Encoder, global::Dropbox.Api.Files.UploadSessionStartResult.Decoder, global::Dropbox.Api.Files.UploadSessionStartError.Decoder);
         }
 
         /// <summary>
@@ -6764,18 +6793,52 @@ public sys.IAsyncResult BeginUploadSessionStart(UploadSessionStartArg uploadSess
         /// month. For more information, see the <a
         /// href="https://www.dropbox.com/developers/reference/data-transport-limit">Data
         /// transport limit page</a>.</para>
+        /// <para>By default, upload sessions require you to send content of the file in
+        /// sequential order via consecutive <see
+        /// cref="Dropbox.Api.Files.Routes.FilesUserRoutes.UploadSessionStartAsync" />, <see
+        /// cref="Dropbox.Api.Files.Routes.FilesUserRoutes.UploadSessionAppendV2Async" />, <see
+        /// cref="Dropbox.Api.Files.Routes.FilesUserRoutes.UploadSessionFinishAsync" /> calls.
+        /// For better performance, you can instead optionally use a <see
+        /// cref="Dropbox.Api.Files.UploadSessionType.Concurrent" /> upload session. To start a
+        /// new concurrent session, set <see
+        /// cref="Dropbox.Api.Files.UploadSessionStartArg.SessionType" /> to <see
+        /// cref="Dropbox.Api.Files.UploadSessionType.Concurrent" />. After that, you can send
+        /// file data in concurrent <see
+        /// cref="Dropbox.Api.Files.Routes.FilesUserRoutes.UploadSessionAppendV2Async" />
+        /// requests. Finally finish the session with <see
+        /// cref="Dropbox.Api.Files.Routes.FilesUserRoutes.UploadSessionFinishAsync" />.</para>
+        /// <para>There are couple of constraints with concurrent sessions to make them work.
+        /// You can not send data with <see
+        /// cref="Dropbox.Api.Files.Routes.FilesUserRoutes.UploadSessionStartAsync" /> or <see
+        /// cref="Dropbox.Api.Files.Routes.FilesUserRoutes.UploadSessionFinishAsync" /> call,
+        /// only with <see
+        /// cref="Dropbox.Api.Files.Routes.FilesUserRoutes.UploadSessionAppendV2Async" /> call.
+        /// Also data uploaded in <see
+        /// cref="Dropbox.Api.Files.Routes.FilesUserRoutes.UploadSessionAppendV2Async" /> call
+        /// must be multiple of 4194304 bytes (except for last <see
+        /// cref="Dropbox.Api.Files.Routes.FilesUserRoutes.UploadSessionAppendV2Async" /> with
+        /// <see cref="Dropbox.Api.Files.UploadSessionStartArg.Close" /> to <c>true</c>, that
+        /// may contain any remaining data).</para>
         /// </summary>
         /// <param name="close">If true, the current session will be closed, at which point you
         /// won't be able to call <see
         /// cref="Dropbox.Api.Files.Routes.FilesUserRoutes.UploadSessionAppendV2Async" />
         /// anymore with the current session.</param>
+        /// <param name="sessionType">Type of upload session you want to start. If not
+        /// specified, default is <see cref="Dropbox.Api.Files.UploadSessionType.Sequential"
+        /// />.</param>
         /// <param name="body">The document to upload</param>
         /// <returns>The task that represents the asynchronous send operation. The TResult
         /// parameter contains the response from the server.</returns>
+        /// <exception cref="Dropbox.Api.ApiException{TError}">Thrown if there is an error
+        /// processing the request; This will contain a <see
+        /// cref="UploadSessionStartError"/>.</exception>
         public t.Task<UploadSessionStartResult> UploadSessionStartAsync(bool close = false,
+                                                                        UploadSessionType sessionType = null,
                                                                         io.Stream body = null)
         {
-            var uploadSessionStartArg = new UploadSessionStartArg(close);
+            var uploadSessionStartArg = new UploadSessionStartArg(close,
+                                                                  sessionType);
 
             return this.UploadSessionStartAsync(uploadSessionStartArg, body);
         }
@@ -6787,18 +6850,23 @@ public t.Task<UploadSessionStartResult> UploadSessionStartAsync(bool close = fal
         /// won't be able to call <see
         /// cref="Dropbox.Api.Files.Routes.FilesUserRoutes.UploadSessionAppendV2Async" />
         /// anymore with the current session.</param>
+        /// <param name="sessionType">Type of upload session you want to start. If not
+        /// specified, default is <see cref="Dropbox.Api.Files.UploadSessionType.Sequential"
+        /// />.</param>
         /// <param name="body">The document to upload</param>
         /// <param name="callback">The method to be called when the asynchronous send is
         /// completed.</param>
         /// <param name="callbackState">A user provided object that distinguished this send
         /// from other send requests.</param>
         /// <returns>An object that represents the asynchronous send request.</returns>
         public sys.IAsyncResult BeginUploadSessionStart(bool close = false,
+                                                        UploadSessionType sessionType = null,
                                                         io.Stream body = null,
                                                         sys.AsyncCallback callback = null,
                                                         object callbackState = null)
         {
-            var uploadSessionStartArg = new UploadSessionStartArg(close);
+            var uploadSessionStartArg = new UploadSessionStartArg(close,
+                                                                  sessionType);
 
             return this.BeginUploadSessionStart(uploadSessionStartArg, body, callback, callbackState);
         }
@@ -6810,6 +6878,9 @@ public sys.IAsyncResult BeginUploadSessionStart(bool close = false,
         /// <param name="asyncResult">The reference to the pending asynchronous send
         /// request</param>
         /// <returns>The response to the send request</returns>
+        /// <exception cref="Dropbox.Api.ApiException{TError}">Thrown if there is an error
+        /// processing the request; This will contain a <see
+        /// cref="UploadSessionStartError"/>.</exception>
         public UploadSessionStartResult EndUploadSessionStart(sys.IAsyncResult asyncResult)
         {
             var task = asyncResult as t.Task<UploadSessionStartResult>;