Анотуйте PDF-документи за допомогою Python

Ви можете коментувати будь-який PDF-документ програмно в хмарі за допомогою Python. Це може бути будь-яка додаткова інформація про наявну частину даних у формі зображень, коментарів, приміток або інших типів зовнішніх зауважень у документі. У цій статті ви дізнаєтесь, як анотувати PDF-документи за допомогою REST API у Python.

У цій статті будуть розглянуті такі теми:

Анотація документа REST API та Python SDK

Для анотування PDF документів я буду використовувати API Python SDK GroupDocs.Annotation Cloud. Це дозволяє програмно створювати інструменти для анотування документів в Інтернеті. Ви можете додавати анотації, накладення водяних знаків, заміни тексту, редагування та текстові розмітки до ділових документів усіх популярних форматів. Він також надає .NET, Java, PHP, Ruby та Node.js SDK як члени сімейства анотацій документів для Cloud API.

Ви можете встановити GroupDocs.Annotation Cloud у свій проект Python за допомогою такої команди в консолі:

pip install groupdocs_annotation_cloud

Будь ласка, отримайте свій ідентифікатор клієнта та секрет клієнта з інформаційної панелі, перш ніж почати виконувати кроки та доступні приклади коду. Отримавши ідентифікатор і секрет, додайте код, як показано нижче:

client_id = "659fe7da-715b-4744-a0f7-cf469a392b73"
client_secret = "b377c36cfa28fa69960ebac6b6e36421"

configuration = groupdocs_annotation_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
my_storage = ""

Анотуйте PDF-документи за допомогою REST API у Python

Ви можете додати анотації до своїх PDF-документів, виконавши прості кроки, наведені нижче:

  1. Завантажте файл PDF у хмару
  2. Коментування PDF-документів за допомогою Python
  3. Завантажити анотований файл

Завантажте документ

По-перше, завантажте PDF-файл у хмару, використовуючи такий зразок коду:

# створити екземпляр API
file_api = groupdocs_annotation_cloud.FileApi.from_config(configuration)
my_storage = ""

# завантажити файл зразка
request = groupdocs_annotation_cloud.UploadFileRequest("sample.pdf", "C:\\Files\\sample.pdf", my_storage)
response = file_api.upload_file(request)

У результаті завантажений PDF-файл буде доступний у розділі файлів вашої інформаційної панелі в хмарі.

Анотуйте PDF-документи за допомогою Python

Будь ласка, виконайте наведені нижче кроки, щоб програмно додати кілька анотацій до документа PDF.

  • Створіть екземпляр AnnotateApi
  • Створіть перший екземпляр AnnotationInfo
  • Встановіть властивості анотації для першого екземпляра, наприклад положення, тип, текст тощо.
  • Створіть другий екземпляр AnnotationInfo
  • Встановіть властивості анотації для другого екземпляра, наприклад положення, тип, текст тощо.
  • Створіть третій екземпляр AnnotationInfo
  • Встановіть властивості анотації для третього екземпляра, наприклад положення, тип, текст тощо.
  • Створіть екземпляр FileInfo та встановіть шлях до вхідного файлу
  • Створіть екземпляр AnnotateOptions і встановіть для інформації про файл значення AnnotateOptions
  • Призначте першу, другу та третю анотації AnnotateOptions
  • Створіть запит, викликавши метод AnnotateRequest
  • Отримайте результати, викликавши метод AnnotateApi.annotate().

У наведеному нижче прикладі коду показано, як анотувати PDF-документ і додати кілька анотацій за допомогою REST API.

# ініціалізувати api
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)

# анотація відстані
a1 = groupdocs_annotation_cloud.AnnotationInfo()
a1.annotation_position = groupdocs_annotation_cloud.Point()
a1.annotation_position.x = 1
a1.annotation_position.y = 1
a1.box = groupdocs_annotation_cloud.Rectangle()
a1.box.x = 100
a1.box.y = 100
a1.box.width = 200
a1.box.height = 200
a1.page_number = 0
a1.pen_color = 1201033
a1.pen_style = "Solid"
a1.pen_width = 3
a1.opacity = 1
a1.type = "Distance"
a1.text = "This is анотація відстані"
a1.creator_name = "Anonym A."

