Installation

Le package est disponible sur PyPI et peut être installé via pip en exécutant la commande suivante :

pip install groupdocs-merger-cloud

Prérequis

• Python 2.7 ou 3.4+
• Gestionnaire de packages pip
• Identifiants GroupDocs Cloud — Client ID et Client Secret depuis le Dashboard

Dépendances

Le SDK installe automatiquement les packages suivants :

API Cloud REST Python de fusion de documents et de pages

GroupDocs.Merger Cloud SDK for Python permet aux développeurs d’intégrer des fonctionnalités avancées de fusion de documents et de manipulation de pages dans leurs applications web Python, scripts et flux de travail d’automatisation. Compatible avec plus de 40 formats de fichiers, cette API REST permet de fusionner, diviser et réorganiser de manière transparente les pages de documents, y compris les PDF, les documents Word, les feuilles de calcul Excel et bien plus encore. Les fonctionnalités de sécurité incluent la protection par mot de passe des documents, tandis que des opérations supplémentaires sur les fichiers et les dossiers simplifient la gestion du stockage cloud. Que vous travailliez avec des documents multi-formats ou que vous effectuiez des manipulations de pages complexes, GroupDocs.Merger offre des outils robustes pour une gestion sécurisée et efficace des documents sur les plateformes web, de bureau et mobiles.

Fusionner des documents

Fusionner deux documents ou plus - Combinez plusieurs documents en un seul fichier.
Fusionner des pages spécifiques - Fusionnez uniquement des pages spécifiques de différents documents en un seul.
Joindre des plages de pages - Combinez des plages de pages sélectionnées de plusieurs documents en un seul.
Fusion multi-formats - Fusionnez des documents de formats différents (par ex. DOCX et PDF) en une seule sortie.

Fractionnement et manipulation de pages

Diviser des documents - Divisez un document source en plusieurs fichiers distincts.
Déplacer des pages - Déplacez des pages de document au sein d’un fichier.
Faire pivoter des pages - Faites pivoter des pages de document pour ajuster leur orientation.
Supprimer des pages - Supprimez les pages indésirables d’un document.
Échanger des pages - Échangez la position des pages au sein d’un document.
Extraire des pages - Extrayez des pages spécifiques d’un document dans un nouveau fichier.
Changer l’orientation des pages - Ajustez l’orientation des pages dans les types de documents pris en charge.

Sécurité et protection des documents

Définir un mot de passe de document - Sécurisez les documents en définissant un mot de passe.
Supprimer le mot de passe d’un document - Supprimez les mots de passe existants des documents protégés.
Mettre à jour le mot de passe d’un document - Modifiez le mot de passe d’un document protégé.
Vérifier la protection par mot de passe - Vérifiez si un document est protégé par mot de passe.

Opérations sur les fichiers

Téléverser des fichiers vers le cloud - Téléversez des fichiers vers le stockage cloud via l’API.
Télécharger des fichiers depuis le cloud - Téléchargez des fichiers depuis le stockage cloud vers les systèmes locaux.
Copier des fichiers - Copiez des fichiers au sein du stockage cloud vers différents emplacements.
Déplacer des fichiers - Déplacez des fichiers entre les dossiers du stockage cloud.
Supprimer des fichiers - Supprimez des fichiers spécifiques du stockage cloud.

Opérations sur les dossiers

Créer un dossier - Créez de nouveaux dossiers dans le stockage cloud.
Copier un dossier - Dupliquez des dossiers au sein du stockage cloud.
Déplacer un dossier - Déplacez des dossiers entre les répertoires du stockage cloud.
Supprimer un dossier - Supprimez des dossiers entiers du stockage cloud.

Licence et authentification

Mode d’évaluation - Essayez l’API avec un compte d’essai gratuit.
Authentification sécurisée - Utilisez Client ID et Client Secret pour un accès API sécurisé.
Licence MIT - Le SDK Python est distribué sous la Licence MIT.

Formats de documents pris en charge

GroupDocs.Merger Cloud prend en charge plus de 40 formats de fichiers avec des capacités de jointure, de fractionnement et de manipulation de pages :

