Python kullanarak PDF Belgelerine Açıklama Ekleyin

Python kullanarak herhangi bir PDF belgesine programlı olarak bulutta açıklama ekleyebilirsiniz. Belgedeki resimler, yorumlar, notlar veya diğer harici açıklamalar biçimindeki mevcut bir veri parçası hakkında herhangi bir ek bilgi olabilir. Bu makalede, Python’da bir REST API kullanarak PDF belgelerine açıklama eklemeyi öğreneceksiniz.

Bu yazıda aşağıdaki konular ele alınacaktır:

Belge Açıklama REST API ve Python SDK

PDF belgelerine açıklama eklemek için GroupDocs.Annotation Cloud’un Python SDK API’sini kullanacağım. Belge ek açıklama araçlarının çevrimiçi olarak programlı olarak oluşturulmasına izin verir. Tüm popüler biçimlerdeki iş belgelerine ek açıklamalar, filigran kaplamaları, metin değiştirmeleri, düzeltmeler ve metin işaretlemeleri ekleyebilirsiniz. Ayrıca Cloud API için document annotation family üyeleri olarak .NET, Java, PHP, Ruby ve Node.js SDK’ları sağlar.

Konsolda aşağıdaki komutu kullanarak GroupDocs.Annotation Cloud’u Python projenize kurabilirsiniz:

pip install groupdocs_annotation_cloud

Lütfen adımları ve mevcut kod örneklerini izlemeye başlamadan önce gösterge tablosundan İstemci Kimliğinizi ve İstemci Sırrınızı alın. Kimliğinizi ve sırrınızı aldıktan sonra, kodu aşağıda gösterildiği gibi ekleyin:

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

Python’da REST API kullanarak PDF Belgelerine Açıklama Ekleyin

Aşağıda verilen basit adımları izleyerek PDF Belgelerinize açıklama ekleyebilirsiniz:

  1. PDF dosyasını Buluta Yükle
  2. Python kullanarak PDF Belgelerine Açıklama Ekleyin
  3. Açıklamalı dosyayı İndir

Belgeyi Yükle

Öncelikle, aşağıdaki kod örneğini kullanarak PDF dosyasını Bulut’a yükleyin:

# api örneğini oluştur
file_api = groupdocs_annotation_cloud.FileApi.from_config(configuration)
my_storage = ""

# örnek dosya yükle
request = groupdocs_annotation_cloud.UploadFileRequest("sample.pdf", "C:\\Files\\sample.pdf", my_storage)
response = file_api.upload_file(request)

Sonuç olarak, yüklenen PDF dosyası, bulut üzerindeki kontrol panelinizin dosyalar bölümünde mevcut olacaktır.

Python kullanarak PDF Belgelerine Açıklama Ekleyin

PDF belgesine programlı olarak birden çok ek açıklama eklemek için lütfen aşağıda belirtilen adımları izleyin.

  • Bir AnnotateApi örneği oluşturun
  • AnnotationInfo’nun ilk örneğini oluşturun
  • İlk örnek için ek açıklama özelliklerini ayarlayın, örneğin konum, tür, metin vb.
  • AnnotationInfo ikinci örneğini oluştur
  • İkinci örnek için ek açıklama özelliklerini ayarlayın, örneğin konum, tür, metin vb.
  • AnnotationInfo üçüncü örneğini oluştur
  • Üçüncü örnek için ek açıklama özelliklerini ayarlayın, örneğin konum, tür, metin vb.
  • Bir FileInfo örneği oluşturun ve giriş dosyası yolunu ayarlayın
  • Bir AnnotateOptions örneği oluşturun ve dosya bilgilerini AnnotateOptions olarak ayarlayın
  • AnnotateOptions’a birinci, ikinci ve üçüncü açıklamaları atayın
  • AnnotateRequest yöntemini çağırarak bir istek oluşturun
  • AnnotateApi.annotate() yöntemini çağırarak sonuçları alın

