คุณสามารถใส่คำอธิบายประกอบเอกสาร PDF โดยทางโปรแกรมบนคลาวด์โดยใช้ Python อาจเป็นข้อมูลเพิ่มเติมใดๆ เกี่ยวกับข้อมูลที่มีอยู่ในรูปแบบของรูปภาพ ความคิดเห็น บันทึกย่อ หรือข้อสังเกตภายนอกประเภทอื่นๆ ในเอกสาร ในบทความนี้ คุณจะได้เรียนรู้วิธีใส่คำอธิบายประกอบในเอกสาร PDF โดยใช้ REST API ใน Python
หัวข้อต่อไปนี้จะครอบคลุมในบทความนี้:
- คำอธิบายประกอบเอกสาร REST API และ Python SDK
- ใส่คำอธิบายประกอบเอกสาร PDF โดยใช้ REST API ใน Python
- เพิ่มคำอธิบายประกอบ TextField โดยใช้ Python
- เพิ่มคำอธิบายประกอบรูปภาพโดยใช้ Python
- คำอธิบายประกอบกับคำอธิบายประกอบลิงก์โดยใช้ Python
คำอธิบายประกอบเอกสาร REST API และ Python SDK
สำหรับการเพิ่มคำอธิบายประกอบในเอกสาร PDF ฉันจะใช้ API ของ Python SDK of GroupDocs.Annotation Cloud อนุญาตให้สร้างเครื่องมือบันทึกย่อเอกสารทางออนไลน์โดยทางโปรแกรม คุณสามารถเพิ่มคำอธิบายประกอบ การซ้อนทับลายน้ำ การแทนที่ข้อความ การแก้ไข และมาร์กอัปข้อความในเอกสารทางธุรกิจในรูปแบบยอดนิยมทั้งหมด นอกจากนี้ยังมี .NET, Java, PHP, Ruby และ Node.js SDK เป็น สมาชิกตระกูลคำอธิบายประกอบของเอกสาร สำหรับ Cloud API
คุณสามารถติดตั้ง GroupDocs.Annotation Cloud ในโครงการ Python ของคุณโดยใช้คำสั่งต่อไปนี้ในคอนโซล:
pip install groupdocs_annotation_cloud
โปรดรับรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ของคุณจาก แดชบอร์ด ก่อนที่คุณจะเริ่มทำตามขั้นตอนและตัวอย่างโค้ดที่มีอยู่ เมื่อคุณมี ID และรหัสลับของคุณแล้ว ให้เพิ่มรหัสตามที่แสดงด้านล่าง:
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 ของคุณโดยทำตามขั้นตอนง่ายๆ ด้านล่าง:
- อัปโหลด ไฟล์ PDF ไปยังคลาวด์
- ใส่คำอธิบายประกอบเอกสาร PDF โดยใช้ Python
- ดาวน์โหลด ไฟล์คำอธิบายประกอบ
อัปโหลดเอกสาร
ประการแรก อัปโหลดไฟล์ PDF ไปยัง Cloud โดยใช้ตัวอย่างโค้ดต่อไปนี้:
# สร้างตัวอย่างของ 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 ที่มีคำอธิบายประกอบไว้บนคลาวด์ คุณสามารถดาวน์โหลดได้โดยใช้ตัวอย่างโค้ดต่อไปนี้:
# การเริ่มต้น 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
- กำหนดตำแหน่งคำอธิบายประกอบ
- กำหนดตำแหน่งสี่เหลี่ยมผืนผ้า ความสูง และความกว้าง
- กำหนดคุณสมบัติ Annotation ได้หลากหลาย เช่น ข้อความ ความสูง ความกว้าง เป็นต้น
- กำหนดประเภทคำอธิบายประกอบเป็น 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
คุณสามารถเพิ่มคำอธิบายประกอบรูปภาพในเอกสาร PDF ของคุณโดยทางโปรแกรมโดยทำตามขั้นตอนด้านล่าง:
- สร้างอินสแตนซ์ของ AnnotateApi
- สร้างอินสแตนซ์ของ AnnotationInfo
- กำหนดสี่เหลี่ยมผืนผ้าและกำหนดตำแหน่ง ความสูง และความกว้าง
- กำหนดคุณสมบัติ Annotation ได้หลากหลาย เช่น ตำแหน่ง ข้อความ ความสูง ความกว้าง ฯลฯ
- ตั้งค่าประเภทคำอธิบายประกอบเป็นรูปภาพ
- สร้างอินสแตนซ์ 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
- กำหนดจุดคำอธิบายประกอบและกำหนดตำแหน่งสำหรับแต่ละจุด
- กำหนดคุณสมบัติ Annotation ได้หลากหลาย เช่น ข้อความ ความสูง ความกว้าง เป็นต้น
- กำหนดประเภทคำอธิบายประกอบเป็นลิงก์
- สร้างอินสแตนซ์ 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
ลองออนไลน์
โปรดลองใช้เครื่องมือคำอธิบายประกอบ PDF ออนไลน์ฟรีต่อไปนี้ ซึ่งพัฒนาโดยใช้ API ข้างต้น https://products.groupdocs.app/annotation/pdf
บทสรุป
ในบทความนี้ คุณได้เรียนรู้วิธีเพิ่มคำอธิบายประกอบประเภทต่างๆ ลงในเอกสาร PDF บนระบบคลาวด์ นอกจากนี้ คุณยังได้เรียนรู้วิธีอัปโหลดไฟล์ PDF บนระบบคลาวด์โดยใช้โปรแกรม จากนั้นดาวน์โหลดไฟล์ที่มีคำอธิบายประกอบจากระบบคลาวด์ คุณสามารถเรียนรู้เพิ่มเติมเกี่ยวกับ GroupDocs.Annotation Cloud API โดยใช้ เอกสารประกอบ เรายังมีส่วน API Reference ที่ช่วยให้คุณแสดงภาพและโต้ตอบกับ API ของเราได้โดยตรงผ่านเบราว์เซอร์ ในกรณีที่มีความคลุมเครือ โปรดติดต่อเราได้ที่ ฟอรัม