Bir Python geliştiricisi olarak, herhangi bir Word (.doc veya .docx) dosyasına bulutta programlı olarak açıklama ekleyebilirsiniz. Ek açıklamalar genellikle, belgedeki mevcut bir veri parçası hakkında ek bilgi sağlayan yorumlar, notlar, açıklamalar veya diğer harici açıklama türleri biçimindeki meta verilerdir. Bu makale, Python’da bir REST API kullanarak DOCX dosyalarına nasıl açıklama ekleneceğine odaklanacaktır.
Bu yazıda aşağıdaki konular ele alınacaktır:
- Belge Açıklama REST API ve Python SDK
- REST API kullanarak DOCX Dosyalarına Açıklama Ekleyin
- Python Kullanarak Birden Çok Ek Açıklama Ekleme
Belge Açıklama REST API ve Python SDK
DOC veya DOCX belgelerine açıklama eklemek için GroupDocs.Annotation Cloud’un Python SDK API’sini kullanacağım. Programlı olarak çevrimiçi belge ve görüntü ek açıklama araçları oluşturmanıza olanak tanır. Bu tür araçlar, tüm popüler biçimlerdeki iş belgelerine açıklamalar, filigran kaplamaları, metin değiştirmeleri, redaksiyonlar, yapışkan notlar ve metin işaretlemeleri eklemek için kullanılabilir. 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ı aşağıda gösterildiği gibi koda ekleyin:
client_id = "112f0f38-9dae-42d5-b4fc-cc84ae644972"
client_secret = "16ad3fe0bdc39c910f57d2fd48a5d618"
my_storage = ""
configurations = groupdocs_annotation_cloud.Configuration(client_id, client_secret)
configurations.api_base_url = "https://api.groupdocs.cloud"
Python’da bir REST API kullanarak DOCX Dosyalarına Açıklama Ekleyin
Aşağıda belirtilen basit adımları izleyerek DOCX dosyasına ek açıklamalar ekleyebilirsiniz:
- DOCX dosyasını Buluta Yükle
- Python’da DOCX Dosyalarına Ek Açıklamalar Ekleyin
- Güncellenen dosyayı İndir
Belgeyi Yükle
Öncelikle aşağıda verilen kod örneğini kullanarak DOCX dosyasını Buluta yükleyin:
# API örneğini oluşturun
file_api = groupdocs_annotation_cloud.FileApi.from_config(configurations)
request = groupdocs_annotation_cloud.UploadFileRequest("one-page.docx", "C:\\Files\\one-page.docx", my_storage)
response = file_api.upload_file(request)
Sonuç olarak, yüklenen DOCX dosyası, bulut üzerindeki kontrol panelinizin dosyalar bölümünde mevcut olacaktır.
Python’da DOCX Dosyalarına Ek Açıklamalar Ekleyin
Ek açıklamaları Word belgesine programlı olarak eklemek için lütfen aşağıda belirtilen adımları izleyin.
- Bir AnnotationInfo örneği oluşturun
- Konum, tür, metin vb. gibi çeşitli Ek Açıklama özelliklerini ayarlayın.
- Bir FileInfo örneği oluşturun
- dosya yolunu ayarla
- AnnotateOptions örneğini oluşturun
- Dosya bilgilerini AnnotateOptions olarak ayarla
- Ek açıklamayı AnnotateOptions olarak ayarla
- AnnotateRequest yöntemini çağırarak bir istek oluşturun
- AnnotateApi.annotate() yöntemini çağırarak sonuçları alın
Aşağıdaki kod parçacığı, bir REST API kullanarak Word belgesine alan ek açıklamalarının nasıl ekleneceğini gösterir.
api = groupdocs_annotation_cloud.AnnotateApi.from_keys(client_id, client_secret)
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 = 100
a1.page_number = 0
a1.pen_color = 1201033
a1.pen_style = "Solid"
a1.pen_width = 1
a1.opacity = 0.7
# Alan Açıklama Ekle
a1.type = "Area"
a1.text = "This is area annotation"
a1.creator_name = "Anonym A."
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "one-page.docx"
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1]
options.output_path = "Output\\output.docx"
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)
Sonuç olarak, alan açıklamaları aşağıda gösterildiği gibi belgeye eklenecektir.
Desteklenen Ek Açıklama Türleri
Lütfen desteklenen ek açıklama türlerinin listesini aşağıda bulabilirsiniz, daha önce belirtilen adımları izleyerek DOCX dosyalarınıza ekleyebilirsiniz:
- Alan
- Mesafe
- Bağlantı
- Nokta
- çoklu çizgi
- resim
- Metin
- Filigran
- Ok
Güncellenmiş Dosyayı İndirin
Yukarıdaki kod örneği, açıklamalı DOCX dosyasını buluta kaydedecektir. Aşağıdaki kod örneğini kullanarak indirebilirsiniz:
# API örneğini oluşturun
file_api = groupdocs_annotation_cloud.FileApi.from_config(configurations)
request = groupdocs_annotation_cloud.DownloadFileRequest("Output\\output.docx", my_storage)
response = file_api.download_file(request)
# İndirilen dosyayı çalışma dizininize taşıyın
shutil.move(response, "C:\\Files\\")
Python Kullanarak Birden Çok Ek Açıklama Ekleme
DOCX dosyalarınıza programlı olarak birden çok ek açıklama eklemek için lütfen aşağıda belirtilen adımları izleyin.
- AnnotationInfo’nun ilk örneğini oluşturun
- İlk örnek için konum, tür, metin vb. gibi çeşitli Ek Açıklama özelliklerini ayarlayın.
- AnnotationInfo ikinci örneğini oluştur
- İkinci örnek için konum, tür, metin vb. gibi çeşitli ek açıklama özelliklerini ayarlayın.
- Bir FileInfo örneği oluşturun
- dosya yolunu ayarla
- AnnotateOptions örneğini oluşturun
- Dosya bilgilerini AnnotateOptions olarak ayarla
- Birinci ve ikinci açıklamaları AnnotateOptions olarak ayarlayın
- AnnotateRequest yöntemini çağırarak bir istek oluşturun
- AnnotateApi.annotate() yöntemini çağırarak sonuçları alın
Aşağıdaki kod parçacığı, bir REST API kullanarak DOCX dosyasına birden çok ek açıklamanın nasıl ekleneceğini gösterir. Dosya yüklemek ve indirmek için lütfen daha önce belirtilen adımları izleyin.
api = groupdocs_annotation_cloud.AnnotateApi.from_keys(client_id, client_secret)
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 = 200
a1.box.y = 200
a1.box.width = 300
a1.box.height = 100
a1.page_number = 0
a1.pen_color = 1201033
a1.pen_style = "Solid"
a1.pen_width = 1
a1.opacity = 0.2
a1.type = "Watermark"
a1.text = "This is watermark annotation"
a1.creator_name = "Anonym A."
a2 = groupdocs_annotation_cloud.AnnotationInfo()
a2.annotation_position = groupdocs_annotation_cloud.Point()
a2.annotation_position.x = 852
a2.annotation_position.y = 59.38
a2.box = groupdocs_annotation_cloud.Rectangle()
a2.box.x = 375.8
a2.box.y = 59.38
a2.box.width = 88
a2.box.height = 37
a2.page_number = 2
a2.pen_color = 1201033
a2.pen_style = "Solid"
a2.pen_width = 1
a2.opacity = 0.9
a2.type = "Image"
a2.text = "This is Image annotation"
a2.creator_name = "Anonym A."
a2.image_path = "JohnSmith.png"
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "ten-pages.docx"
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1, a2]
options.output_path = "Output\\output.docx"
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)
Sonuç olarak, resim ve filigran açıklamaları aşağıda gösterildiği gibi belgeye eklenecektir.
Çözüm
Bu makalede, Python kullanarak Document Annotation REST API ile bulutta Word belgelerine çeşitli ek açıklama türlerini nasıl ekleyeceğinizi öğrendiniz. DOCX dosyasını programlı olarak buluta nasıl yükleyeceğinizi ve ardından açıklamalı dosyayı buluttan nasıl indireceğinizi de öğ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.