Private files are protected against public access. This means you can't access them using their file descriptor's url
property.
You may want to make a file private if it's for sale or contains personal information.
File descriptors for private files still include a top-level thumbnailUrl
property. For images and videos this is based on the file's contents. For other media types, it contains an icon representing the file type.
You can make a file private by setting its private
property to true
when you add it to a site using one of the following methods:
Note: Making a file private impacts the following file descriptor properties:
yourFile.url
: Has a URL value, but it returns a 403 (unauthorized) response, meaning it won't work.media
field contains stringified objects representing the file's media. These contain empty strings for their url
values, depending on the type of file. The possible media fields are:
yourFile.media.audio.assets[x]
yourFile.media.video
yourFile.media.document
yourFile.media.archive
Use the generateFileDownloadUrl()
method to access a private file. Call the method with your private file's ID. This will return a new URL that you can use to download the file.