Unisci i file PDF utilizzando l'API REST in Python

Puoi combinare facilmente due o più documenti PDF in un unico file PDF in modo programmatico sul cloud. Può essere utile per condividere o stampare più documenti combinati in un unico file invece di elaborare tutti i file uno per uno. Come sviluppatore Python, puoi unire due o più file PDF in un unico file nelle tue applicazioni Python. In questo articolo imparerai come unire file PDF utilizzando un’API REST in Python.

In questo articolo saranno trattati i seguenti argomenti:

PDF Merger REST API e Python SDK

Per unire due o più file PDF, utilizzerò l’API Python SDK of GroupDocs.Merger Cloud. Consente di combinare due o più documenti in un unico documento o di suddividere un documento di origine in più documenti risultanti. Consente inoltre di spostare, eliminare, scambiare, ruotare o modificare l’orientamento della pagina in verticale o in orizzontale per l’intero intervallo di pagine o preferito. L’SDK supporta l’unione e la divisione di tutti i formati di documenti più diffusi come Word, Excel, PowerPoint, Visio, OneNote, PDF, HTML, ecc.

Puoi installare GroupDocs.Merger Cloud nella tua applicazione Python utilizzando il seguente comando nella console:

pip install groupdocs_merger_cloud

Si prega di ottenere l’ID cliente e il segreto dalla dashboard prima di seguire i passaggi menzionati. Una volta che hai il tuo ID e segreto, aggiungi il codice come mostrato di seguito:

client_id = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5"
client_secret = "479db2b01dcb93a3d4d20efb16dea971"

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

Unisci i file PDF utilizzando l’API REST in Python

Puoi combinare due o più file PDF in modo programmatico sul cloud seguendo i semplici passaggi indicati di seguito:

  1. Carica i file PDF nel cloud
  2. Unisci più file PDF usando Python
  3. Scarica il file unito

Carica i file PDF

Innanzitutto, carica i file PDF nel cloud utilizzando l’esempio di codice fornito di seguito:

# Crea un'istanza dell'API
file_api = groupdocs_merger_cloud.FileApi.from_config(configuration)
storage_api = groupdocs_merger_cloud.StorageApi.from_config(configuration)

# caricare file di esempio
for filename in glob.iglob("C:\\Files\\upload\\*.pdf", recursive=True):
    destFile = filename.replace("C:\\Files\\upload", "", 1)           
    # controlla se il file esiste già
    fileExistsResponse = storage_api.object_exists(groupdocs_merger_cloud.ObjectExistsRequest(destFile))
    if not fileExistsResponse.exists:
        # creare richiesta di file di caricamento
        request = groupdocs_merger_cloud.UploadFileRequest(destFile, filename)
        # caricare un file
        file_api.upload_file(request)

Di conseguenza, i file PDF caricati saranno disponibili nella sezione file della dashboard sul cloud.

Unisci più file PDF usando Python

Puoi facilmente unire più file PDF in un singolo file a livello di programmazione seguendo i passaggi indicati di seguito:

  • Crea un’istanza di DocumentApi
  • Creare un’istanza di JoinItem
  • Fornire il percorso del file di input per il primo JoinItem in FileInfo
  • Crea un’altra istanza di JoinItem
  • Fornire il percorso del file di input per il secondo JoinItem in FileInfo
  • Aggiungi più JoinItems per unire più di due file
  • Crea un’istanza di JoinOptions
  • Aggiungi un elenco separato da virgole di elementi di join creati
  • Imposta il percorso del file di output
  • Crea un’istanza di JoinRequest con JoinOptions
  • Ottieni risultati chiamando il metodo join() di DocumentAPI con JoinRequest

Il seguente frammento di codice mostra come unire più file PDF utilizzando un’API REST in Python.

# inizializzazione dell'API
documentApi = groupdocs_merger_cloud.DocumentApi.from_config(configuration)

# file sorgente 1
item1 = groupdocs_merger_cloud.JoinItem()
item1.file_info = groupdocs_merger_cloud.FileInfo("ten-pages_1.pdf")

