Class SharedContentLinkMetadata

    • Field Detail

      • url

        @Nonnull
        protected final java.lang.String url
    • Constructor Detail

      • SharedContentLinkMetadata

        public SharedContentLinkMetadata​(@Nonnull
                                         java.util.List<LinkAudience> audienceOptions,
                                         @Nonnull
                                         LinkAudience currentAudience,
                                         @Nonnull
                                         java.util.List<LinkPermission> linkPermissions,
                                         boolean passwordProtected,
                                         @Nonnull
                                         java.lang.String url,
                                         @Nullable
                                         AccessLevel accessLevel,
                                         @Nullable
                                         AudienceRestrictingSharedFolder audienceRestrictingSharedFolder,
                                         @Nullable
                                         java.util.Date expiry,
                                         @Nullable
                                         AudienceExceptions audienceExceptions)
        Metadata of a shared link for a file or folder.

        Use newBuilder(java.util.List<com.dropbox.core.v2.sharing.LinkAudience>,com.dropbox.core.v2.sharing.LinkAudience,java.util.List<com.dropbox.core.v2.sharing.LinkPermission>,boolean,java.lang.String) to create instances of this class without specifying values for all optional fields.

        Parameters:
        audienceOptions - The audience options that are available for the content. Some audience options may be unavailable. For example, team_only may be unavailable if the content is not owned by a user on a team. The 'default' audience option is always available if the user can modify link settings. Must not contain a null item and not be null.
        currentAudience - The current audience of the link. Must not be null.
        linkPermissions - A list of permissions for actions you can perform on the link. Must not contain a null item and not be null.
        passwordProtected - Whether the link is protected by a password.
        url - The URL of the link. Must not be null.
        accessLevel - The access level on the link for this file.
        audienceRestrictingSharedFolder - The shared folder that prevents the link audience for this link from being more restrictive.
        expiry - Whether the link has an expiry set on it. A link with an expiry will have its audience changed to members when the expiry is reached.
        audienceExceptions - The content inside this folder with link audience different than this folder's. This is only returned when an endpoint that returns metadata for a single shared folder is called, e.g. /get_folder_metadata.
        Throws:
        java.lang.IllegalArgumentException - If any argument does not meet its preconditions.
      • SharedContentLinkMetadata

        public SharedContentLinkMetadata​(@Nonnull
                                         java.util.List<LinkAudience> audienceOptions,
                                         @Nonnull
                                         LinkAudience currentAudience,
                                         @Nonnull
                                         java.util.List<LinkPermission> linkPermissions,
                                         boolean passwordProtected,
                                         @Nonnull
                                         java.lang.String url)
        Metadata of a shared link for a file or folder.

        The default values for unset fields will be used.

        Parameters:
        audienceOptions - The audience options that are available for the content. Some audience options may be unavailable. For example, team_only may be unavailable if the content is not owned by a user on a team. The 'default' audience option is always available if the user can modify link settings. Must not contain a null item and not be null.
        currentAudience - The current audience of the link. Must not be null.
        linkPermissions - A list of permissions for actions you can perform on the link. Must not contain a null item and not be null.
        passwordProtected - Whether the link is protected by a password.
        url - The URL of the link. Must not be null.
        Throws:
        java.lang.IllegalArgumentException - If any argument does not meet its preconditions.
    • Method Detail

      • getAudienceOptions

        @Nonnull
        public java.util.List<LinkAudience> getAudienceOptions()
        The audience options that are available for the content. Some audience options may be unavailable. For example, team_only may be unavailable if the content is not owned by a user on a team. The 'default' audience option is always available if the user can modify link settings.
        Overrides:
        getAudienceOptions in class SharedContentLinkMetadataBase
        Returns:
        value for this field, never null.
      • getUrl

        @Nonnull
        public java.lang.String getUrl()
        The URL of the link.
        Returns:
        value for this field, never null.
      • getExpiry

        @Nullable
        public java.util.Date getExpiry()
        Whether the link has an expiry set on it. A link with an expiry will have its audience changed to members when the expiry is reached.
        Overrides:
        getExpiry in class SharedContentLinkMetadataBase
        Returns:
        value for this field, or null if not present.
      • getAudienceExceptions

        @Nullable
        public AudienceExceptions getAudienceExceptions()
        The content inside this folder with link audience different than this folder's. This is only returned when an endpoint that returns metadata for a single shared folder is called, e.g. /get_folder_metadata.
        Returns:
        value for this field, or null if not present.
      • newBuilder

        public static SharedContentLinkMetadata.Builder newBuilder​(java.util.List<LinkAudience> audienceOptions,
                                                                   LinkAudience currentAudience,
                                                                   java.util.List<LinkPermission> linkPermissions,
                                                                   boolean passwordProtected,
                                                                   java.lang.String url)
        Returns a new builder for creating an instance of this class.
        Parameters:
        audienceOptions - The audience options that are available for the content. Some audience options may be unavailable. For example, team_only may be unavailable if the content is not owned by a user on a team. The 'default' audience option is always available if the user can modify link settings. Must not contain a null item and not be null.
        currentAudience - The current audience of the link. Must not be null.
        linkPermissions - A list of permissions for actions you can perform on the link. Must not contain a null item and not be null.
        passwordProtected - Whether the link is protected by a password.
        url - The URL of the link. Must not be null.
        Returns:
        builder for this class.
        Throws:
        java.lang.IllegalArgumentException - If any argument does not meet its preconditions.
      • toStringMultiline

        public java.lang.String toStringMultiline()
        Returns a String representation of this object formatted for easier readability.

        The returned String may contain newlines.

        Overrides:
        toStringMultiline in class SharedContentLinkMetadataBase
        Returns:
        Formatted, multiline String representation of this object