If so you can download any of the below versions for testing. The product will function as normal except for an evaluation limitation. At the time of purchase we provide a license file via email that will allow the product to work in its full capacity. If you would also like an evaluation license to test without any restrictions for 30 days, please follow the directions provided here.
If you experience errors, when you try to download a file, make sure your network policies (enforced by your company or ISP) allow downloading ZIP and/or MSI files.
Installation
Le package est disponible sur PyPI et peut être installé via pip en exécutant la commande suivante :
pip install groupdocs-conversion-cloud
Exigences
Dépendances
Le SDK installe automatiquement les packages suivants :
| Package | Contrainte |
|---|
| urllib3 | >= 1.15 |
| six | >= 1.10 |
| certifi | — |
| python-dateutil | — |
Démarrage rapide
Obtenez vos identifiants API
Pour utiliser GroupDocs.Conversion Cloud, inscrivez-vous sur le GroupDocs.Cloud Dashboard et obtenez votre Client ID et Client Secret.
Initialiser l’API
Utilisez le code suivant pour commencer à utiliser GroupDocs.Conversion Cloud SDK pour Python :
import groupdocs_conversion_cloud
# Get your ClientId and ClientSecret at https://dashboard.groupdocs.cloud
client_id = "YourClientId"
client_secret = "YourClientSecret"
# Create API configuration
configuration = groupdocs_conversion_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
# Create instance of the Convert API
convert_api = groupdocs_conversion_cloud.ConvertApi.from_config(configuration)
Convertir un document (direct, sans stockage cloud)
Une fois initialisé, utilisez cet exemple de base pour convertir un document local et recevoir le résultat directement :
import groupdocs_conversion_cloud
client_id = "YourClientId"
client_secret = "YourClientSecret"
# Create instance of the API
convert_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)
# Prepare request: output format and local file path
request = groupdocs_conversion_cloud.ConvertDocumentDirectRequest("pdf", "input.docx")
# Convert and save the result
result = convert_api.convert_document_direct(request)
with open("output.pdf", "wb") as f:
f.write(result)
Avec ce guide de démarrage rapide, vous êtes prêt à commencer à convertir des documents avec GroupDocs.Conversion Cloud dans vos applications Python. Pour plus de détails, consultez la documentation.
Convertir des documents à l’aide du stockage cloud
Cet exemple téléverse un fichier vers le stockage GroupDocs Cloud, le convertit et télécharge le résultat — idéal pour les flux de travail côté serveur qui gèrent des fichiers dans le cloud.
import groupdocs_conversion_cloud
client_id = "YourClientId"
client_secret = "YourClientSecret"
# Create instances of the APIs
file_api = groupdocs_conversion_cloud.FileApi.from_keys(client_id, client_secret)
convert_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)
# Upload file to cloud storage
file_api.upload_file(
groupdocs_conversion_cloud.UploadFileRequest("myFile.docx", "myFile.docx")
)
# Prepare convert settings
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "myFile.docx"
settings.format = "pdf"
settings.output_path = "converted"
# Convert the document
result = convert_api.convert_document(
groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
)
print("Document converted: " + result[0].url)
# Download the converted file
response = file_api.download_file(
groupdocs_conversion_cloud.DownloadFileRequest("converted/myFile.pdf", None)
)
Ce code permet aux développeurs de convertir des documents entre divers formats par programmation avec des options de sortie PDF avancées, éliminant les conversions manuelles. Il prend en charge plus de 50 formats de fichiers, ce qui le rend idéal pour les développeurs d’applications nécessitant une prise en charge multi-format.
import groupdocs_conversion_cloud
configuration = groupdocs_conversion_cloud.Configuration("YourClientId", "YourClientSecret")
convert_api = groupdocs_conversion_cloud.ConvertApi.from_config(configuration)
# Prepare convert settings
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "WordProcessing/password-protected.docx"
settings.format = "pdf"
settings.output_path = "converted"
# Load options for password-protected source document
load_options = groupdocs_conversion_cloud.WordProcessingLoadOptions()
load_options.password = "password"
# PDF conversion options
convert_options = groupdocs_conversion_cloud.PdfConvertOptions()
convert_options.center_window = True
convert_options.compress_images = False
convert_options.display_doc_title = True
convert_options.dpi = 1024
convert_options.from_page = 1
convert_options.image_quality = 100
convert_options.password = "password"
convert_options.unembed_fonts = True
settings.load_options = load_options
settings.convert_options = convert_options
# Execute the conversion
result = convert_api.convert_document(
groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
)
print("Document converted: " + result[0].url)
API Cloud de conversion de pages spécifiques d’un document
Cet exemple montre comment les développeurs peuvent convertir uniquement des pages spécifiques, économisant du temps de traitement et réduisant la taille des fichiers lorsque seule une partie du document est nécessaire.
import groupdocs_conversion_cloud
convert_api = groupdocs_conversion_cloud.ConvertApi.from_keys("YourClientId", "YourClientSecret")
# Configure settings to convert specific pages (e.g., pages 1 and 3)
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "WordProcessing/four-pages.docx"
settings.format = "pdf"
settings.output_path = "converted/two-pages.pdf"
convert_options = groupdocs_conversion_cloud.PdfConvertOptions()
convert_options.pages = [1, 3]
settings.convert_options = convert_options
# Execute the conversion
result = convert_api.convert_document(
groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
)
print("Document converted: " + result[0].url)
Récupérez la liste complète des conversions de format source vers format cible disponibles via l’API.
import groupdocs_conversion_cloud
info_api = groupdocs_conversion_cloud.InfoApi.from_keys("YourClientId", "YourClientSecret")
result = info_api.get_supported_conversion_types(
groupdocs_conversion_cloud.GetSupportedConversionTypesRequest()
)
print("Formats count: " + str(len(result)))
Projets d’exemple sur GitHub
Le dépôt GroupDocs.Conversion Cloud Python Samples inclut des exemples prêts à l’emploi couvrant :
| Catégorie | Exemples |
|---|
| Convert | PDF, HTML, image, presentation, spreadsheet, word processing; direct conversion; async conversion |
| Common Options | Watermarks, specific pages, consecutive pages, custom fonts |
| Load Options | CAD, CSV, email, HTML, OneNote, PDF, presentation, spreadsheet, text, word processing |
| Info | Supported conversions, document information |
- Clonez ou téléchargez le dépôt d’exemples
- Modifiez
Examples/Common.py et définissez votre client_id et client_secret - Accédez au répertoire
Examples - Exécutez
pip install groupdocs-conversion-cloud -U - Exécutez
python RunExamples.py
Pour plus de détails, consultez Getting Started.
Document Conversion API | Python Cloud API | GroupDocs.Conversion Cloud | REST API | Document Conversion | Auto-detect Formats | Watermarking API | Multi-Format Output | Batch Document Conversion | PDF Conversion | Custom Conversion Options | Page-by-Page Conversion | Font Replacement | OCR Support | Metadata Extraction | Document Merge | Storage API | Document Information API | Document Load Options | Multi-Language Support | Cloud Storage Integration | SDKs for .NET, Java, Python | Secure API Access | Docker Support | Scalable Document Conversion | API Rate Limiting