قم بإزالة التعليقات التوضيحية من PDF باستخدام REST API في Python.

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

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

REST API و Python SDK لإزالة التعليقات التوضيحية

لاستخراج التعليقات التوضيحية أو إزالتها من مستندات PDF ، سنستخدم Python SDK of GroupDocs.Annotation Cloud API. يسمح بإضافة التعليقات التوضيحية وتراكبات العلامات المائية واستبدال النصوص وعلامات التمييز والملاحظات اللاصقة إلى تنسيقات المستندات المدعومة. الرجاء تثبيته باستخدام الأمر التالي في وحدة التحكم:

pip install groupdocs_annotation_cloud

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

# يوضح مثال الرمز هذا كيفية إضافة ClientID و Secret
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 إلى السحابة.
# إنشاء مثيل من API
file_api = groupdocs_annotation_cloud.FileApi.from_config(configuration)

# تحميل ملفات نموذجية
request = groupdocs_annotation_cloud.UploadFileRequest("sample.pdf", "C:\\Files\\sample.pdf", my_storage)
response = file_api.upload_file(request)

نتيجة لذلك ، سيكون الملف الذي تم تحميله متاحًا في قسم الملفات من لوحة القيادة على السحابة.

إزالة التعليقات التوضيحية من PDF في Python

الآن ، سنقوم بإزالة التعليقات التوضيحية من مستند PDF برمجيًا باتباع الخطوات الواردة أدناه:

  • أولاً ، قم بإنشاء مثيل لـ AnnotateApi.
  • بعد ذلك ، قم بإنشاء مثيل FileInfo.
  • بعد ذلك ، قم بتعيين مسار ملف PDF للإدخال.
  • بعد ذلك ، قم بإنشاء مثيل لـ RemoveOptions.
  • ثم قم بتعيين FileInfo إلى RemoveOptions.
  • بعد ذلك ، قم بتوفير معرّفات التعليقات التوضيحية في مصفوفة مفصولة بفاصلة لإزالتها.
  • ثم قم بتعيين مسار ملف الإخراج.
  • بعد ذلك ، قم بإنشاء طلب عن طريق استدعاء طريقة RemoveAnnotationsRequest مع كائن RemoveOptions.
  • أخيرًا ، احصل على النتائج عن طريق استدعاء الأسلوب AnnotateApi.remove \ annotations() باستخدام RemoveAnnotationsRequest كوسيطة.

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

# توضح أمثلة التعليمات البرمجية هذه كيفية إزالة التعليقات التوضيحية من ملف PDF.
# مثيل Api
api = groupdocs_annotation_cloud.AnnotateApi(configuration)

# تفاصيل ملف الإدخال
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"

# إزالة الخيارات
options = groupdocs_annotation_cloud.RemoveOptions()
options.file_info = file_info
options.annotation_ids = [0,1,2]

# ملف إلاخراج
options.output_path = "annotations_removed.pdf"

# طلب إزالة
request = groupdocs_annotation_cloud.RemoveAnnotationsRequest(options)
result = api.remove_annotations(request)

print("RemoveAnnotations: Annotations removed: " + result['href'])
إزالة التعليقات التوضيحية من PDF في Python.

إزالة التعليقات التوضيحية من PDF في Python.

قم بتنزيل ملف الإخراج

سيحفظ نموذج الكود أعلاه ملف الإخراج بعد إزالة التعليقات التوضيحية من ملف PDF على السحابة. يمكن تنزيله باستخدام نموذج التعليمات البرمجية التالي:

# يوضح مثال الرمز هذا كيفية تنزيل ملف PDF من السحابة.
# تهيئة API
file_api = groupdocs_annotation_cloud.FileApi.from_config(configuration)

# طلب إنشاء ملف تنزيل
request = groupdocs_annotation_cloud.DownloadFileRequest("annotations_removed.pdf", my_storage)

# تحميل الملف
response = file_api.download_file(request)

# انقل الملف الذي تم تنزيله إلى دليل العمل الخاص بك
shutil.move(response, "C:\\Files\\")

استخراج التعليقات التوضيحية من مستندات PDF في Python

يمكننا استخراج التعليقات التوضيحية من مستندات PDF برمجيًا باتباع الخطوات الواردة أدناه:

  • أولاً ، قم بإنشاء مثيل لـ AnnotateApi.
  • بعد ذلك ، قم بإنشاء مثيل FileInfo.
  • ثم قم بتعيين مسار ملف الإدخال.
  • بعد ذلك ، قم بإنشاء طلب عن طريق استدعاء طريقة ExtractRequest مع كائن FileInfo.
  • أخيرًا ، احصل على النتائج عن طريق استدعاء طريقة AnnotateApi.extract() باستخدام ExtractRequest كوسيطة.

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

# يوضح مثال الكود هذا كيفية استخراج التعليقات التوضيحية من ملف PDF.
# مثيل Api
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)

# تفاصيل ملف الإدخال
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"

# طلب استخراج التعليق التوضيحي
request = groupdocs_annotation_cloud.ExtractRequest(file_info)
result = api.extract(request)        

print("ExtractAnnotations: annotations count: " + str(len(result)))

# عرض النتائج
for x in range(len(result)):
  print(result[x]);

سيعرض نموذج الكود أعلاه مصفوفة من جميع التعليقات التوضيحية بتنسيق JSON ، كما هو موضح أدناه:

استخراج التعليقات التوضيحية من مستندات PDF في Python.

استخراج التعليقات التوضيحية من مستندات PDF في Python.

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

يرجى تجربة أداة التعليقات التوضيحية التالية بصيغة PDF المجانية عبر الإنترنت ، والتي تم تطويرها باستخدام واجهة برمجة التطبيقات المذكورة أعلاه. https://products.groupdocs.app/annotation/pdf

خاتمة

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

أنظر أيضا