PNG JPG BMP TIFF PDF
Aspose.PDF for Python

Thêm Chú Thích Văn Bản Đánh Dấu vào PDF qua Python SDK

API để thêm chú thích vào tài liệu PDF bằng Cloud Python SDK.

Get Started
 

Aspose.PDF Cloud SDK for Python Aspose.PDF Cloud SDK for Python

Overview

Buy

Cách thêm Chú Thích vào PDF qua Cloud Python SDK

Để thêm chú thích văn bản đánh dấu vào PDF, chúng ta sẽ sử dụng Aspose.PDF Cloud Python SDK. Cloud SDK này hỗ trợ các lập trình viên Python phát triển các ứng dụng tạo, chú thích, chỉnh sửa và chuyển đổi PDF dựa trên đám mây bằng ngôn ngữ lập trình Python thông qua Aspose.PDF REST API. Chỉ cần tạo một tài khoản tại Aspose for Cloud và nhận thông tin ứng dụng của bạn. Khi bạn có App SID & key, bạn đã sẵn sàng sử dụng Aspose.PDF Cloud Python SDK. Nếu gói python được lưu trữ trên Github, bạn có thể cài đặt trực tiếp từ Github:

Cài đặt từ Github


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

Lệnh Console Trình Quản Lý Gói

     
    pip install asposepdfcloud

Các Bước Thêm Chú Thích vào PDF qua Python

Các nhà phát triển Aspose.PDF Cloud có thể dễ dàng tải và thêm chú thích vào PDF chỉ trong vài dòng mã.

  1. Cài đặt Python SDK.
  2. Tải lên PDF vào lưu trữ đám mây.
  3. Tạo chú thích đánh dấu mới với vị trí, màu sắc, văn bản và phong cách đã định.
  4. Gửi chú thích đến trang được chỉ định bằng API Aspose Cloud.
  5. Kiểm tra phản hồi và ghi nhật ký kết quả.
  6. Tải xuống tệp đã cập nhật để sử dụng cục bộ.
 

Thêm Chú Thích vào PDF bằng 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}")