Anda dapat membuat anotasi dokumen PDF apa pun secara terprogram di cloud menggunakan Python. Ini bisa berupa informasi tambahan apa pun tentang bagian data yang ada dalam bentuk gambar, komentar, catatan, atau jenis komentar eksternal lainnya dalam dokumen. Pada artikel ini, Anda akan mempelajari cara membuat anotasi dokumen PDF menggunakan REST API dengan Python.
Topik-topik berikut akan dibahas dalam artikel ini:
- Dokumen Anotasi REST API dan Python SDK
- Anotasi Dokumen PDF menggunakan REST API dengan Python
- Tambahkan Anotasi TextField menggunakan Python
- Tambahkan Anotasi Gambar menggunakan Python
- Beri anotasi dengan Anotasi Tautan menggunakan Python
Dokumen Anotasi REST API dan Python SDK
Untuk menganotasi dokumen PDF, saya akan menggunakan Python SDK of GroupDocs.Annotation Cloud API. Ini memungkinkan untuk membuat alat anotasi dokumen secara terprogram secara online. Anda dapat menambahkan anotasi, overlay tanda air, penggantian teks, redaksi, dan markup teks ke dokumen bisnis dari semua format populer. Ini juga menyediakan SDK .NET, Java, PHP, Ruby, dan Node.js sebagai anggota keluarga anotasi dokumen untuk Cloud API.
Anda dapat menginstal GroupDocs.Annotation Cloud ke proyek Python Anda menggunakan perintah berikut di konsol:
pip install groupdocs_annotation_cloud
Dapatkan ID Klien dan Rahasia Klien Anda dari dashboard sebelum Anda mulai mengikuti langkah-langkah dan contoh kode yang tersedia. Setelah Anda memiliki ID dan rahasia Anda, tambahkan kode seperti yang ditunjukkan di bawah ini:
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 = ""
Anotasi Dokumen PDF menggunakan REST API dengan Python
Anda dapat menambahkan anotasi ke Dokumen PDF Anda dengan mengikuti langkah-langkah sederhana yang diberikan di bawah ini:
- Unggah file PDF ke Cloud
- Anotasi Dokumen PDF menggunakan Python
- Unduh file beranotasi
Unggah Dokumen
Pertama, unggah file PDF ke Cloud menggunakan contoh kode berikut:
# buat instance dari api
file_api = groupdocs_annotation_cloud.FileApi.from_config(configuration)
my_storage = ""
# mengunggah file contoh
request = groupdocs_annotation_cloud.UploadFileRequest("sample.pdf", "C:\\Files\\sample.pdf", my_storage)
response = file_api.upload_file(request)
Hasilnya, file PDF yang diunggah akan tersedia di bagian file dasbor Anda di cloud.
Anotasi Dokumen PDF menggunakan Python
Silakan ikuti langkah-langkah yang disebutkan di bawah ini untuk menambahkan beberapa anotasi ke dokumen PDF secara terprogram.
- Buat instance AnnotateApi
- Buat instance pertama dari AnnotationInfo
- Tetapkan properti anotasi untuk contoh pertama misalnya posisi, jenis, teks, dll.
- Buat instance kedua AnnotationInfo
- Tetapkan properti anotasi untuk contoh kedua misalnya posisi, jenis, teks, dll.
- Buat instance ketiga AnnotationInfo
- Tetapkan properti anotasi untuk contoh ketiga misalnya posisi, jenis, teks, dll.
- Buat instance FileInfo dan atur jalur file input
- Buat instance AnnotateOptions dan setel info file ke AnnotateOptions
- Tetapkan anotasi pertama, kedua, dan ketiga ke AnnotateOptions
- Buat permintaan dengan memanggil metode AnnotateRequest
- Dapatkan hasil dengan memanggil metode AnnotateApi.annotate().
Contoh kode berikut menunjukkan cara membuat anotasi dokumen PDF dan menambahkan beberapa anotasi menggunakan REST API.
# inisialisasi api
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)
# anotasi jarak
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 anotasi jarak"
a1.creator_name = "Anonym A."
# anotasi daerah
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 anotasi daerah"
a2.creator_name = "Anonym A."
# anotasi panah
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 anotasi panah"
a3.creator_name = "Anonym A."
# berkas masukan
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"
# menentukan opsi anotasi
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1, a2, a3]
options.output_path = "output.pdf"
# membuat permintaan anotasi
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)
print("AddMultipleAnnotations: Multiple Annotations added: " + result['href'])
Tambahkan Banyak Anotasi ke Dokumen PDF menggunakan REST API dengan Python
Anda dapat membaca selengkapnya tentang jenis anotasi yang didukung di bagian menambahkan anotasi dalam dokumentasi.
Unduh File Beranotasi
Contoh kode di atas akan menyimpan file PDF beranotasi di cloud. Anda dapat mengunduhnya menggunakan contoh kode berikut:
# inisialisasi api
file_api = groupdocs_annotation_cloud.FileApi.from_config(configuration)
my_storage = ""
# buat permintaan unduhan
request = groupdocs_annotation_cloud.DownloadFileRequest("output.pdf", my_storage)
response = file_api.download_file(request)
# Pindahkan file yang diunduh ke direktori kerja Anda
shutil.move(response, "C:\\Files\\")
Tambahkan Anotasi TextField menggunakan Python
Anda dapat menambahkan anotasi bidang Teks dalam dokumen PDF secara terprogram dengan mengikuti langkah-langkah berikut:
- Buat instance AnnotateApi
- Buat instance AnnotationInfo
- Tentukan posisi anotasi
- Tentukan posisi persegi panjang, tinggi, dan lebar
- Atur berbagai properti Anotasi misalnya teks, tinggi, lebar, dll.
- Setel jenis anotasi sebagai TextField
- Buat instance FileInfo dan atur jalur file input
- Buat instance AnnotateOptions dan setel info file ke AnnotateOptions
- Tetapkan anotasi ke AnnotateOptions
- Buat permintaan dengan memanggil metode AnnotateRequest
- Dapatkan hasil dengan memanggil metode AnnotateApi.annotate().
Contoh kode berikut menunjukkan cara menambahkan anotasi bidang teks dalam dokumen PDF menggunakan REST API. Silakan ikuti langkah-langkah yang disebutkan sebelumnya untuk mengunggah dan mengunduh file.
# inisialisasi api
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)
# memberikan informasi anotasi
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."
# jalur file masukan
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"
# menentukan opsi anotasi
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1]
options.output_path = "output.pdf"
# membuat permintaan anotasi
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)
print("AddTextFieldAnnotation: Text Field Annotation added: " + result['href'])
Tambahkan Anotasi Bidang Teks menggunakan Python
Tambahkan Anotasi Gambar menggunakan Python
Anda dapat menambahkan anotasi gambar dalam dokumen PDF Anda secara terprogram dengan mengikuti langkah-langkah berikut:
- Buat instance AnnotateApi
- Buat instance AnnotationInfo
- Tentukan Rectangle dan atur posisi, tinggi, dan lebarnya
- Atur berbagai properti Anotasi misalnya posisi, teks, tinggi, lebar, dll.
- Setel jenis anotasi sebagai Gambar
- Buat instance FileInfo dan atur jalur file input
- Buat instance AnnotateOptions dan setel info file ke AnnotateOptions
- Tetapkan anotasi ke AnnotateOptions
- Buat permintaan dengan memanggil metode AnnotateRequest
- Dapatkan hasil dengan memanggil metode AnnotateApi.annotate().
Contoh kode berikut menunjukkan cara menambahkan anotasi gambar dalam dokumen PDF menggunakan REST API. Silakan ikuti langkah-langkah yang disebutkan sebelumnya untuk mengunggah dan mengunduh file.
# inisialisasi api
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)
# menentukan anotasi
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"
# jalur file masukan
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"
# menentukan anotasi options
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1]
options.output_path = "output_img.pdf"
# membuat permintaan anotasi
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)
print("AddImageAnnotation: Image Annotation added: " + result['href'])
Tambahkan Anotasi Gambar menggunakan Python
Beri anotasi dengan Anotasi Tautan menggunakan Python
Anda dapat menambahkan anotasi hyperlink dalam dokumen PDF secara terprogram dengan mengikuti langkah-langkah berikut:
- Buat instance AnnotateApi
- Buat instance AnnotationInfo
- Tentukan titik anotasi dan atur posisi untuk setiap titik
- Atur berbagai properti Anotasi misalnya teks, tinggi, lebar, dll.
- Setel jenis anotasi sebagai Tautan
- Buat instance FileInfo dan atur jalur file input
- Buat instance AnnotateOptions dan setel info file ke AnnotateOptions
- Tetapkan anotasi ke AnnotateOptions
- Buat permintaan dengan memanggil metode AnnotateRequest
- Dapatkan hasil dengan memanggil metode AnnotateApi.annotate().
Contoh kode berikut menunjukkan cara menambahkan anotasi hyperlink di dokumen PDF menggunakan REST API. Silakan ikuti langkah-langkah yang disebutkan sebelumnya untuk mengunggah dan mengunduh file.
# inisialisasi api
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)
# memberikan informasi anotasi
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/"
# jalur file masukan
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"
# menentukan opsi anotasi
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1]
options.output_path = "output.pdf"
# membuat permintaan anotasi
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)
print("AddLinkAnnotation: Link Annotation added: " + result['href'])
Beri anotasi dengan Anotasi Tautan menggunakan Python
Coba Daring
Silakan coba alat anotasi PDF online gratis berikut, yang dikembangkan menggunakan API di atas. https://products.groupdocs.app/annotation/pdf
Kesimpulan
Pada artikel ini, Anda telah mempelajari cara menambahkan berbagai jenis anotasi ke dokumen PDF di cloud. Selain itu, Anda telah mempelajari cara mengunggah file PDF secara terprogram di cloud dan kemudian mengunduh file beranotasi dari cloud. Anda dapat mempelajari lebih lanjut tentang GroupDocs.Annotation Cloud API menggunakan dokumentasi. Kami juga menyediakan bagian Referensi API yang memungkinkan Anda memvisualisasikan dan berinteraksi dengan API kami secara langsung melalui browser. Jika ada ambiguitas, jangan ragu untuk menghubungi kami di forum.