PDF dosyası metin ve grafiklerden oluşur ve bunların içinde ekler olarak tüm dosyalar bulunabilir. Bu, belge kümelerinin değiştirilmesini daha kolay ve daha güvenilir hale getirir. Ekler bölmesi, ekleri görüntülemek, eklemek, silmek ve dışa aktarmak için merkezi bir yer sağlar. Ayrıca, PDF dosyasını yeni bir konuma taşırsanız, içindeki eklerin de onunla birlikte taşınacağını lütfen unutmayın. Ekler, ana belgeye veya ana belgeden veya diğer eklere bağlantılar içerebilir. Lütfen ekli yorumları dosya ekleriyle karıştırmayın.
Bu makalede, PDF belgelerindeki ekler hakkındaki bilgileri nasıl okuyabileceğimizin ve Python kullanarak PDF’den ekleri nasıl indirebileceğimizin ayrıntılarını tartışacağız. Belirli bir yazılım indirme ve kurulum gerekmez ve tüm gerekli işlemleri bulutta gerçekleştirir.
- PDF İşleme API’si
- PDF İşleme için Python SDK
- cURL Komutunu Kullanarak Ek Bilgilerini Oku
- cURL Komutunu Kullanarak Belirli Eki İndirin
PDF İşleme API’si
Aspose.PDF Cloud, çeşitli formatları PDF’ye dönüştürme, düzenleme ve oluşturma ve ayrıca PDF dosyalarını XLSX, PPTX, DOCX, EPUB, HTML, JPEG vb. formatlara dönüştürme yetenekleri sunan REST tabanlı API’mizdir. REST mimarisi sayesinde API’ye her platformdan erişilebilir. Bu nedenle, Masaüstü, Web, Mobil, Cloud ve Hibrit uygulamalarda PDF işleme yeteneklerini uygulayabilirsiniz.
PDF İşleme için Python SDK
Müşterilerimize daha fazla kolaylık sağlamak için, seçtiğiniz dilde tüm PDF işleme yeteneklerini elde edebilmeniz için özel programlama SDK’ları oluşturduk. Benzer şekilde, Python geliştiricilerine kolaylık sağlamak için, Aspose.PDF Cloud API’si etrafında bir sarmalayıcı olan Aspose.PDF Cloud SDK for Python adlı Python programlama SDK’sı oluşturduk. Şimdi başlamak için ilk adım kurulumudur. SDK, PIP ve GitHub deposu üzerinden ücretsiz olarak indirilebilir. Şimdi sisteme SDK’nın en son sürümünü yüklemek için terminal/komut isteminde aşağıdaki komutu çalıştırın.
pip install asposepdfcloud
PyCharm IDE
Eğer PyCharm IDE kullanıyorsanız, SDK’yı doğrudan projenize bağımlılık olarak ekleyebilirsiniz.
Dosya ->Ayarlar ->Proje ->Python Yorumlayıcı ->asposepdfcloud
Image 1:- PyCharm settings option.
Resim 2:- Aspose.Pdf Cloud Python Paketi.
Ücretsiz Cloud Panosu Hesabı
Kurulumdan sonraki önemli adım, Aspose.Cloud panosu aracılığıyla bulut hizmetlerimize ücretsiz aboneliktir. Bu aboneliğin amacı, yalnızca yetkili kişilerin dosya işleme hizmetlerimize erişmesine izin vermektir. GitHub veya Google hesabınız varsa, sadece Kaydolun veya Yeni Hesap Oluştur düğmesine tıklayın ve gerekli bilgileri sağlayın. Şimdi kimlik bilgilerini kullanarak panoya giriş yapın ve panodan Uygulamalar bölümünü genişletin ve İstemci Kimliği ve İstemci Gizli Bilgisi ayrıntılarını görmek için İstemci Kimlik Bilgileri bölümüne doğru aşağı kaydırın.
Resim 3:- Aspose.Cloud Pano’sunda İstemci Kimlik Bilgileri.
PDF’den Ekleri Oku Bilgileri
PDF dokümanındaki eklerin bilgilerini okumak için lütfen aşağıdaki talimatları izleyin.
- İlk olarak, Client ID Client Secret’ı argüman olarak sağlayarak ApiClient sınıfının bir örneğini oluşturmamız gerekiyor.
- İkinci olarak, giriş argümanı olarak ApiClient nesnesini alan bir PdfApi sınıfı örneği oluşturun.
- Şimdi PDF eki ayrıntılarını almak için PdfApi’nin getdocumentattachments(…) metodunu çağırın.
def readAttachmentDetails():
try:
#Client credentials
client_secret = "1c9379bb7d701c26cc87e741a29987bb"
client_id = "bbf94a2c-6d7e-4020-b4d2-b9809741374e"
#initialize PdfApi client instance using client credetials
pdf_api_client = asposepdfcloud.api_client.ApiClient(client_secret, client_id)
# PdfApiClient'ı argüman olarak geçirirken PdfApi örneği oluşturun
pdf_api = PdfApi(pdf_api_client)
#source image file
input_file = 'PdfWithEmbeddedFiles.pdf'
# ek ayrıntılarını çıkarmak için API'yi çağırın
response = pdf_api.get_document_attachments(name = input_file)
print(response)
# konsolda mesajı yazdır (isteğe bağlı)
print('PDF Attachment details successfully retrieved !')
except ApiException as e:
print("Exception while calling PdfApi: {0}".format(e))
print("Code:" + str(e.code))
print("Message:" + e.message)
Referans olması açısından, yukarıdaki örnekte kullanılan örnek PDF belgesi PdfWithEmbeddedFiles.pdf adresinden indirilebilir.
Belirli Ek Bilgilerini Oku
API ayrıca PDF belgesindeki belirli eklerin bilgilerini okumamızı kolaylaştırır. Bu amaçla lütfen GetDocumentAttachmentByIndex yöntemini kullanmayı deneyin. Lütfen aşağıda alınan ilk ekin ayrıntılarını görün.
{'attachment': {'check_sum': '33DCE2EE8BD095A3C4E2A67058104D35',
'creation_date': '11/24/2008 02:02:36.000 PM',
'description': None,
'links': [{'href': '/PdfWithEmbeddedFiles.pdf/attachments/1',
'rel': 'self',
'title': None,
'type': None}],
'mime_type': 'application/pdf',
'modification_date': '05/03/2007 10:37:41.000 AM',
'name': 'example1.pdf',
'size': 10984},
'code': 200,
'status': 'OK'}
PDF’den Belirli Eki İndir
PDF belgesinden belirli ekleri indirmek için lütfen aşağıda belirtilen talimatları izleyin.
- İlk olarak, Client ID Client Secret’ı argüman olarak sağlayarak ApiClient sınıfının bir örneğini oluşturmamız gerekiyor.
- İkinci olarak, giriş argümanı olarak ApiClient nesnesini alan bir PdfApi sınıfı örneği oluşturun.
- Şimdi eki PDF dosyasından indirmek için GetDownloadDocumentAttachmentByIndex(…) metodunu çağırın.
def downloadAttachment():
try:
#Client credentials
client_secret = "1c9379bb7d701c26cc87e741a29987bb"
client_id = "bbf94a2c-6d7e-4020-b4d2-b9809741374e"
#initialize PdfApi client instance using client credetials
pdf_api_client = asposepdfcloud.api_client.ApiClient(client_secret, client_id)
# PdfApiClient'ı argüman olarak geçirirken PdfApi örneği oluşturun
pdf_api = PdfApi(pdf_api_client)
#source image file
input_file = 'PdfWithEmbeddedFiles.pdf'
# PDF dosyasından ilk eki indirmek için API'yi çağırın
response = pdf_api.get_download_document_attachment_by_index(name = input_file, attachment_index=1)
print(response)
# konsolda mesajı yazdır (isteğe bağlı)
print('PDF Attachment successfully downloaded !')
except ApiException as e:
print("Exception while calling PdfApi: {0}".format(e))
print("Code:" + str(e.code))
print("Message:" + e.message)
cURL Komutunu Kullanarak Ek Bilgilerini Oku
REST API’lerine cURL komutları aracılığıyla kolayca erişilebilir ve bunları çalıştırmak için basit bir terminal uygulaması kullanabiliriz. Aspose.PDF Cloud, REST mimarisine göre geliştirildiğinden, bunlara cURL komutları aracılığıyla da erişebiliriz. Ancak, ön koşul olarak, Aspose.Cloud panosu üzerinden belirtilen bireysel istemci kimlik bilgilerinize dayalı bir JSON Web Token (JWT) oluşturmamız gerekir. API’lerimize yalnızca kayıtlı kullanıcılar erişebildiği için bu zorunludur. Lütfen JWT token’ını oluşturmak için aşağıdaki komutu çalıştırın.
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=bbf94a2c-6d7e-4020-b4d2-b9809741374e&client_secret=1c9379bb7d701c26cc87e741a29987bb" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
Artık JWT token’ına sahip olduğumuza göre, PDF belgelerinden belirli eklerin bilgilerini almak için aşağıdaki komutu çalıştırabiliriz.
curl -v -X GET "https://api.aspose.cloud/v3.0/pdf/PdfWithEmbeddedFiles.pdf/attachments/1" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"
cURL Komutunu Kullanarak Belirli Eki İndirin
PDF dosyasının 2. ekini indirmek ve yerel sürücünüze kaydetmek için lütfen aşağıdaki komutu çalıştırın.
curl -v -X GET "https://api.aspose.cloud/v3.0/pdf/PdfWithEmbeddedFiles.pdf/attachments/2/download" \
-H "accept: multipart/form-data" \
-H "authorization: Bearer <JWT Token>" \
-o Attachment.txt
Çözüm
Bu makale, PDF belgelerinden ekleri nasıl okuyabileceğimizi ve indirebileceğimizi ayrıntıları ve adımları açıklamıştır. Python kod parçacıklarını ve cURL komutlarını kullanarak adımları inceledik. Eklerin işlenmesinin yanı sıra, API ayrıca PDF dosyalarının diğer öğeleriyle ilgili çok sayıda özellik sağlar ve bunların ayrıntıları Geliştirici Kılavuzu’nda bulunabilir. Ayrıca, Aspose.PDF for Python Cloud SDK’nın tam kaynak kodu GitHub üzerinden indirilmek üzere sunulmuştur. API’yi kullanırken herhangi bir sorunla karşılaşırsanız veya başka sorularınız varsa lütfen Ücretsiz ürün destek forumu aracılığıyla bizimle iletişime geçmekten çekinmeyin.
İlgili Makaleler
Daha fazla bilgi edinmek için aşağıdaki bağlantıları da ziyaret etmenizi öneririz: