PNG JPG BMP TIFF PDF
Aspose.PDF for Python

Python SDKを介してPDFにハイライトテキスト注釈を追加

Cloud Python SDKを使用してPDFドキュメントに注釈を追加するためのAPI。

Get Started
 

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

Overview

Buy

Cloud Python SDKを使用してPDFに注釈を追加する方法

PDFにハイライトテキスト注釈を追加するには、 Aspose.PDF Cloud Python SDKを使用します。このクラウドSDKは、PythonプログラマーがAspose.PDF REST APIを介してクラウドベースのPDFクリエーター、注釈者、エディター、コンバーターアプリをPythonプログラミング言語で開発するのを支援します。まず、Aspose for Cloudでアカウントを作成し、アプリケーション情報を取得します。App SIDとキーを入手したら、Aspose.PDF Cloud Python SDKを試す準備が整います。PythonパッケージがGithubにホストされている場合は、直接Githubからインストールできます。

Githubからのインストール


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

パッケージマネージャーコンソールコマンド

     
    pip install asposepdfcloud

Pythonを介してPDFに注釈を追加する手順

Aspose.PDF Cloudの開発者は、わずか数行のコードでPDFに注釈を簡単に読み込んで追加できます。

  1. Python SDKをインストールします。
  2. PDFをクラウドストレージにアップロードします。
  3. 定義された位置、色、テキスト、スタイリングで新しいハイライト注釈を作成します。
  4. Aspose Cloud APIを使用して特定のページに注釈を送信します。
  5. レスポンスを確認し、結果をログに記録します。
  6. 更新されたファイルをローカルで使用するためにダウンロードします。
 

Pythonを使用してPDFに注釈を追加


    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}")