Download watermarked file

Hi @juliano.net, welcome to the forum!

You started with a very interesting question, lets go step by step.

IAs you stated and confirmed in support note, we can see that a watermarked download is only possible when the user is a viewer.

This works fine in the previewer UI.

However when we try to download the file for a user with viewer permission we het a HTTP 403 access denied.

If the user is editor or above the user will be able to download the file without watermark, since they can edit it.

In order to get around this you can download the PDF representation of the file. This will include the watermark, and it is accessible to the viewer.

No sure if you are familiar with file representations, we have an article on that topic:

Consider these auxiliary methods for file representations (I’m using python)

def do_request(url: str, access_token: str):

    resp = requests.get(

        url, headers={"Authorization": f"Bearer {access_token}"}

    )

    resp.raise_for_status()

    return resp.content





def file_representations(

    client: Client, file: FileMini, rep_hints: str = None

) -> List[FileFullRepresentationsEntriesField]:

    """Get file representations"""

    file = client.files.get_file_by_id(

        file.id, fields=["name", "representations"], x_rep_hints=rep_hints

    )

    return file.representations.entries





def representation_download(

    access_token: str,

    file_representation: FileFullRepresentationsEntriesField,

    file_name: str,

):

    if (

        file_representation.status.state

        != FileFullRepresentationsEntriesStatusStateField.SUCCESS

    ):

        print(

            f"Representation {file_representation.representation} is not ready"

        )

        return



    url_template = file_representation.content.url_template

    url = url_template.replace("{+asset_path}", "")

    file_name = (

        file_name.replace(".", "_").replace(" ", "_")

        + "."

        + file_representation.representation

    )



    content = do_request(url, access_token)



    with open(file_name, "wb") as file:

        file.write(content)



    print(

        f"Representation {file_representation.representation}",

        f" saved to {file_name}",

    )

This will download the file representation of a word document as a pdf which includes the watermark.

    FILE_DOCX = "1418524151903"



    # Make sure the file exists

    file_ppt = client.files.get_file_by_id(FILE_DOCX)

    print(f"\nFile {file_ppt.name} ({file_ppt.id})")



    # Get PDF representation

    file_ppt_repr_pdf = file_representations(client, file_ppt, "[pdf]")

    access_token = client.auth.retrieve_token().access_token

    representation_download(access_token, file_ppt_repr_pdf[0], file_ppt.name)

Let us know if this helps

Cheers