علق مستندات PDF باستخدام واجهة برمجة تطبيقات REST في Python

يمكنك إضافة تعليق توضيحي لأي مستند PDF برمجيًا على السحابة باستخدام Python. يمكن أن تكون أي معلومات إضافية حول جزء موجود من البيانات في شكل صور أو تعليقات أو ملاحظات أو أنواع أخرى من الملاحظات الخارجية في المستند. في هذه المقالة ، ستتعلم كيفية إضافة تعليقات توضيحية إلى مستندات PDF باستخدام واجهة برمجة تطبيقات REST في Python.

سيتم تناول الموضوعات التالية في هذه المقالة:

الوثيقة التوضيحية REST API و Python SDK
علق على مستندات PDF باستخدام واجهة برمجة تطبيقات REST في Python
أضف التعليقات التوضيحية TextField باستخدام Python
أضف التعليقات التوضيحية للصور باستخدام Python
علق باستخدام التعليقات التوضيحية للرابط باستخدام Python

الوثيقة التوضيحية REST API و Python SDK

للتعليق على مستندات PDF ، سأستخدم Python SDK of GroupDocs.Annotation Cloud API. يسمح بإنشاء أدوات التعليقات التوضيحية للمستندات عبر الإنترنت برمجيًا. يمكنك إضافة التعليقات التوضيحية وتراكبات العلامات المائية واستبدال النصوص والتنقيحات وعلامات النص إلى مستندات الأعمال لجميع التنسيقات الشائعة. كما أنها توفر حزم SDK لـ .NET و Java و PHP و Ruby و Node.js باعتبارها أعضاء عائلة التعليقات التوضيحية للمستندات لواجهة برمجة التطبيقات السحابية.

يمكنك تثبيت 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 في Python

يمكنك إضافة التعليقات التوضيحية إلى مستندات PDF الخاصة بك باتباع الخطوات البسيطة الواردة أدناه:

تحميل ملف PDF على السحابة
علق مستندات PDF باستخدام Python
تنزيل الملف المشروح

قم بتحميل المستند

أولاً ، قم بتحميل ملف PDF إلى السحابة باستخدام نموذج الكود التالي:

# إنشاء مثيل لواجهة برمجة التطبيقات
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 = 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 في 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 = 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
حدد المستطيل واضبط موضعه وارتفاعه وعرضه
قم بتعيين العديد من خصائص التعليقات التوضيحية ، مثل الموضع والنص والارتفاع والعرض وما إلى ذلك.
تعيين نوع التعليق التوضيحي كصورة
قم بإنشاء مثيل FileInfo وقم بتعيين مسار ملف الإدخال
إنشاء مثيل AnnotateOptions وتعيين معلومات الملف إلى AnnotateOptions
تعيين تعليق توضيحي إلى AnnotateOptions
قم بإنشاء طلب عن طريق استدعاء أسلوب AnnotateRequest
احصل على النتائج عن طريق استدعاء طريقة AnnotateApi.annotate()

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة التعليقات التوضيحية للصور في مستند PDF باستخدام واجهة برمجة تطبيقات REST. يرجى اتباع الخطوات المذكورة سابقاً لتحميل وتنزيل ملف.

# تهيئة 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 = 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 المجانية عبر الإنترنت ، والتي تم تطويرها باستخدام واجهة برمجة التطبيقات المذكورة أعلاه. https://products.groupdocs.app/annotation/pdf

خاتمة

في هذه المقالة ، تعلمت كيفية إضافة أنواع مختلفة من التعليقات التوضيحية إلى مستندات PDF على السحابة. علاوة على ذلك ، تعلمت كيفية تحميل ملف PDF برمجيًا على السحابة ثم تنزيل الملف المشروح من السحابة. يمكنك معرفة المزيد حول GroupDocs.Annotation Cloud API باستخدام التوثيق. نوفر أيضًا قسم مرجع واجهة برمجة التطبيقات الذي يتيح لك تصور واجهات برمجة التطبيقات الخاصة بنا والتفاعل معها مباشرةً من خلال المتصفح. في حالة وجود أي غموض ، فلا تتردد في الاتصال بنا على المنتدى.

الوثيقة التوضيحية REST API و Python SDK#

علق على مستندات PDF باستخدام واجهة برمجة تطبيقات REST في Python#

قم بتحميل المستند#

علق مستندات PDF باستخدام Python#

قم بتنزيل الملف المشروح#

أضف التعليقات التوضيحية TextField باستخدام Python#

أضف التعليقات التوضيحية للصور باستخدام Python#

علق باستخدام التعليقات التوضيحية للرابط باستخدام Python#

جرب عبر الإنترنت#

خاتمة#

أنظر أيضا#