Bạn có thể chú thích bất kỳ tài liệu PDF nào theo chương trình trên đám mây bằng Python. Nó có thể là bất kỳ thông tin bổ sung nào về một phần dữ liệu hiện có dưới dạng hình ảnh, nhận xét, ghi chú hoặc các loại nhận xét bên ngoài khác trong tài liệu. Trong bài viết này, bạn sẽ tìm hiểu cách chú thích tài liệu PDF bằng API REST trong Python.
Các chủ đề sau đây sẽ được đề cập trong bài viết này:
- Chú thích tài liệu API REST và Python SDK
- Chú thích tài liệu PDF bằng API REST trong Python
- Thêm chú thích TextField bằng Python
- Thêm chú thích hình ảnh bằng Python
- Chú thích với Chú thích liên kết bằng Python
Chú thích tài liệu API REST và Python SDK
Để chú thích tài liệu PDF, tôi sẽ sử dụng Python SDK của GroupDocs.Annotation Cloud API. Nó cho phép lập trình xây dựng các công cụ chú thích tài liệu trực tuyến. Bạn có thể thêm chú thích, lớp phủ hình mờ, thay thế văn bản, biên tập lại và đánh dấu văn bản vào các tài liệu kinh doanh ở tất cả các định dạng phổ biến. Nó cũng cung cấp SDK .NET, Java, PHP, Ruby và Node.js dưới dạng các thành viên dòng chú thích tài liệu cho Cloud API.
Bạn có thể cài đặt GroupDocs.Annotation Cloud cho dự án Python của mình bằng lệnh sau trong bảng điều khiển:
pip install groupdocs_annotation_cloud
Vui lòng lấy ID khách hàng và Bí mật khách hàng của bạn từ bảng điều khiển trước khi bạn bắt đầu làm theo các bước và ví dụ về mã có sẵn. Khi bạn có ID và bí mật của mình, hãy thêm mã như hình bên dưới:
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 = ""
Chú thích tài liệu PDF bằng API REST trong Python
Bạn có thể thêm chú thích vào Tài liệu PDF của mình bằng cách thực hiện theo các bước đơn giản dưới đây:
- Tải lên tệp PDF lên Đám mây
- Chú thích tài liệu PDF bằng Python
- Tải xuống tệp chú thích
Tải lên tài liệu
Đầu tiên, tải tệp PDF lên Đám mây bằng mẫu mã sau:
# tạo phiên bản của api
file_api = groupdocs_annotation_cloud.FileApi.from_config(configuration)
my_storage = ""
# tải lên tập tin mẫu
request = groupdocs_annotation_cloud.UploadFileRequest("sample.pdf", "C:\\Files\\sample.pdf", my_storage)
response = file_api.upload_file(request)
Do đó, tệp PDF đã tải lên sẽ có trong phần tệp trên trang tổng quan của bạn trên đám mây.
Chú thích tài liệu PDF bằng Python
Vui lòng làm theo các bước được đề cập bên dưới để thêm nhiều chú thích vào tài liệu PDF theo chương trình.
- Tạo một phiên bản của AnnotateApi
- Tạo phiên bản đầu tiên của AnnotationInfo
- Đặt thuộc tính chú thích cho trường hợp đầu tiên, ví dụ: vị trí, loại, văn bản, v.v.
- Tạo phiên bản thứ hai của AnnotationInfo
- Đặt các thuộc tính chú thích cho trường hợp thứ hai, ví dụ: vị trí, loại, văn bản, v.v.
- Tạo phiên bản thứ ba của AnnotationInfo
- Đặt thuộc tính chú thích cho trường hợp thứ ba, ví dụ: vị trí, loại, văn bản, v.v.
- Tạo một phiên bản FileInfo và đặt đường dẫn tệp đầu vào
- Tạo một phiên bản của AnnotateOptions và đặt thông tin tệp thành AnnotateOptions
- Chỉ định chú thích thứ nhất, thứ hai và thứ ba cho AnnotateOptions
- Tạo một yêu cầu bằng cách gọi phương thức AnnotateRequest
- Nhận kết quả bằng cách gọi phương thức AnnotateApi.annotate()
Mẫu mã sau đây cho biết cách chú thích tài liệu PDF và thêm nhiều chú thích bằng API REST.
# khởi tạo api
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)
# chú thích khoảng cách
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 chú thích khoảng cách"
a1.creator_name = "Anonym A."
# chú thích khu vực
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 chú thích khu vực"
a2.creator_name = "Anonym A."
# chú thích mũi tên
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 chú thích mũi tên"
a3.creator_name = "Anonym A."
# tập tin đầu vào
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"
# xác định tùy chọn chú thích
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1, a2, a3]
options.output_path = "output.pdf"
# tạo yêu cầu chú thích
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)
print("AddMultipleAnnotations: Multiple Annotations added: " + result['href'])
Thêm nhiều chú thích vào tài liệu PDF bằng API REST trong Python
Bạn có thể đọc thêm về các loại chú thích được hỗ trợ trong phần thêm chú thích trong tài liệu.
Tải xuống tệp chú thích
Mẫu mã trên sẽ lưu tệp PDF có chú thích trên đám mây. Bạn có thể tải xuống bằng mẫu mã sau:
# khởi tạo api
file_api = groupdocs_annotation_cloud.FileApi.from_config(configuration)
my_storage = ""
# tạo yêu cầu tải xuống
request = groupdocs_annotation_cloud.DownloadFileRequest("output.pdf", my_storage)
response = file_api.download_file(request)
# Di chuyển tệp đã tải xuống vào thư mục làm việc của bạn
shutil.move(response, "C:\\Files\\")
Thêm chú thích TextField bằng Python
Bạn có thể thêm chú thích trường Văn bản trong tài liệu PDF theo cách lập trình bằng cách thực hiện theo các bước dưới đây:
- Tạo một phiên bản của AnnotateApi
- Tạo một phiên bản của AnnotationInfo
- Xác định vị trí chú thích
- Xác định vị trí, chiều cao và chiều rộng của Hình chữ nhật
- Đặt các thuộc tính Chú thích khác nhau, ví dụ: văn bản, chiều cao, chiều rộng, v.v.
- Đặt loại chú thích là TextField
- Tạo một phiên bản FileInfo và đặt đường dẫn tệp đầu vào
- Tạo một phiên bản của AnnotateOptions và đặt thông tin tệp thành AnnotateOptions
- Gán chú thích cho AnnotateOptions
- Tạo một yêu cầu bằng cách gọi phương thức AnnotateRequest
- Nhận kết quả bằng cách gọi phương thức AnnotateApi.annotate()
Mẫu mã sau đây cho biết cách thêm chú thích trường văn bản trong tài liệu PDF bằng API REST. Vui lòng làm theo các bước được đề cập trước đó để tải lên và tải xuống tệp.
# khởi tạo api
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)
# cung cấp thông tin chú thích
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."
# đường dẫn tệp đầu vào
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"
# xác định tùy chọn chú thích
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1]
options.output_path = "output.pdf"
# tạo yêu cầu chú thích
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)
print("AddTextFieldAnnotation: Text Field Annotation added: " + result['href'])
Thêm chú thích trường văn bản bằng Python
Thêm chú thích hình ảnh bằng Python
Bạn có thể thêm chú thích hình ảnh vào tài liệu PDF của mình theo cách lập trình bằng cách thực hiện theo các bước dưới đây:
- Tạo một phiên bản của AnnotateApi
- Tạo một phiên bản của AnnotationInfo
- Xác định Hình chữ nhật và đặt vị trí, chiều cao và chiều rộng của nó
- Đặt các thuộc tính Chú thích khác nhau, ví dụ: vị trí, văn bản, chiều cao, chiều rộng, v.v.
- Đặt loại chú thích là Hình ảnh
- Tạo một phiên bản FileInfo và đặt đường dẫn tệp đầu vào
- Tạo một phiên bản của AnnotateOptions và đặt thông tin tệp thành AnnotateOptions
- Gán chú thích cho AnnotateOptions
- Tạo một yêu cầu bằng cách gọi phương thức AnnotateRequest
- Nhận kết quả bằng cách gọi phương thức AnnotateApi.annotate()
Mẫu mã sau đây cho biết cách thêm chú thích hình ảnh trong tài liệu PDF bằng API REST. Vui lòng làm theo các bước được đề cập trước đó để tải lên và tải xuống tệp.
# khởi tạo api
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)
# xác định chú thích
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"
# đường dẫn tệp đầu vào
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"
# xác định chú thích options
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1]
options.output_path = "output_img.pdf"
# tạo yêu cầu chú thích
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)
print("AddImageAnnotation: Image Annotation added: " + result['href'])
Thêm chú thích hình ảnh bằng Python
Chú thích với Chú thích liên kết bằng Python
Bạn có thể thêm chú thích siêu liên kết vào tài liệu PDF theo cách lập trình bằng cách thực hiện theo các bước dưới đây:
- Tạo một phiên bản của AnnotateApi
- Tạo một phiên bản của AnnotationInfo
- Xác định các điểm chú thích và đặt vị trí cho từng điểm
- Đặt các thuộc tính Chú thích khác nhau, ví dụ: văn bản, chiều cao, chiều rộng, v.v.
- Đặt loại chú thích là Liên kết
- Tạo một phiên bản FileInfo và đặt đường dẫn tệp đầu vào
- Tạo một phiên bản của AnnotateOptions và đặt thông tin tệp thành AnnotateOptions
- Gán chú thích cho AnnotateOptions
- Tạo một yêu cầu bằng cách gọi phương thức AnnotateRequest
- Nhận kết quả bằng cách gọi phương thức AnnotateApi.annotate()
Mẫu mã sau đây cho biết cách thêm chú thích siêu liên kết trong tài liệu PDF bằng API REST. Vui lòng làm theo các bước được đề cập trước đó để tải lên và tải xuống tệp.
# khởi tạo api
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)
# cung cấp thông tin chú thích
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/"
# đường dẫn tệp đầu vào
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"
# xác định các tùy chọn chú thích
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1]
options.output_path = "output.pdf"
# tạo yêu cầu chú thích
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)
print("AddLinkAnnotation: Link Annotation added: " + result['href'])
Chú thích với Chú thích liên kết bằng Python
Thử trực tuyến
Vui lòng thử công cụ chú thích PDF trực tuyến miễn phí sau đây, được phát triển bằng cách sử dụng API ở trên. https://products.groupdocs.app/annotation/pdf
Phần kết luận
Trong bài viết này, bạn đã học cách thêm nhiều loại chú thích khác nhau vào tài liệu PDF trên đám mây. Hơn nữa, bạn đã học cách lập trình tải tệp PDF lên đám mây và sau đó tải xuống tệp có chú thích từ đám mây. Bạn có thể tìm hiểu thêm về GroupDocs.Annotation Cloud API bằng cách sử dụng tài liệu. Chúng tôi cũng cung cấp phần Tham khảo API cho phép bạn hình dung và tương tác trực tiếp với các API của chúng tôi thông qua trình duyệt. Trong trường hợp có bất kỳ sự mơ hồ nào, vui lòng liên hệ với chúng tôi trên diễn đàn.