Bir Python geliştiricisi olarak, Word veya Excel belgelerini programlı olarak düzenlemeniz gerekebilir. Bu tür belgeleri herhangi bir harici uygulama yüklemeden güncelleyebilirsiniz. Bu makale, bir REST API kullanarak Word veya Excel belgelerinin nasıl düzenleneceğine odaklanacaktır.
Bu yazıda aşağıdaki konular ele alınacaktır:
- Belge Düzenleyici REST API ve Python SDK
- Bir REST API kullanarak Word Belgesini düzenleyin
- REST API kullanarak Excel Sayfasını düzenleyin
Belge Düzenleyici REST API ve Python SDK
Word belgelerini veya Excel sayfalarını düzenlemek için GroupDocs.Editor Cloud’un Python SDK’sı API’sini kullanacağım. Kelime işlem belgelerini, Excel sayfalarını veya desteklenen diğer biçimlerdeki belgeleri programlı olarak düzenlemenize olanak tanır. Ayrıca Cloud API için belge düzenleyici aile üyeleri olarak .NET, Java, PHP, Ruby, Android ve Node.js SDK’ları sağlar.
Konsolda aşağıdaki komutu kullanarak GroupDocs.Editor-Cloud’u Python projenize kurabilirsiniz:
pip install groupdocs_editor_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 = "YOUR_CLIENT_ID"
client_secret = "YOUR_CLIENT_SECRET"
configuration = groupdocs_editor_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
Bir REST API kullanarak Word Belgesini düzenleyin
Aşağıda belirtilen basit adımları izleyerek Word belgesini düzenleyebilirsiniz:
Belgeyi Yükle
Öncelikle aşağıda verilen kod örneğini kullanarak Word belgesini Buluta yükleyin:
storage_api = groupdocs_editor_cloud.StorageApi.from_config(config_info)
file_api = groupdocs_editor_cloud.FileApi.from_config(config_info)
# örnek dosya yükle
files = glob.glob("C:\\Files\\sample_word_document.docx", recursive=False)
destination_file = files[0].replace("C:\\Files\\", "", 1)
file_api.upload_file(groupdocs_editor_cloud.UploadFileRequest(destination_file, files[0]))
Sonuç olarak, Word dosyası Cloud Storage’a yüklenecek ve kontrol panelinizin dosyalar bölümünde mevcut olacaktır.
Python’da Word Belgesini Düzenleyin
Word belgesini programlı olarak düzenlemek için lütfen aşağıda belirtilen adımları izleyin.
- File API ve Edit API örnekleri oluşturun
- WordProcessingLoadOptions sağlayın
- Edit API’nin Load yöntemiyle bir dosya yükleyin
- Dosya API’sinin Dosyayı İndir yöntemini kullanarak HTML belgesini indirin
- HTML Belgesini Düzenle
- Dosya API’sinin Dosya Yükle yöntemini kullanarak HTML’yi geri yükleyin
- DOCX’e Kaydetmek için WordProcessingSaveOptions Sağlayın
- Edit API’nin Kaydet yöntemini kullanarak HTML’yi tekrar DOCX’e kaydedin
Aşağıdaki kod parçacığı, bir REST API kullanarak bir Word belgesinin nasıl güncelleneceğini gösterir.
# Gerekli API örneklerini oluşturun
edit_api = groupdocs_editor_cloud.EditApi.from_config(configurations)
file_api = groupdocs_editor_cloud.FileApi.from_config(configuration)
# Belge zaten depoya yüklendi.
# Düzenlenebilir duruma yükleyin
file_info = groupdocs_editor_cloud.FileInfo("sample_word_document.docx", None, None, None)
load_options = groupdocs_editor_cloud.WordProcessingLoadOptions()
load_options.file_info = file_info
load_options.output_path = "output"
load_result = edit_api.load(groupdocs_editor_cloud.LoadRequest(load_options))
# Html belgesini indir
html_file = file_api.download_file(groupdocs_editor_cloud.DownloadFileRequest(load_result.html_path))
html = ""
with open(html_file, 'r') as file:
html = file.read()
# Bir şeyi düzenleyin...
html = html.replace("Sample test text", "Hello world")
# Html'yi depoya geri yükle
with open(html_file, 'w') as file:
file.write(html)
file_api.upload_file(groupdocs_editor_cloud.UploadFileRequest(load_result.html_path, html_file))
# Html'yi docx'e geri kaydet
save_options = groupdocs_editor_cloud.WordProcessingSaveOptions()
save_options.file_info = file_info
save_options.output_path = "output/edited.docx"
save_options.html_path = load_result.html_path
save_options.resources_path = load_result.resources_path
save_result = edit_api.save(groupdocs_editor_cloud.SaveRequest(save_options))
# Tamamlamak
print("Document edited: " + save_result.path)
Güncellenmiş Dosyayı İndirin
Yukarıdaki kod örneği, düzenlenen Word dosyasını buluta kaydedecektir. Aşağıdaki kod örneğini kullanarak indirebilirsiniz:
request = groupdocs_editor_cloud.DownloadFileRequest("output\\edited.docx", my_storage)
response = file_api.download_file(request)
# İndirilen dosyayı çalışma dizininize taşıyın
shutil.move(response, "C:\\Files\\")
REST API kullanarak Excel Sayfasını düzenleyin
Excel sayfasını programlı olarak düzenlemek için lütfen aşağıda belirtilen adımları izleyin.
- File API ve Edit API örnekleri oluşturun
- SpreadsheetLoadOptions sağlayın
- Edit API’nin Load yöntemiyle bir dosya yükleyin
- Dosya API’sinin Dosyayı İndir yöntemini kullanarak HTML belgesini indirin
- HTML Belgesini Düzenle
- Dosya API’sinin Dosya Yükle yöntemini kullanarak HTML’yi geri yükleyin
- XLSX’te Kaydetmek İçin SpreadsheetSaveOptions Sağlayın
- Edit API’nin Kaydet yöntemini kullanarak HTML’yi tekrar XLSX’e kaydedin
Aşağıda verilen basit kod örneği, bir REST API kullanarak bir Excel sayfasının nasıl güncelleneceğini gösterir. Dosya yüklemek ve indirmek için lütfen daha önce belirtilen adımları izleyin.
# Gerekli API örneklerini oluşturun
edit_api = groupdocs_editor_cloud.EditApi.from_config(configurations)
file_api = groupdocs_editor_cloud.FileApi.from_config(configurations)
# Belge zaten depoya yüklendi.
# Düzenlenebilir duruma yükleyin
file_info = groupdocs_editor_cloud.FileInfo("sample_four_sheets.xlsx")
load_options = groupdocs_editor_cloud.SpreadsheetLoadOptions()
load_options.file_info = file_info
load_options.output_path = "output"
load_options.worksheet_index = 0
load_result = edit_api.load(groupdocs_editor_cloud.LoadRequest(load_options))
# Html belgesini indir
html_file = file_api.download_file(groupdocs_editor_cloud.DownloadFileRequest(load_result.html_path))
html = ""
with open(html_file, 'r') as file:
html = file.read()
# Bir şeyi düzenleyin...
html = html.replace("This is sample sheet", "This is sample sheep")
# Html'yi depoya geri yükle
with open(html_file, 'w') as file:
file.write(html)
file_api.upload_file(groupdocs_editor_cloud.UploadFileRequest(load_result.html_path, html_file))
# Html'yi xlsx'e geri kaydet
save_options = groupdocs_editor_cloud.SpreadsheetSaveOptions()
save_options.file_info = file_info
save_options.output_path = "output/edited.xlsx"
save_options.html_path = load_result.html_path
save_options.resources_path = load_result.resources_path
save_result = edit_api.save(groupdocs_editor_cloud.SaveRequest(save_options))
# Tamamlamak
print("Excel sheet edited: " + save_result.path)
Çözüm
Bu makalede, Python kullanarak Document Editor REST API ile Word belgelerini veya Excel sayfalarını bulutta nasıl düzenleyeceğinizi öğrendiniz. Ayrıca dosyaları programlı olarak buluta nasıl yükleyeceğinizi ve ardından güncellenmiş dosyaları buluttan nasıl indireceğinizi de öğrendiniz. Belgeleri kullanarak GroupDocs.Editor 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 [forum] üzerinden bizimle iletişime geçmekten çekinmeyin]21.