Skip to content

Commit 4ead82b

Browse files
authored
Automated Spec Update (#259)
e57f8a4da1b070bed3ac5d4d3ec325fcd3630686 Change Notes: sharing_files Namespace - Update Comments sharing_folders Namespace - Update Comments team_folders Namespace - Update Comments team_log_generated Namespace - Add ExternalDriveBackupPolicy union - Add ExternalDriveBackupPolicyChangedDetails and ExternalDriveBackupPolicyChangedType structs - Update EventDetails union to include external_drive_backup_policy_changed_details - Update EventType union to include external_drive_backup_policy_changed - Update EventTypeArg union to include external_drive_backup_policy_changed team_policies Namespace - Add ExternalDriveBackupPolicyState union Co-authored-by: DropboxBot <[email protected]>
1 parent b6c505f commit 4ead82b

13 files changed

+1419
-18
lines changed

dropbox-sdk-dotnet/Dropbox.Api/Generated/Sharing/RelinquishFolderMembershipArg.cs

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,8 @@ public class RelinquishFolderMembershipArg
3333
/// </summary>
3434
/// <param name="sharedFolderId">The ID for the shared folder.</param>
3535
/// <param name="leaveACopy">Keep a copy of the folder's contents upon relinquishing
36-
/// membership.</param>
36+
/// membership. This must be set to false when the folder is within a team folder or
37+
/// another shared folder.</param>
3738
public RelinquishFolderMembershipArg(string sharedFolderId,
3839
bool leaveACopy = false)
3940
{
@@ -68,7 +69,9 @@ public RelinquishFolderMembershipArg()
6869
public string SharedFolderId { get; protected set; }
6970

7071
/// <summary>
71-
/// <para>Keep a copy of the folder's contents upon relinquishing membership.</para>
72+
/// <para>Keep a copy of the folder's contents upon relinquishing membership. This must
73+
/// be set to false when the folder is within a team folder or another shared
74+
/// folder.</para>
7275
/// </summary>
7376
public bool LeaveACopy { get; protected set; }
7477

dropbox-sdk-dotnet/Dropbox.Api/Generated/Sharing/RemoveFolderMemberArg.cs

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,8 @@ public class RemoveFolderMemberArg
3535
/// <param name="member">The member to remove from the folder.</param>
3636
/// <param name="leaveACopy">If true, the removed user will keep their copy of the
3737
/// folder after it's unshared, assuming it was mounted. Otherwise, it will be removed
38-
/// from their Dropbox. Also, this must be set to false when kicking a group.</param>
38+
/// from their Dropbox. This must be set to false when removing a group, or when the
39+
/// folder is within a team folder or another shared folder.</param>
3940
public RemoveFolderMemberArg(string sharedFolderId,
4041
MemberSelector member,
4142
bool leaveACopy)
@@ -83,7 +84,8 @@ public RemoveFolderMemberArg()
8384
/// <summary>
8485
/// <para>If true, the removed user will keep their copy of the folder after it's
8586
/// unshared, assuming it was mounted. Otherwise, it will be removed from their
86-
/// Dropbox. Also, this must be set to false when kicking a group.</para>
87+
/// Dropbox. This must be set to false when removing a group, or when the folder is
88+
/// within a team folder or another shared folder.</para>
8789
/// </summary>
8890
public bool LeaveACopy { get; protected set; }
8991

dropbox-sdk-dotnet/Dropbox.Api/Generated/Sharing/SharingUserRoutes.cs

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2905,7 +2905,8 @@ public sys.IAsyncResult BeginRelinquishFolderMembership(RelinquishFolderMembersh
29052905
/// </summary>
29062906
/// <param name="sharedFolderId">The ID for the shared folder.</param>
29072907
/// <param name="leaveACopy">Keep a copy of the folder's contents upon relinquishing
2908-
/// membership.</param>
2908+
/// membership. This must be set to false when the folder is within a team folder or
2909+
/// another shared folder.</param>
29092910
/// <returns>The task that represents the asynchronous send operation. The TResult
29102911
/// parameter contains the response from the server.</returns>
29112912
/// <exception cref="Dropbox.Api.ApiException{TError}">Thrown if there is an error
@@ -2925,7 +2926,8 @@ public sys.IAsyncResult BeginRelinquishFolderMembership(RelinquishFolderMembersh
29252926
/// </summary>
29262927
/// <param name="sharedFolderId">The ID for the shared folder.</param>
29272928
/// <param name="leaveACopy">Keep a copy of the folder's contents upon relinquishing
2928-
/// membership.</param>
2929+
/// membership. This must be set to false when the folder is within a team folder or
2930+
/// another shared folder.</param>
29292931
/// <param name="callback">The method to be called when the asynchronous send is
29302932
/// completed.</param>
29312933
/// <param name="callbackState">A user provided object that distinguished this send
@@ -3197,7 +3199,8 @@ public sys.IAsyncResult BeginRemoveFolderMember(RemoveFolderMemberArg removeFold
31973199
/// <param name="member">The member to remove from the folder.</param>
31983200
/// <param name="leaveACopy">If true, the removed user will keep their copy of the
31993201
/// folder after it's unshared, assuming it was mounted. Otherwise, it will be removed
3200-
/// from their Dropbox. Also, this must be set to false when kicking a group.</param>
3202+
/// from their Dropbox. This must be set to false when removing a group, or when the
3203+
/// folder is within a team folder or another shared folder.</param>
32013204
/// <returns>The task that represents the asynchronous send operation. The TResult
32023205
/// parameter contains the response from the server.</returns>
32033206
/// <exception cref="Dropbox.Api.ApiException{TError}">Thrown if there is an error
@@ -3221,7 +3224,8 @@ public sys.IAsyncResult BeginRemoveFolderMember(RemoveFolderMemberArg removeFold
32213224
/// <param name="member">The member to remove from the folder.</param>
32223225
/// <param name="leaveACopy">If true, the removed user will keep their copy of the
32233226
/// folder after it's unshared, assuming it was mounted. Otherwise, it will be removed
3224-
/// from their Dropbox. Also, this must be set to false when kicking a group.</param>
3227+
/// from their Dropbox. This must be set to false when removing a group, or when the
3228+
/// folder is within a team folder or another shared folder.</param>
32253229
/// <param name="callback">The method to be called when the asynchronous send is
32263230
/// completed.</param>
32273231
/// <param name="callbackState">A user provided object that distinguished this send

dropbox-sdk-dotnet/Dropbox.Api/Generated/Sharing/UserFileMembershipInfo.cs

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,8 @@ public class UserFileMembershipInfo : UserMembershipInfo
4242
/// <param name="isInherited">True if the member has access from a parent
4343
/// folder.</param>
4444
/// <param name="timeLastSeen">The UTC timestamp of when the user has last seen the
45-
/// content, if they have.</param>
45+
/// content. Only populated if the user has seen the content and the caller has a plan
46+
/// that includes viewer history.</param>
4647
/// <param name="platformType">The platform on which the user has last seen the
4748
/// content, or unknown.</param>
4849
public UserFileMembershipInfo(AccessLevel accessType,
@@ -70,8 +71,9 @@ public UserFileMembershipInfo()
7071
}
7172

7273
/// <summary>
73-
/// <para>The UTC timestamp of when the user has last seen the content, if they
74-
/// have.</para>
74+
/// <para>The UTC timestamp of when the user has last seen the content. Only populated
75+
/// if the user has seen the content and the caller has a plan that includes viewer
76+
/// history.</para>
7577
/// </summary>
7678
public sys.DateTime? TimeLastSeen { get; protected set; }
7779

dropbox-sdk-dotnet/Dropbox.Api/Generated/Team/TeamTeamRoutes.cs

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -7483,7 +7483,8 @@ public TeamFolderMetadata EndTeamFolderActivate(sys.IAsyncResult asyncResult)
74837483

74847484
/// <summary>
74857485
/// <para>Sets an active team folder's status to archived and removes all folder and
7486-
/// file members.</para>
7486+
/// file members. This endpoint cannot be used for teams that have a shared team
7487+
/// space.</para>
74877488
/// <para>Permission : Team member file access.</para>
74887489
/// </summary>
74897490
/// <param name="teamFolderArchiveArg">The request parameters</param>
@@ -7515,7 +7516,8 @@ public sys.IAsyncResult BeginTeamFolderArchive(TeamFolderArchiveArg teamFolderAr
75157516

75167517
/// <summary>
75177518
/// <para>Sets an active team folder's status to archived and removes all folder and
7518-
/// file members.</para>
7519+
/// file members. This endpoint cannot be used for teams that have a shared team
7520+
/// space.</para>
75197521
/// <para>Permission : Team member file access.</para>
75207522
/// </summary>
75217523
/// <param name="teamFolderId">The ID of the team folder.</param>
@@ -7668,7 +7670,8 @@ public TeamFolderArchiveJobStatus EndTeamFolderArchiveCheck(sys.IAsyncResult asy
76687670
}
76697671

76707672
/// <summary>
7671-
/// <para>Creates a new, active, team folder with no members.</para>
7673+
/// <para>Creates a new, active, team folder with no members. This endpoint can only be
7674+
/// used for teams that do not already have a shared team space.</para>
76727675
/// <para>Permission : Team member file access.</para>
76737676
/// </summary>
76747677
/// <param name="teamFolderCreateArg">The request parameters</param>
@@ -7699,7 +7702,8 @@ public sys.IAsyncResult BeginTeamFolderCreate(TeamFolderCreateArg teamFolderCrea
76997702
}
77007703

77017704
/// <summary>
7702-
/// <para>Creates a new, active, team folder with no members.</para>
7705+
/// <para>Creates a new, active, team folder with no members. This endpoint can only be
7706+
/// used for teams that do not already have a shared team space.</para>
77037707
/// <para>Permission : Team member file access.</para>
77047708
/// </summary>
77057709
/// <param name="name">Name for the new team folder.</param>
@@ -8021,7 +8025,8 @@ public TeamFolderListResult EndTeamFolderListContinue(sys.IAsyncResult asyncResu
80218025
}
80228026

80238027
/// <summary>
8024-
/// <para>Permanently deletes an archived team folder.</para>
8028+
/// <para>Permanently deletes an archived team folder. This endpoint cannot be used for
8029+
/// teams that have a shared team space.</para>
80258030
/// <para>Permission : Team member file access.</para>
80268031
/// </summary>
80278032
/// <param name="teamFolderIdArg">The request parameters</param>
@@ -8052,7 +8057,8 @@ public sys.IAsyncResult BeginTeamFolderPermanentlyDelete(TeamFolderIdArg teamFol
80528057
}
80538058

80548059
/// <summary>
8055-
/// <para>Permanently deletes an archived team folder.</para>
8060+
/// <para>Permanently deletes an archived team folder. This endpoint cannot be used for
8061+
/// teams that have a shared team space.</para>
80568062
/// <para>Permission : Team member file access.</para>
80578063
/// </summary>
80588064
/// <param name="teamFolderId">The ID of the team folder.</param>

dropbox-sdk-dotnet/Dropbox.Api/Generated/TeamLog/EventDetails.cs

Lines changed: 124 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8627,6 +8627,30 @@ public ExtendedVersionHistoryChangePolicyDetails AsExtendedVersionHistoryChangeP
86278627
}
86288628
}
86298629

8630+
/// <summary>
8631+
/// <para>Gets a value indicating whether this instance is
8632+
/// ExternalDriveBackupPolicyChangedDetails</para>
8633+
/// </summary>
8634+
public bool IsExternalDriveBackupPolicyChangedDetails
8635+
{
8636+
get
8637+
{
8638+
return this is ExternalDriveBackupPolicyChangedDetails;
8639+
}
8640+
}
8641+
8642+
/// <summary>
8643+
/// <para>Gets this instance as a ExternalDriveBackupPolicyChangedDetails, or
8644+
/// <c>null</c>.</para>
8645+
/// </summary>
8646+
public ExternalDriveBackupPolicyChangedDetails AsExternalDriveBackupPolicyChangedDetails
8647+
{
8648+
get
8649+
{
8650+
return this as ExternalDriveBackupPolicyChangedDetails;
8651+
}
8652+
}
8653+
86308654
/// <summary>
86318655
/// <para>Gets a value indicating whether this instance is
86328656
/// FileCommentsChangePolicyDetails</para>
@@ -13295,6 +13319,12 @@ public override void EncodeFields(EventDetails value, enc.IJsonWriter writer)
1329513319
ExtendedVersionHistoryChangePolicyDetails.Encoder.EncodeFields((ExtendedVersionHistoryChangePolicyDetails)value, writer);
1329613320
return;
1329713321
}
13322+
if (value is ExternalDriveBackupPolicyChangedDetails)
13323+
{
13324+
WriteProperty(".tag", "external_drive_backup_policy_changed_details", writer, enc.StringEncoder.Instance);
13325+
ExternalDriveBackupPolicyChangedDetails.Encoder.EncodeFields((ExternalDriveBackupPolicyChangedDetails)value, writer);
13326+
return;
13327+
}
1329813328
if (value is FileCommentsChangePolicyDetails)
1329913329
{
1330013330
WriteProperty(".tag", "file_comments_change_policy_details", writer, enc.StringEncoder.Instance);
@@ -14683,6 +14713,8 @@ protected override EventDetails Decode(string tag, enc.IJsonReader reader)
1468314713
return EmmRemoveExceptionDetails.Decoder.DecodeFields(reader);
1468414714
case "extended_version_history_change_policy_details":
1468514715
return ExtendedVersionHistoryChangePolicyDetails.Decoder.DecodeFields(reader);
14716+
case "external_drive_backup_policy_changed_details":
14717+
return ExternalDriveBackupPolicyChangedDetails.Decoder.DecodeFields(reader);
1468614718
case "file_comments_change_policy_details":
1468714719
return FileCommentsChangePolicyDetails.Decoder.DecodeFields(reader);
1468814720
case "file_locking_policy_changed_details":
@@ -48207,6 +48239,98 @@ public override ExtendedVersionHistoryChangePolicyDetails DecodeFields(enc.IJson
4820748239
#endregion
4820848240
}
4820948241

48242+
/// <summary>
48243+
/// <para>The external drive backup policy changed details object</para>
48244+
/// </summary>
48245+
public sealed class ExternalDriveBackupPolicyChangedDetails : EventDetails
48246+
{
48247+
#pragma warning disable 108
48248+
48249+
/// <summary>
48250+
/// <para>The encoder instance.</para>
48251+
/// </summary>
48252+
internal static enc.StructEncoder<ExternalDriveBackupPolicyChangedDetails> Encoder = new ExternalDriveBackupPolicyChangedDetailsEncoder();
48253+
48254+
/// <summary>
48255+
/// <para>The decoder instance.</para>
48256+
/// </summary>
48257+
internal static enc.StructDecoder<ExternalDriveBackupPolicyChangedDetails> Decoder = new ExternalDriveBackupPolicyChangedDetailsDecoder();
48258+
48259+
/// <summary>
48260+
/// <para>Initializes a new instance of the <see
48261+
/// cref="ExternalDriveBackupPolicyChangedDetails" /> class.</para>
48262+
/// </summary>
48263+
/// <param name="value">The value</param>
48264+
public ExternalDriveBackupPolicyChangedDetails(global::Dropbox.Api.TeamLog.ExternalDriveBackupPolicyChangedDetails value)
48265+
{
48266+
this.Value = value;
48267+
}
48268+
/// <summary>
48269+
/// <para>Initializes a new instance of the <see
48270+
/// cref="ExternalDriveBackupPolicyChangedDetails" /> class.</para>
48271+
/// </summary>
48272+
private ExternalDriveBackupPolicyChangedDetails()
48273+
{
48274+
}
48275+
48276+
/// <summary>
48277+
/// <para>Gets the value of this instance.</para>
48278+
/// </summary>
48279+
public global::Dropbox.Api.TeamLog.ExternalDriveBackupPolicyChangedDetails Value { get; private set; }
48280+
48281+
#region Encoder class
48282+
48283+
/// <summary>
48284+
/// <para>Encoder for <see cref="ExternalDriveBackupPolicyChangedDetails"
48285+
/// />.</para>
48286+
/// </summary>
48287+
private class ExternalDriveBackupPolicyChangedDetailsEncoder : enc.StructEncoder<ExternalDriveBackupPolicyChangedDetails>
48288+
{
48289+
/// <summary>
48290+
/// <para>Encode fields of given value.</para>
48291+
/// </summary>
48292+
/// <param name="value">The value.</param>
48293+
/// <param name="writer">The writer.</param>
48294+
public override void EncodeFields(ExternalDriveBackupPolicyChangedDetails value, enc.IJsonWriter writer)
48295+
{
48296+
WriteProperty("external_drive_backup_policy_changed_details", value.Value, writer, global::Dropbox.Api.TeamLog.ExternalDriveBackupPolicyChangedDetails.Encoder);
48297+
}
48298+
}
48299+
48300+
#endregion
48301+
48302+
#region Decoder class
48303+
48304+
/// <summary>
48305+
/// <para>Decoder for <see cref="ExternalDriveBackupPolicyChangedDetails"
48306+
/// />.</para>
48307+
/// </summary>
48308+
private class ExternalDriveBackupPolicyChangedDetailsDecoder : enc.StructDecoder<ExternalDriveBackupPolicyChangedDetails>
48309+
{
48310+
/// <summary>
48311+
/// <para>Create a new instance of type <see
48312+
/// cref="ExternalDriveBackupPolicyChangedDetails" />.</para>
48313+
/// </summary>
48314+
/// <returns>The struct instance.</returns>
48315+
protected override ExternalDriveBackupPolicyChangedDetails Create()
48316+
{
48317+
return new ExternalDriveBackupPolicyChangedDetails();
48318+
}
48319+
48320+
/// <summary>
48321+
/// <para>Decode fields without ensuring start and end object.</para>
48322+
/// </summary>
48323+
/// <param name="reader">The json reader.</param>
48324+
/// <returns>The decoded object.</returns>
48325+
public override ExternalDriveBackupPolicyChangedDetails DecodeFields(enc.IJsonReader reader)
48326+
{
48327+
return new ExternalDriveBackupPolicyChangedDetails(global::Dropbox.Api.TeamLog.ExternalDriveBackupPolicyChangedDetails.Decoder.DecodeFields(reader));
48328+
}
48329+
}
48330+
48331+
#endregion
48332+
}
48333+
4821048334
/// <summary>
4821148335
/// <para>The file comments change policy details object</para>
4821248336
/// </summary>

0 commit comments

Comments
 (0)