Work with Bookmarks in PDF in Python SDK

    from asposepdfcloud import PdfApi, ApiClient, Bookmark, Color
    import shutil
    import os
    import json
    from pathlib import Path
    import logging

    # Configure logging
    logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s")

    class PdfBookmarksAdd:
        """Class for managing PDF annotations using Aspose PDF Cloud API."""

        def append_bookmark(self):
            """Append a new highlight text annotation to the PDF document."""
            localFolder = "C:\Samples"
            storageDocumentName = "sample.pdf"
            storageTempFolder = "TempPdfCloud"
            outputFileName = "output_add_bookmark.pdf"
            parentBookmark = ""                 #The parent bookmark path. Specify an empty string when adding a bookmark to the root.

            # Get your AppSid and AppSecret from https://dashboard.aspose.cloud (free registration required). 
            self.pdf_api = PdfApi(ApiClient(AppSecret, AppSid))

            if self.pdf_api:
                file_path = localFolder + "/" + storageDocumentName
                self.pdf_api.upload_file(os.path.join(storageTempFolder, storageDocumentName), file_path)
                    
                args = {
                    "folder": storageTempFolder
                }

                newBookmark = Bookmark(
                    title = "Your bookmark title here",
                    italic = True,
                    bold = True,
                    color = Color(a=255,r=0,g=255,b=0),
                    level = 1,
                    page_display_left = 89,
                    page_display_top = 564,
                    page_display_zoom = 2,
                    page_number = 3
                )

                try:
                    response = self.pdf_api.post_bookmark(storageDocumentName, parentBookmark, [newBookmark], **args)

                    if response.code == 200:
                        temp_file = self.pdf_api.download_file(storageTempFolder + '/' + storageDocumentName)
                        local_path = localFolder + '/' + outputFileName
                        shutil.move(temp_file, local_path)
                        logging.info(f"append_bookmark(): Bookmark '{response.bookmarks.list[0].action}' successfully added to the document '{outputFileName}'.")
                    else:
                        logging.error(f"append_bookmark(): Failed to add bookmark in the document. Response code: {response.code}")
                except Exception as e:
                    logging.error(f"append_bookmark(): Error while adding bookmark: {e}")