Aşağıdaki kod örneği, bir REST API kullanarak bir PDF belgesine nasıl açıklama ekleneceğini ve birden çok ek açıklamanın nasıl ekleneceğini gösterir.

# api'yi başlat
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)

# mesafe notu
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 mesafe notu"
a1.creator_name = "Anonym A."

# alan notu
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 alan notu"
a2.creator_name = "Anonym A."

# ok notu
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 ok notu"
a3.creator_name = "Anonym A."

# giriş dosyası
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"

# ek açıklama seçeneklerini tanımlayın
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1, a2, a3]
options.output_path = "output.pdf"

# ek açıklama isteği oluştur
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)         

print("AddMultipleAnnotations: Multiple Annotations added: " + result['href'])
Python'da bir REST API kullanarak PDF Belgesine Birden Fazla Açıklama Ekleyin

Python’da bir REST API kullanarak PDF Belgesine Birden Fazla Açıklama Ekleyin

Belgelerdeki ek açıklama ekleme bölümünde desteklenen ek açıklama türleri hakkında daha fazla bilgi edinebilirsiniz.

Açıklamalı Dosyayı İndirin

Yukarıdaki kod örneği, açıklamalı PDF dosyasını buluta kaydedecektir. Aşağıdaki kod örneğini kullanarak indirebilirsiniz:

# api başlatma
file_api = groupdocs_annotation_cloud.FileApi.from_config(configuration)
my_storage = ""

# indirme isteği oluştur
request = groupdocs_annotation_cloud.DownloadFileRequest("output.pdf", my_storage)
response = file_api.download_file(request)

# İndirilen dosyayı çalışma dizininize taşıyın
shutil.move(response, "C:\\Files\\")

Python kullanarak TextField Ek Açıklamaları ekleyin

Metin alanı ek açıklamalarını, aşağıda verilen adımları izleyerek programlı olarak PDF belgelerine ekleyebilirsiniz:

  • Bir AnnotateApi örneği oluşturun
  • Bir AnnotationInfo örneği oluşturun
  • Ek açıklama konumunu tanımlayın
  • Dikdörtgen konumunu, yüksekliğini ve genişliğini tanımlayın
  • Metin, yükseklik, genişlik vb. gibi çeşitli Ek Açıklama özelliklerini ayarlayın.
  • Ek açıklama türünü TextField olarak ayarla
  • Bir FileInfo örneği oluşturun ve giriş dosyası yolunu ayarlayın
  • Bir AnnotateOptions örneği oluşturun ve dosya bilgilerini AnnotateOptions olarak ayarlayın
  • AnnotateOptions’a açıklama atayın
  • AnnotateRequest yöntemini çağırarak bir istek oluşturun
  • AnnotateApi.annotate() yöntemini çağırarak sonuçları alın

Aşağıdaki kod örneği, bir REST API kullanarak PDF belgesine metin alanı ek açıklamalarının nasıl ekleneceğini gösterir. Dosya yüklemek ve indirmek için lütfen daha önce belirtilen adımları izleyin.

# api'yi başlat
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)

# açıklama bilgisi sağlamak
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."

# giriş dosyası yolu
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"

# ek açıklama seçeneklerini tanımlayın
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1]
options.output_path = "output.pdf"

# ek açıklama isteği oluştur
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)         

print("AddTextFieldAnnotation: Text Field Annotation added: " + result['href'])
Python Kullanarak Metin Alanı Ek Açıklamaları Ekleme

Python Kullanarak Metin Alanı Ek Açıklamaları Ekleme

Python kullanarak Görüntü Ek Açıklamaları ekleyin