# file di backup 2
item2 = groupdocs_merger_cloud.JoinItem()
item2.file_info = groupdocs_merger_cloud.FileInfo("ten-pages_2.pdf")

# definire le opzioni di unione
options = groupdocs_merger_cloud.JoinOptions()
options.join_items = [item1, item2]
options.output_path = "Output/joined.pdf"

# creare richiesta di adesione
request = groupdocs_merger_cloud.JoinRequest(options)

# unire i file
result = documentApi.join(request)

Scarica il file unito

L’esempio di codice precedente salverà il file PDF unito nel cloud. Puoi scaricarlo utilizzando il seguente esempio di codice:

# Inizializzazione dell'API
file_api = groupdocs_merger_cloud.FileApi.from_config(configuration)

# creare una richiesta di download del file
request = groupdocs_merger_cloud.DownloadFileRequest("Output/joined.pdf", my_storage)
# download file
response = file_api.download_file(request)

# Sposta il file scaricato nella tua directory di lavoro
shutil.move(response, "C:\\Files\\")

Unisci pagine specifiche di più file PDF utilizzando Python

È possibile combinare facilmente pagine specifiche da più file PDF in un singolo file a livello di programmazione seguendo i passaggi indicati di seguito:

  • Crea un’istanza di DocumentApi
  • Creare un’istanza di JoinItem
  • Fornire il percorso del file di input per il primo JoinItem in FileInfo
  • Definire un elenco di numeri di pagina da unire
  • Crea un’altra istanza di JoinItem
  • Fornire il percorso del file di input per il secondo JoinItem in FileInfo
  • Definire il numero della pagina iniziale e il numero della pagina finale
  • Definire la modalità dell’intervallo di pagine
  • Crea un’istanza di JoinOptions
  • Aggiungi un elenco separato da virgole di elementi di join creati
  • Imposta il percorso del file di output
  • Crea un’istanza di JoinRequest con JoinOptions
  • Ottieni risultati chiamando il metodo join() di DocumentAPI con JoinRequest

Il seguente frammento di codice mostra come unire pagine specifiche da più file PDF utilizzando un’API REST in Python.

# inizializzazione dell'API
documentApi = groupdocs_merger_cloud.DocumentApi.from_config(configuration)

# file sorgente 1
item1 = groupdocs_merger_cloud.JoinItem()
item1.file_info = groupdocs_merger_cloud.FileInfo("Output/joined.pdf")
# numeri di pagina di pagine specifiche da unire
item1.pages = [1,2]

# file di backup 2
item2 = groupdocs_merger_cloud.JoinItem()
item2.file_info = groupdocs_merger_cloud.FileInfo("ten-pages.pdf")
# numero di pagina iniziale
item2.start_page_number = 2
# numero di pagina finale
item2.end_page_number = 4
# modalità intervallo di pagine
item2.range_mode = "OddPages"

# definire le opzioni di unione
options = groupdocs_merger_cloud.JoinOptions()
options.join_items = [item1, item2]
options.output_path = "Output/joined-pages.pdf"

# creare richiesta di adesione
request = groupdocs_merger_cloud.JoinRequest(options)

# unire le pagine
result = documentApi.join(request)

Prova in linea

Prova il seguente strumento di unione PDF online gratuito, sviluppato utilizzando l’API di cui sopra. https://products.groupdocs.app/merger/pdf

Conclusione

In questo articolo, hai imparato come unire più file PDF sul cloud. Hai anche imparato come combinare pagine specifiche di più documenti PDF in un unico file usando Python. Inoltre, hai imparato come caricare in modo programmatico file PDF nel cloud e quindi scaricare il file unito dal cloud. L’API REST per la fusione di PDF fornisce anche SDK .NET, Java, PHP, Ruby, Android e Node.js come membri della famiglia di fusione di documenti per l’API Cloud. Puoi saperne di più su GroupDocs.Merge Cloud API utilizzando la documentazione. Forniamo anche una sezione Riferimento API che ti consente di visualizzare e interagire con le nostre API direttamente attraverso il browser. In caso di qualsiasi ambiguità, non esitate a contattarci sul forum.

Guarda anche