# анотація області
a2 = groupdocs_annotation_cloud.AnnotationInfo()
a2.annotation_position = groupdocs_annotation_cloud.Point()
a2.annotation_position.x = 1
a2.annotation_position.y = 1
a2.box = groupdocs_annotation_cloud.Rectangle()
a2.box.x = 100
a2.box.y = 400
a2.box.width = 200
a2.box.height = 100
a2.page_number = 0
a2.pen_color = 1201033
a2.pen_style = "Solid"
a2.pen_width = 3
a2.opacity = 1
a2.type = "Area"
a2.text = "This is анотація області"
a2.creator_name = "Anonym A."

# анотація зі стрілкою
a3 = groupdocs_annotation_cloud.AnnotationInfo()
a3.annotation_position = groupdocs_annotation_cloud.Point()
a3.annotation_position.x = 1
a3.annotation_position.y = 1
a3.box = groupdocs_annotation_cloud.Rectangle()
a3.box.x = 100
a3.box.y = 250
a3.box.width = 100
a3.box.height = 50
a3.page_number = 0
a3.pen_color = 1201033
a3.pen_style = "Solid"
a3.pen_width = 1
a3.opacity = 0.7
a3.type = "Arrow"
a3.text = "This is анотація зі стрілкою"
a3.creator_name = "Anonym A."

# вхідний файл
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"

# визначити параметри анотації
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1, a2, a3]
options.output_path = "output.pdf"

# створити запит на анотацію
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)         

print("AddMultipleAnnotations: Multiple Annotations added: " + result['href'])
Додайте кілька анотацій до PDF-документа за допомогою REST API у Python

Додайте кілька анотацій до PDF-документа за допомогою REST API у Python

Ви можете прочитати більше про підтримувані типи анотацій у розділі додавання анотацій документації.

Завантажте анотований файл

Наведений вище зразок коду збереже анотований PDF-файл у хмарі. Ви можете завантажити його за допомогою наступного зразка коду:

# ініціалізація API
file_api = groupdocs_annotation_cloud.FileApi.from_config(configuration)
my_storage = ""

# створити запит на завантаження
request = groupdocs_annotation_cloud.DownloadFileRequest("output.pdf", my_storage)
response = file_api.download_file(request)

# Перемістіть завантажений файл у робочий каталог
shutil.move(response, "C:\\Files\\")

Додайте анотації TextField за допомогою Python

Ви можете додати анотації до текстових полів у PDF-документи програмним шляхом, виконавши наведені нижче дії.

  • Створіть екземпляр AnnotateApi
  • Створіть екземпляр AnnotationInfo
  • Визначте позицію анотації
  • Визначте положення, висоту та ширину прямокутника
  • Встановіть різні властивості анотації, наприклад текст, висоту, ширину тощо.
  • Установіть тип анотації як TextField
  • Створіть екземпляр FileInfo та встановіть шлях до вхідного файлу
  • Створіть екземпляр AnnotateOptions і встановіть для інформації про файл значення AnnotateOptions
  • Призначте анотацію AnnotateOptions
  • Створіть запит, викликавши метод AnnotateRequest
  • Отримайте результати, викликавши метод AnnotateApi.annotate().

У наведеному нижче прикладі коду показано, як додати анотації текстових полів у PDF-документ за допомогою REST API. Будь ласка, виконайте кроки, згадані раніше, щоб завантажити та завантажити файл.

# ініціалізувати api
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)

# надати анотаційну інформацію
a1 = groupdocs_annotation_cloud.AnnotationInfo()
a1.annotation_position = groupdocs_annotation_cloud.Point()
a1.annotation_position.x = 1
a1.annotation_position.y = 1
a1.box = groupdocs_annotation_cloud.Rectangle()
a1.box.x = 380
a1.box.y = 300
a1.box.width = 100
a1.box.height = 50
a1.page_number = 0
a1.font_color = 1201033
a1.font_size = 12
a1.opacity = 0.7
a1.type = "TextField"           
a1.text = "Text field text"
a1.creator_name = "Anonym A."

# шлях до вхідного файлу
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"

# визначити параметри анотації
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1]
options.output_path = "output.pdf"

# створити запит на анотацію
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)         

print("AddTextFieldAnnotation: Text Field Annotation added: " + result['href'])
Додайте анотації текстових полів за допомогою Python

Додайте анотації текстових полів за допомогою Python

Додайте анотації до зображень за допомогою Python

