PNG JPG BMP TIFF PDF
Aspose.PDF para Python

Adicionar Anotações de Texto Destacado a PDF via Python SDK

API para adicionar anotações a documentos PDF usando Cloud Python SDK.

Get Started
 

Aspose.PDF Cloud SDK para Python Aspose.PDF Cloud SDK para Python

Overview

Buy

Como adicionar Anotações a PDF via Cloud Python SDK

Para adicionar anotações de Texto Destacado em PDF, usaremos Aspose.PDF Cloud Python SDK. Este Cloud SDK auxilia programadores Python no desenvolvimento de aplicativos de criação, anotação, edição e conversão de PDFs baseados em nuvem usando a linguagem de programação Python via Aspose.PDF REST API. Basta criar uma conta em Aspose for Cloud e obter suas informações de aplicativo. Uma vez que você tenha o App SID & key, você está pronto para usar o Aspose.PDF Cloud Python SDK. Se o pacote python estiver hospedado no Github, você pode instalar diretamente do Github:

Instalação do Github


     
    pip install git+https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-python.git

Comando do Console do Gerenciador de Pacotes

     
    pip install asposepdfcloud

Passos para adicionar anotações a PDF via Python

Os desenvolvedores do Aspose.PDF Cloud podem facilmente carregar e adicionar anotações a PDF em apenas algumas linhas de código.

  1. Instale o Python SDK.
  2. Carregue o PDF no armazenamento em nuvem.
  3. Crie uma nova anotação de destaque com posição, cor, texto e estilo definidos.
  4. Envie a anotação para a página especificada usando a Aspose Cloud API.
  5. Verifique a resposta e registre o resultado.
  6. Baixe o arquivo atualizado para uso local.
 

Adicionar Anotações a PDF usando Python


    from annotations_helper import Config, PdfAnnotationsHelper, logging
    from asposepdfcloud import PdfApi, HighlightAnnotation, Rectangle, Color, Point, AnnotationFlags, HorizontalAlignment, VerticalAlignment

    class PdfAddHighlightAnnotations:
        """Class for managing PDF annotations using Aspose PDF Cloud API."""
        def __init__(self, pdf_api: PdfApi, helper: PdfAnnotationsHelper):
            self.pdfApi = pdf_api
            self.helper = helper

        def append_highlight_annotation(self):
            """Append a new highlight text annotation to the PDF document."""
            if self.pdfApi:
                self.helper.uploadFile(Config.PDF_DOCUMENT_NAME, Config.LOCAL_FOLDER, Config.REMOTE_FOLDER)

                args = {
                    "folder": Config.REMOTE_FOLDER
                }

                new_annotation = HighlightAnnotation(
                    rect = Rectangle(llx=100, lly=350, urx=450, ury=400),
                    name = 'Highlight_Text_Annotation',
                    flags = [AnnotationFlags.DEFAULT],
                    horizontal_alignment = HorizontalAlignment.LEFT,
                    vertical_alignment = VerticalAlignment.TOP,
                    rich_text = Config.NEW_HL_ANNOTATION_TEXT,
                    subject = Config.NEW_HL_ANNOTATION_SUBJECT,
                    contents= Config.NEW_HL_ANNOTATION_CONTENTS,
                    title = Config.NEW_HL_ANNOTATION_DESCRIPTION,
                    z_index = 1,
                    color=Color(a=0xFF, r=0, g=0xFF, b=0),
                    quad_points = [
                        Point(10, 10),
                        Point(20, 10),
                        Point(10, 20),
                        Point(10, 10)
                    ],
                    modified = '03/27/2025 00:00:00.000 AM',
                )
                try:
                    response = self.pdfApi.post_page_highlight_annotations(Config.PDF_DOCUMENT_NAME, Config.PAGE_NUMBER, [new_annotation], **args)
                    if response.code == 200:
                        logging.info(f"append_highlight_annotation(): annotation '{Config.NEW_HL_ANNOTATION_TEXT}' added to the document '{Config.PDF_DOCUMENT_NAME}'.")
                        self.helper.downloadFile(Config.PDF_DOCUMENT_NAME, Config.LOCAL_RESULT_DOCUMENT_NAME, Config.LOCAL_FOLDER, Config.REMOTE_FOLDER, "add_highlight_")
                    else:
                        logging.error(f"append_highlight_annotation(): Failed to add annotation to the document. Response code: {response.code}")
                except Exception as e:
                    logging.error(f"append_highlight_annotation(): Error while adding annotation: {e}")