• Traitement de texte : DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, ODT, OTT, HTML, MHT, MHTML
• PDF et mise en page : PDF, XPS, TEX, EPUB
• Présentations : PPT, PPTX, PPS, PPSX, ODP, OTP, POTX, POTM, PPSM, PPTM
• Feuilles de calcul : XLS, XLSX, XLSB, XLSM, XLT, XLTX, XLTM, ODS, CSV, TSV
• Diagrammes : VSDX, VSDM, VSSX, VSSM, VSTX, VSTM, VDX, VSX, VTX
• Notes : ONE (Microsoft OneNote)
• Texte : TXT, ERR

Les opérations prises en charge varient selon le format. La fusion multi-formats vers PDF/XPS et DOC/DOCX est disponible pour de nombreux types. Pour la matrice complète des formats, consultez la documentation.

Démarrage rapide

Obtenez vos identifiants API

Pour utiliser GroupDocs.Merger Cloud, inscrivez-vous sur le Tableau de bord GroupDocs.Cloud et obtenez votre Client ID et Client Secret.

Initialiser l’API

Utilisez le code suivant pour commencer à utiliser le SDK Cloud GroupDocs.Merger pour Python :

import groupdocs_merger_cloud

# Get your ClientId and ClientSecret at https://dashboard.groupdocs.cloud
client_id = "YourClientId"
client_secret = "YourClientSecret"

# Create API configuration
configuration = groupdocs_merger_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"

# Create instance of the Document API
document_api = groupdocs_merger_cloud.DocumentApi.from_config(configuration)

Fusionner plusieurs documents

Une fois initialisé, utilisez cet exemple de base pour fusionner des documents Word en un seul fichier :

import groupdocs_merger_cloud

client_id = "YourClientId"
client_secret = "YourClientSecret"

document_api = groupdocs_merger_cloud.DocumentApi.from_keys(client_id, client_secret)

item1 = groupdocs_merger_cloud.JoinItem()
item1.file_info = groupdocs_merger_cloud.FileInfo("WordProcessing/four-pages.docx")

item2 = groupdocs_merger_cloud.JoinItem()
item2.file_info = groupdocs_merger_cloud.FileInfo("WordProcessing/one-page.docx")

options = groupdocs_merger_cloud.JoinOptions()
options.join_items = [item1, item2]
options.output_path = "Output/joined.docx"

result = document_api.join(groupdocs_merger_cloud.JoinRequest(options))

print("Output file path = " + result.path)

Avec ce guide de démarrage rapide, vous êtes prêt à commencer à fusionner des documents avec GroupDocs.Merger Cloud dans vos applications Python. Pour plus de détails, consultez la documentation.

Obtenir les formats de fichiers pris en charge

Récupérez la liste complète des formats de fichiers pris en charge disponibles via l’API Merger.

import groupdocs_merger_cloud

info_api = groupdocs_merger_cloud.InfoApi.from_keys("YourClientId", "YourClientSecret")

result = info_api.get_supported_file_formats()

for fmt in result.formats:
    print(fmt.file_format)

Joindre des pages de différents documents

Fusionnez des pages spécifiques de plusieurs documents source en un seul fichier de sortie, avec prise en charge des plages de pages et des filtres.

import groupdocs_merger_cloud

document_api = groupdocs_merger_cloud.DocumentApi.from_keys("YourClientId", "YourClientSecret")

item1 = groupdocs_merger_cloud.JoinItem()
item1.file_info = groupdocs_merger_cloud.FileInfo("WordProcessing/sample-10-pages.docx")
item1.pages = [3, 6, 8]

item2 = groupdocs_merger_cloud.JoinItem()
item2.file_info = groupdocs_merger_cloud.FileInfo("WordProcessing/four-pages.docx")
item2.start_page_number = 1
item2.end_page_number = 4
item2.range_mode = "OddPages"

options = groupdocs_merger_cloud.JoinOptions()
options.join_items = [item1, item2]
options.output_path = "Output/joined-pages.docx"

result = document_api.join(groupdocs_merger_cloud.JoinRequest(options))

print("Output file path = " + result.path)

Fusionner des documents multi-formats en PDF

Fusionnez des documents de formats différents (par ex. PDF protégé par mot de passe et DOCX) en un seul fichier PDF.

import groupdocs_merger_cloud