Aşağıda verilen adımları izleyerek programlı olarak PDF belgelerinize görüntü ek açıklamaları ekleyebilirsiniz:

  • Bir AnnotateApi örneği oluşturun
  • Bir AnnotationInfo örneği oluşturun
  • Dikdörtgeni tanımlayın ve konumunu, yüksekliğini ve genişliğini ayarlayın
  • Konum, metin, yükseklik, genişlik vb. gibi çeşitli Ek Açıklama özelliklerini ayarlayın.
  • Ek açıklama türünü Görüntü olarak ayarla
  • Bir FileInfo örneği oluşturun ve giriş dosyası yolunu ayarlayın
  • Bir AnnotateOptions örneği oluşturun ve dosya bilgilerini AnnotateOptions olarak ayarlayın
  • AnnotateOptions’a açıklama atayın
  • AnnotateRequest yöntemini çağırarak bir istek oluşturun
  • AnnotateApi.annotate() yöntemini çağırarak sonuçları alın

Aşağıdaki kod örneği, bir REST API kullanarak PDF belgesine görüntü ek açıklamalarının nasıl ekleneceğini gösterir. Dosya yüklemek ve indirmek için lütfen daha önce belirtilen adımları izleyin.

# api'yi başlat
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)

# ek açıklamayı tanımla
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"

# giriş dosyası yolu
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"

# ek açıklamayı tanımla options
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1]
options.output_path = "output_img.pdf"

# ek açıklama isteği oluştur
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)         

print("AddImageAnnotation: Image Annotation added: " + result['href'])
Python kullanarak Görüntü Ek Açıklamaları ekleyin

Python kullanarak Görüntü Ek Açıklamaları ekleyin

Aşağıda verilen adımları izleyerek programlı olarak PDF belgelerine köprü ek açıklamaları ekleyebilirsiniz:

  • Bir AnnotateApi örneği oluşturun
  • Bir AnnotationInfo örneği oluşturun
  • Ek açıklama noktalarını tanımlayın ve her nokta için konumu ayarlayın
  • Metin, yükseklik, genişlik vb. gibi çeşitli Ek Açıklama özelliklerini ayarlayın.
  • Ek açıklama türünü Bağlantı olarak ayarla
  • Bir FileInfo örneği oluşturun ve giriş dosyası yolunu ayarlayın
  • Bir AnnotateOptions örneği oluşturun ve dosya bilgilerini AnnotateOptions olarak ayarlayın
  • AnnotateOptions’a açıklama atayın
  • AnnotateRequest yöntemini çağırarak bir istek oluşturun
  • AnnotateApi.annotate() yöntemini çağırarak sonuçları alın

Aşağıdaki kod örneği, bir REST API kullanarak PDF belgesine köprü ek açıklamalarının nasıl ekleneceğini gösterir. Dosya yüklemek ve indirmek için lütfen daha önce belirtilen adımları izleyin.

# api'yi başlat
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)

# açıklama bilgisi sağlamak
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/"

# giriş dosyası yolu
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"

# ek açıklama seçeneklerini tanımlayın
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1]
options.output_path = "output.pdf"

# ek açıklama isteği oluştur
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)         

print("AddLinkAnnotation: Link Annotation added: " + result['href'])
Python kullanarak Bağlantı Ek Açıklamaları ile açıklama ekleyin

Python kullanarak Bağlantı Ek Açıklamaları ile açıklama ekleyin

Çevrimiçi Deneyin

Lütfen yukarıdaki API kullanılarak geliştirilen aşağıdaki ücretsiz çevrimiçi PDF ek açıklama aracını deneyin. https://products.groupdocs.app/annotation/pdf

Çözüm

Bu makalede, bulutta PDF belgelerine çeşitli açıklama türlerinin nasıl ekleneceğini öğrendiniz. Ayrıca, PDF dosyasını buluta programlı olarak nasıl yükleyeceğinizi ve ardından açıklamalı dosyayı buluttan nasıl indireceğinizi öğrendiniz. Belgeleri kullanarak GroupDocs.Annotation Cloud API hakkında daha fazla bilgi edinebilirsiniz. Ayrıca, API’lerimizi doğrudan tarayıcı aracılığıyla görselleştirmenize ve bunlarla etkileşimde bulunmanıza olanak tanıyan bir API Referansı bölümü de sağlıyoruz. Herhangi bir belirsizlik durumunda, lütfen forumda bizimle iletişime geçmekten çekinmeyin.

Ayrıca bakınız