Puoi annotare qualsiasi documento PDF in modo programmatico sul cloud utilizzando Python. Può trattarsi di qualsiasi informazione aggiuntiva su un dato esistente sotto forma di immagini, commenti, note o altri tipi di commenti esterni nel documento. In questo articolo imparerai come annotare documenti PDF utilizzando un’API REST in Python.
In questo articolo saranno trattati i seguenti argomenti:
- API REST di annotazione del documento e SDK Python
- Annota i documenti PDF utilizzando un’API REST in Python
- Aggiungi annotazioni TextField usando Python
- Aggiungi annotazioni immagine usando Python
- Annota con le annotazioni di collegamento utilizzando Python
API REST di annotazione del documento e SDK Python
Per annotare i documenti PDF, utilizzerò l’API Python SDK of GroupDocs.Annotation Cloud. Consente di creare in modo programmatico strumenti di annotazione di documenti online. È possibile aggiungere annotazioni, sovrimpressioni di filigrane, sostituzioni di testo, redazioni e contrassegni di testo ai documenti aziendali di tutti i formati più diffusi. Fornisce inoltre SDK .NET, Java, PHP, Ruby e Node.js come document annotation family members per l’API Cloud.
Puoi installare GroupDocs.Annotation Cloud nel tuo progetto Python utilizzando il seguente comando nella console:
pip install groupdocs_annotation_cloud
Ottieni il tuo ID cliente e il tuo segreto cliente dalla dashboard prima di iniziare a seguire i passaggi e gli esempi di codice disponibili. Una volta che hai il tuo ID e segreto, aggiungi il codice come mostrato di seguito:
client_id = "659fe7da-715b-4744-a0f7-cf469a392b73"
client_secret = "b377c36cfa28fa69960ebac6b6e36421"
configuration = groupdocs_annotation_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
my_storage = ""
Annota i documenti PDF utilizzando un’API REST in Python
Puoi aggiungere annotazioni ai tuoi documenti PDF seguendo i semplici passaggi indicati di seguito:
- Carica il file PDF nel Cloud
- Annota documenti PDF usando Python
- Scarica il file annotato
Carica il documento
Innanzitutto, carica il file PDF nel cloud utilizzando il seguente esempio di codice:
# creare un'istanza dell'API
file_api = groupdocs_annotation_cloud.FileApi.from_config(configuration)
my_storage = ""
# caricare file di esempio
request = groupdocs_annotation_cloud.UploadFileRequest("sample.pdf", "C:\\Files\\sample.pdf", my_storage)
response = file_api.upload_file(request)
Di conseguenza, il file PDF caricato sarà disponibile nella sezione file della dashboard sul cloud.
Annota documenti PDF usando Python
Si prega di seguire i passaggi indicati di seguito per aggiungere più annotazioni al documento PDF a livello di codice.
- Crea un’istanza di AnnotateApi
- Crea la prima istanza di AnnotationInfo
- Imposta le proprietà di annotazione per la prima istanza, ad esempio posizione, tipo, testo, ecc.
- Crea una seconda istanza di AnnotationInfo
- Imposta le proprietà di annotazione per la seconda istanza, ad esempio posizione, tipo, testo, ecc.
- Crea la terza istanza di AnnotationInfo
- Imposta le proprietà di annotazione per la terza istanza, ad esempio posizione, tipo, testo, ecc.
- Crea un’istanza FileInfo e imposta il percorso del file di input
- Crea un’istanza di AnnotateOptions e imposta le informazioni sul file su AnnotateOptions
- Assegna la prima, la seconda e la terza annotazione a AnnotateOptions
- Crea una richiesta chiamando il metodo AnnotateRequest
- Ottieni risultati chiamando il metodo AnnotateApi.annotate().
L’esempio di codice seguente mostra come annotare un documento PDF e aggiungere più annotazioni utilizzando un’API REST.
# inizializza l'API
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)
# annotazione della distanza
a1 = groupdocs_annotation_cloud.AnnotationInfo()
a1.annotation_position = groupdocs_annotation_cloud.Point()
a1.annotation_position.x = 1
a1.annotation_position.y = 1
a1.box = groupdocs_annotation_cloud.Rectangle()
a1.box.x = 100
a1.box.y = 100
a1.box.width = 200
a1.box.height = 200
a1.page_number = 0
a1.pen_color = 1201033
a1.pen_style = "Solid"
a1.pen_width = 3
a1.opacity = 1
a1.type = "Distance"
a1.text = "This is annotazione della distanza"
a1.creator_name = "Anonym A."
# annotazione dell'area
a2 = groupdocs_annotation_cloud.AnnotationInfo()
a2.annotation_position = groupdocs_annotation_cloud.Point()
a2.annotation_position.x = 1
a2.annotation_position.y = 1
a2.box = groupdocs_annotation_cloud.Rectangle()
a2.box.x = 100
a2.box.y = 400
a2.box.width = 200
a2.box.height = 100
a2.page_number = 0
a2.pen_color = 1201033
a2.pen_style = "Solid"
a2.pen_width = 3
a2.opacity = 1
a2.type = "Area"
a2.text = "This is annotazione dell'area"
a2.creator_name = "Anonym A."
# annotazione a freccia
a3 = groupdocs_annotation_cloud.AnnotationInfo()
a3.annotation_position = groupdocs_annotation_cloud.Point()
a3.annotation_position.x = 1
a3.annotation_position.y = 1
a3.box = groupdocs_annotation_cloud.Rectangle()
a3.box.x = 100
a3.box.y = 250
a3.box.width = 100
a3.box.height = 50
a3.page_number = 0
a3.pen_color = 1201033
a3.pen_style = "Solid"
a3.pen_width = 1
a3.opacity = 0.7
a3.type = "Arrow"
a3.text = "This is annotazione a freccia"
a3.creator_name = "Anonym A."
# file di input
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"
# definire le opzioni di annotazione
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1, a2, a3]
options.output_path = "output.pdf"
# creare richiesta di annotazione
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)
print("AddMultipleAnnotations: Multiple Annotations added: " + result['href'])
Aggiungi più annotazioni al documento PDF utilizzando un’API REST in Python
Puoi leggere ulteriori informazioni sui tipi di annotazione supportati nella sezione aggiunta di annotazioni nella documentazione.
Scarica il file annotato
L’esempio di codice precedente salverà il file PDF con annotazioni sul cloud. Puoi scaricarlo utilizzando il seguente esempio di codice:
# inizializzazione dell'API
file_api = groupdocs_annotation_cloud.FileApi.from_config(configuration)
my_storage = ""
# creare richiesta di download
request = groupdocs_annotation_cloud.DownloadFileRequest("output.pdf", my_storage)
response = file_api.download_file(request)
# Sposta il file scaricato nella tua directory di lavoro
shutil.move(response, "C:\\Files\\")
Aggiungi annotazioni TextField usando Python
È possibile aggiungere annotazioni del campo di testo nei documenti PDF in modo programmatico seguendo i passaggi indicati di seguito:
- Crea un’istanza di AnnotateApi
- Crea un’istanza di AnnotationInfo
- Definire la posizione dell’annotazione
- Definisce la posizione, l’altezza e la larghezza del rettangolo
- Imposta varie proprietà di annotazione, ad esempio testo, altezza, larghezza, ecc.
- Imposta il tipo di annotazione come TextField
- Crea un’istanza FileInfo e imposta il percorso del file di input
- Crea un’istanza di AnnotateOptions e imposta le informazioni sul file su AnnotateOptions
- Assegna l’annotazione a AnnotateOptions
- Crea una richiesta chiamando il metodo AnnotateRequest
- Ottieni risultati chiamando il metodo AnnotateApi.annotate().
L’esempio di codice seguente mostra come aggiungere annotazioni di campo di testo nel documento PDF utilizzando un’API REST. Si prega di seguire i passaggi menzionati in precedenza per caricare e scaricare un file.
# inizializza l'API
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)
# fornire informazioni di annotazione
a1 = groupdocs_annotation_cloud.AnnotationInfo()
a1.annotation_position = groupdocs_annotation_cloud.Point()
a1.annotation_position.x = 1
a1.annotation_position.y = 1
a1.box = groupdocs_annotation_cloud.Rectangle()
a1.box.x = 380
a1.box.y = 300
a1.box.width = 100
a1.box.height = 50
a1.page_number = 0
a1.font_color = 1201033
a1.font_size = 12
a1.opacity = 0.7
a1.type = "TextField"
a1.text = "Text field text"
a1.creator_name = "Anonym A."
# percorso del file di input
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"
# definire le opzioni di annotazione
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1]
options.output_path = "output.pdf"
# creare richiesta di annotazione
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)
print("AddTextFieldAnnotation: Text Field Annotation added: " + result['href'])
Aggiungi annotazioni ai campi di testo utilizzando Python
Aggiungi annotazioni immagine usando Python
Puoi aggiungere annotazioni immagine nei tuoi documenti PDF in modo programmatico seguendo i passaggi indicati di seguito:
- Crea un’istanza di AnnotateApi
- Crea un’istanza di AnnotationInfo
- Definisci Rettangolo e impostane posizione, altezza e larghezza
- Imposta varie proprietà di annotazione, ad esempio posizione, testo, altezza, larghezza, ecc.
- Imposta il tipo di annotazione come Immagine
- Crea un’istanza FileInfo e imposta il percorso del file di input
- Crea un’istanza di AnnotateOptions e imposta le informazioni sul file su AnnotateOptions
- Assegna l’annotazione a AnnotateOptions
- Crea una richiesta chiamando il metodo AnnotateRequest
- Ottieni risultati chiamando il metodo AnnotateApi.annotate().
L’esempio di codice seguente mostra come aggiungere annotazioni immagine nel documento PDF utilizzando un’API REST. Si prega di seguire i passaggi menzionati in precedenza per caricare e scaricare un file.
# inizializza l'API
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)
# definire l'annotazione
a1 = groupdocs_annotation_cloud.AnnotationInfo()
a1.box = groupdocs_annotation_cloud.Rectangle()
a1.box.x = 300
a1.box.y = 300
a1.box.width = 200
a1.box.height = 100
a1.page_number = 0
a1.pen_color = 1201033
a1.pen_style = "Solid"
a1.pen_width = 1
a1.opacity = 0.7
a1.type = "Image"
a1.text = "This is Image annotation"
a1.creator_name = "Anonym A."
a1.image_path = "JohnSmith.png"
# percorso del file di input
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"
# definire l'annotazione options
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1]
options.output_path = "output_img.pdf"
# creare richiesta di annotazione
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)
print("AddImageAnnotation: Image Annotation added: " + result['href'])
Aggiungi annotazioni immagine usando Python
Annota con le annotazioni di collegamento utilizzando Python
È possibile aggiungere annotazioni di collegamenti ipertestuali nei documenti PDF in modo programmatico seguendo i passaggi indicati di seguito:
- Crea un’istanza di AnnotateApi
- Crea un’istanza di AnnotationInfo
- Definire i punti di annotazione e impostare la posizione per ciascun punto
- Imposta varie proprietà di annotazione, ad esempio testo, altezza, larghezza, ecc.
- Imposta il tipo di annotazione come Link
- Crea un’istanza FileInfo e imposta il percorso del file di input
- Crea un’istanza di AnnotateOptions e imposta le informazioni sul file su AnnotateOptions
- Assegna l’annotazione a AnnotateOptions
- Crea una richiesta chiamando il metodo AnnotateRequest
- Ottieni risultati chiamando il metodo AnnotateApi.annotate().
L’esempio di codice seguente mostra come aggiungere annotazioni di collegamenti ipertestuali nel documento PDF utilizzando un’API REST. Si prega di seguire i passaggi menzionati in precedenza per caricare e scaricare un file.
# inizializza l'API
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)
# fornire informazioni di annotazione
a1 = groupdocs_annotation_cloud.AnnotationInfo()
p1 = groupdocs_annotation_cloud.Point()
p1.x = 80
p1.y = 710
p2 = groupdocs_annotation_cloud.Point()
p2.x = 240
p2.y = 710
p3 = groupdocs_annotation_cloud.Point()
p3.x = 80
p3.y = 650
p4 = groupdocs_annotation_cloud.Point()
p4.x = 240
p4.y = 650
a1.points = [p1, p2, p3, p4]
a1.page_number = 0
a1.type = "Link"
a1.text = "This is Link annotation"
a1.creator_name = "Anonym A."
a1.url = "https://www.groupdocs.com/"
# percorso del file di input
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"
# definire le opzioni di annotazione
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1]
options.output_path = "output.pdf"
# creare richiesta di annotazione
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)
print("AddLinkAnnotation: Link Annotation added: " + result['href'])
Annota con le annotazioni di collegamento utilizzando Python
Prova in linea
Prova il seguente strumento di annotazione PDF online gratuito, sviluppato utilizzando l’API di cui sopra. https://products.groupdocs.app/annotation/pdf
Conclusione
In questo articolo, hai imparato come aggiungere vari tipi di annotazioni ai documenti PDF nel cloud. Inoltre, hai imparato come caricare in modo programmatico il file PDF sul cloud e quindi scaricare il file annotato dal cloud. Puoi saperne di più su GroupDocs.Annotation 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 ambiguità, non esitate a contattarci sul forum.