document_api = groupdocs_merger_cloud.DocumentApi.from_keys("YourClientId", "YourClientSecret")

item1 = groupdocs_merger_cloud.JoinItem()
item1.file_info = groupdocs_merger_cloud.FileInfo(
    "Pdf/one-page-password.pdf", None, None, "password"
)

item2 = groupdocs_merger_cloud.JoinItem()
item2.file_info = groupdocs_merger_cloud.FileInfo("WordProcessing/one-page.docx")

options = groupdocs_merger_cloud.JoinOptions()
options.join_items = [item1, item2]
options.output_path = "Output/joined.pdf"

result = document_api.join(groupdocs_merger_cloud.JoinRequest(options))

print("Output file path = " + result.path)

Diviser un document en pages individuelles

Divisez un document en fichiers distincts en spécifiant des numéros de page exacts.

import groupdocs_merger_cloud

document_api = groupdocs_merger_cloud.DocumentApi.from_keys("YourClientId", "YourClientSecret")

options = groupdocs_merger_cloud.SplitOptions()
options.file_info = groupdocs_merger_cloud.FileInfo("WordProcessing/sample-10-pages.docx")
options.output_path = "Output/split-document"
options.pages = [1, 3]
options.mode = "Pages"

result = document_api.split(groupdocs_merger_cloud.SplitRequest(options))

print("Documents count = " + str(len(result.documents)))

Extraire des pages par numéros

Extrayez des pages spécifiques d’un document dans un nouveau fichier.

import groupdocs_merger_cloud

pages_api = groupdocs_merger_cloud.PagesApi.from_keys("YourClientId", "YourClientSecret")

options = groupdocs_merger_cloud.ExtractOptions()
options.file_info = groupdocs_merger_cloud.FileInfo("WordProcessing/sample-10-pages.docx")
options.output_path = "Output/extract-pages-by-numbers.docx"
options.pages = [2, 4, 7]

result = pages_api.extract(groupdocs_merger_cloud.ExtractRequest(options))

print("Output file path = " + result.path)

Faire pivoter des pages de document

Faites pivoter des pages sélectionnées dans un document PDF pour ajuster leur orientation.

import groupdocs_merger_cloud

pages_api = groupdocs_merger_cloud.PagesApi.from_keys("YourClientId", "YourClientSecret")

options = groupdocs_merger_cloud.RotateOptions()
options.file_info = groupdocs_merger_cloud.FileInfo("Pdf/ten-pages.pdf")
options.output_path = "Output/rotate-pages.pdf"
options.pages = [2, 4]
options.mode = "Rotate90"

result = pages_api.rotate(groupdocs_merger_cloud.RotateRequest(options))

print("Output file path = " + result.path)

Ajouter un mot de passe à un document

Sécurisez un document en ajoutant une protection par mot de passe.

import groupdocs_merger_cloud

security_api = groupdocs_merger_cloud.SecurityApi.from_keys("YourClientId", "YourClientSecret")

options = groupdocs_merger_cloud.Options()
options.file_info = groupdocs_merger_cloud.FileInfo(
    "WordProcessing/one-page.docx", None, None, "password"
)
options.output_path = "Output/add-password.docx"

result = security_api.add_password(groupdocs_merger_cloud.AddPasswordRequest(options))

print("Output file path = " + result.path)

Exemples de projets sur GitHub

Le dépôt GroupDocs.Merger Cloud Python Samples comprend des exemples prêts à l’emploi couvrant :

Comment exécuter les exemples

1. Clonez ou téléchargez le dépôt d’exemples
2. Modifiez Examples/Common.py et définissez vos client_id et client_secret
3. Accédez au répertoire Examples
4. Exécutez pip install groupdocs-merger-cloud -U
5. Exécutez python RunExamples.py

Pour plus de détails, consultez Prise en main.

Tags

Document Merging API | Python Cloud API | GroupDocs.Merger Cloud | REST API | Page Manipulation | Document Security | Password Protection | Cloud Storage Integration | File Operations | Folder Operations | Document Splitting | PDF Merging | Cross-format Merging | Word Document Merging | Excel File Merging | Presentation Merging | Document Reorganization | Secure API Access | Document Joining | Document Manipulation API | Merge Multiple Formats | Cross-platform API