حاشیه نویسی اسناد PDF با استفاده از REST API در پایتون

حاشیه نویسی اسناد PDF با استفاده از پایتون

شما می توانید هر سند PDF را به صورت برنامه نویسی در ابر با استفاده از پایتون حاشیه نویسی کنید. این می تواند هر گونه اطلاعات اضافی در مورد یک قطعه داده موجود در قالب تصاویر، نظرات، یادداشت ها یا انواع دیگر اظهارات خارجی در سند باشد. در این مقاله، نحوه حاشیه نویسی اسناد PDF را با استفاده از REST API در پایتون یاد خواهید گرفت.

موضوعات زیر در این مقاله پوشش داده خواهد شد:

API REST Annotation Document و Python SDK
با استفاده از REST API در پایتون، اسناد PDF را حاشیه نویسی کنید
اضافه کردن حاشیه نویسی فیلد متنی با استفاده از پایتون
اضافه کردن حاشیه نویسی تصویر با استفاده از پایتون
با استفاده از پایتون حاشیه نویسی کنید

API REST Annotation Document و Python SDK

برای حاشیه نویسی اسناد PDF، از Python SDK of GroupDocs.Annotation Cloud API استفاده خواهم کرد. این اجازه می دهد تا به صورت برنامه ریزی شده ابزارهای حاشیه نویسی سند را به صورت آنلاین بسازید. می توانید حاشیه نویسی، همپوشانی واترمارک، جایگزینی متن، ویرایش و نشانه گذاری متن را به اسناد تجاری همه فرمت های رایج اضافه کنید. همچنین SDK های دات نت، جاوا، PHP، روبی و Node.js را به عنوان [اعضای خانواده حاشیه نویسی سند3 برای Cloud API فراهم می کند.

می توانید با استفاده از دستور زیر در کنسول، GroupDocs.Annotation Cloud را در پروژه پایتون خود نصب کنید:

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 = ""

با استفاده از REST API در پایتون، اسناد PDF را حاشیه نویسی کنید

می توانید با دنبال کردن مراحل ساده زیر، حاشیه نویسی را به اسناد PDF خود اضافه کنید:

آپلود فایل PDF در Cloud
حاشیه نویسی اسناد 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 با استفاده از پایتون

لطفاً مراحل ذکر شده در زیر را دنبال کنید تا چندین حاشیه نویسی را به صورت برنامه ریزی شده به سند 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'])

با استفاده از یک REST API در پایتون، چندین حاشیه نویسی را به سند 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\\")

اضافه کردن حاشیه نویسی فیلد متنی با استفاده از پایتون

با دنبال کردن مراحل زیر می توانید حاشیه نویسی فیلد متن را به صورت برنامه نویسی در اسناد 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'])

اضافه کردن حاشیه نویسی فیلد متنی با استفاده از پایتون

اضافه کردن حاشیه نویسی تصویر با استفاده از پایتون

با دنبال کردن مراحل زیر می توانید حاشیه نویسی تصویر را به صورت برنامه ریزی شده در اسناد PDF خود اضافه کنید:

یک نمونه از AnnotateApi ایجاد کنید
یک نمونه از AnnotationInfo ایجاد کنید
Rectangle را تعریف کنید و موقعیت، ارتفاع و عرض آن را تنظیم کنید
ویژگی های مختلف حاشیه نویسی را تنظیم کنید مانند موقعیت، متن، ارتفاع، عرض و غیره.
نوع حاشیه نویسی را به عنوان تصویر تنظیم کنید
یک نمونه 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'])

اضافه کردن حاشیه نویسی تصویر با استفاده از پایتون

با استفاده از پایتون حاشیه نویسی کنید

با دنبال کردن مراحل زیر می توانید حاشیه نویسی هایپرلینک را به صورت برنامه ریزی شده در اسناد 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'])

آنلاین را امتحان کنید

لطفاً ابزار حاشیه نویسی PDF آنلاین رایگان زیر را که با استفاده از API بالا ایجاد شده است، امتحان کنید. https://products.groupdocs.app/annotation/pdf

نتیجه

در این مقاله، نحوه اضافه کردن انواع حاشیه نویسی به اسناد PDF در فضای ابری را یاد گرفتید. علاوه بر این، شما یاد گرفته‌اید که چگونه فایل پی‌دی‌اف را به‌صورت برنامه‌ریزی بر روی ابر آپلود کنید و سپس فایل حاشیه‌نویسی را از ابر دانلود کنید. می‌توانید با استفاده از مستندات درباره GroupDocs.Annotation Cloud API بیشتر بیاموزید. ما همچنین یک بخش API Reference ارائه می‌کنیم که به شما امکان می‌دهد APIهای ما را مستقیماً از طریق مرورگر تجسم کرده و با آن‌ها تعامل داشته باشید. در صورت وجود هرگونه ابهام، لطفاً با ما در تالار گفتمان تماس بگیرید.

API REST Annotation Document و Python SDK#

با استفاده از REST API در پایتون، اسناد PDF را حاشیه نویسی کنید#

سند را آپلود کنید#

حاشیه نویسی اسناد PDF با استفاده از پایتون#

فایل حاشیه نویسی را دانلود کنید#

اضافه کردن حاشیه نویسی فیلد متنی با استفاده از پایتون#

اضافه کردن حاشیه نویسی تصویر با استفاده از پایتون#

با استفاده از پایتون حاشیه نویسی کنید#

آنلاین را امتحان کنید#

نتیجه#

همچنین ببینید#