Ви можете додавати анотації до зображень у свої PDF-документи програмним шляхом, виконавши наведені нижче дії.

  • Створіть екземпляр AnnotateApi
  • Створіть екземпляр AnnotationInfo
  • Визначте прямокутник і встановіть його положення, висоту та ширину
  • Встановіть різні властивості анотації, наприклад положення, текст, висоту, ширину тощо.
  • Установіть тип анотації як зображення
  • Створіть екземпляр FileInfo та встановіть шлях до вхідного файлу
  • Створіть екземпляр AnnotateOptions і встановіть для інформації про файл значення AnnotateOptions
  • Призначте анотацію AnnotateOptions
  • Створіть запит, викликавши метод AnnotateRequest
  • Отримайте результати, викликавши метод AnnotateApi.annotate().

У наведеному нижче прикладі коду показано, як додати анотації до зображення в PDF-документ за допомогою REST API. Будь ласка, виконайте кроки, згадані раніше, щоб завантажити та завантажити файл.

# ініціалізувати api
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)

# визначити анотацію
a1 = groupdocs_annotation_cloud.AnnotationInfo()
a1.box = groupdocs_annotation_cloud.Rectangle()
a1.box.x = 300
a1.box.y = 300
a1.box.width = 200
a1.box.height = 100
a1.page_number = 0
a1.pen_color = 1201033
a1.pen_style = "Solid"
a1.pen_width = 1
a1.opacity = 0.7
a1.type = "Image"
a1.text = "This is Image annotation"
a1.creator_name = "Anonym A."
a1.image_path = "JohnSmith.png"

# шлях до вхідного файлу
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"

# визначити анотацію options
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1]
options.output_path = "output_img.pdf"

# створити запит на анотацію
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)         

print("AddImageAnnotation: Image Annotation added: " + result['href'])
Додайте анотації до зображень за допомогою Python

Додайте анотації до зображень за допомогою Python

Ви можете додавати анотації гіперпосилань у PDF-документи програмним шляхом, виконавши наведені нижче дії.

  • Створіть екземпляр AnnotateApi
  • Створіть екземпляр AnnotationInfo
  • Визначте точки анотації та встановіть положення для кожної точки
  • Встановіть різні властивості анотації, наприклад текст, висоту, ширину тощо.
  • Установіть тип анотації як посилання
  • Створіть екземпляр FileInfo та встановіть шлях до вхідного файлу
  • Створіть екземпляр AnnotateOptions і встановіть для інформації про файл значення AnnotateOptions
  • Призначте анотацію AnnotateOptions
  • Створіть запит, викликавши метод AnnotateRequest
  • Отримайте результати, викликавши метод AnnotateApi.annotate().

У наведеному нижче прикладі коду показано, як додати анотації гіперпосилань у PDF-документ за допомогою REST API. Будь ласка, виконайте кроки, згадані раніше, щоб завантажити та завантажити файл.

# ініціалізувати api
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)

# надати анотаційну інформацію
a1 = groupdocs_annotation_cloud.AnnotationInfo()
p1 = groupdocs_annotation_cloud.Point()
p1.x = 80
p1.y = 710
p2 = groupdocs_annotation_cloud.Point()
p2.x = 240
p2.y = 710
p3 = groupdocs_annotation_cloud.Point()
p3.x = 80
p3.y = 650
p4 = groupdocs_annotation_cloud.Point()
p4.x = 240
p4.y = 650
a1.points = [p1, p2, p3, p4]
a1.page_number = 0
a1.type = "Link"
a1.text = "This is Link annotation"
a1.creator_name = "Anonym A."
a1.url = "https://www.groupdocs.com/"

# шлях до вхідного файлу
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"

# визначити параметри анотації
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1]
options.output_path = "output.pdf"

# створити запит на анотацію
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)         

print("AddLinkAnnotation: Link Annotation added: " + result['href'])
Додайте анотації за допомогою анотацій посилань за допомогою Python

Додайте анотації за допомогою анотацій посилань за допомогою Python

Спробуйте онлайн

Будь ласка, спробуйте наведений нижче безкоштовний онлайн-інструмент анотування PDF-файлів, розроблений за допомогою вищезазначеного API. https://products.groupdocs.app/annotation/pdf

Висновок

У цій статті ви дізналися, як додавати різні типи анотацій до документів PDF у хмарі. Крім того, ви навчилися програмно завантажувати PDF-файл у хмару, а потім завантажувати анотований файл із хмари. Ви можете дізнатися більше про GroupDocs.Annotation Cloud API за допомогою документації. Ми також надаємо розділ API Reference, який дозволяє візуалізувати наші API та взаємодіяти з ними безпосередньо через браузер. У разі будь-яких неясностей зв’яжіться з нами на форумі.

Дивись також