Anotujte dokumenty PDF pomocí Pythonu

Pomocí Pythonu můžete programově anotovat jakýkoli dokument PDF v cloudu. Mohou to být jakékoli další informace o existujícím datovém souboru ve formě obrázků, komentářů, poznámek nebo jiných typů externích poznámek v dokumentu. V tomto článku se dozvíte, jak anotovat dokumenty PDF pomocí REST API v Pythonu.

Tento článek bude obsahovat následující témata:

Anotace dokumentu REST API a Python SDK

Pro anotování PDF dokumentů budu používat Python SDK of GroupDocs.Annotation Cloud API. Umožňuje programově vytvářet online nástroje pro anotaci dokumentů. Do obchodních dokumentů všech oblíbených formátů můžete přidávat anotace, překrytí vodoznakem, nahrazování textu, redigování a textová označení. Poskytuje také .NET, Java, PHP, Ruby a Node.js SDK jako členové rodiny anotací dokumentu pro Cloud API.

GroupDocs.Annotation Cloud můžete nainstalovat do svého projektu Python pomocí následujícího příkazu v konzole:

pip install groupdocs_annotation_cloud

Než začnete postupovat podle kroků a dostupných příkladů kódu, získejte své ID klienta a tajný klíč klienta z dashboard. Jakmile budete mít své ID a tajemství, přidejte kód, jak je uvedeno níže:

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 = ""

Anotujte dokumenty PDF pomocí REST API v Pythonu

Do dokumentů PDF můžete přidat anotace podle následujících jednoduchých kroků:

  1. Nahrát soubor PDF do cloudu
  2. Anotovat dokumenty PDF pomocí Pythonu
  3. Stáhnout anotovaný soubor

Nahrajte dokument

Nejprve nahrajte soubor PDF do cloudu pomocí následující ukázky kódu:

# vytvořit instanci api
file_api = groupdocs_annotation_cloud.FileApi.from_config(configuration)
my_storage = ""

# nahrát ukázkový soubor
request = groupdocs_annotation_cloud.UploadFileRequest("sample.pdf", "C:\\Files\\sample.pdf", my_storage)
response = file_api.upload_file(request)

V důsledku toho bude nahraný soubor PDF dostupný v sekce souborů vašeho řídicího panelu v cloudu.

Anotujte dokumenty PDF pomocí Pythonu

Chcete-li do dokumentu PDF programově přidat více anotací, postupujte podle níže uvedených kroků.

  • Vytvořte instanci AnnotateApi
  • Vytvořte první instanci AnnotationInfo
  • Nastavte vlastnosti anotace pro první instanci, např. pozici, typ, text atd.
  • Vytvořte druhou instanci AnnotationInfo
  • Nastavte vlastnosti anotace pro druhou instanci, např. pozici, typ, text atd.
  • Vytvořte třetí instanci AnnotationInfo
  • Nastavte vlastnosti anotace pro třetí instanci, např. pozici, typ, text atd.
  • Vytvořte instanci FileInfo a nastavte cestu k vstupnímu souboru
  • Vytvořte instanci AnnotateOptions a nastavte informace o souboru na AnnotateOptions
  • Přiřaďte první, druhou a třetí anotaci k AnnotateOptions
  • Vytvořte požadavek voláním metody AnnotateRequest
  • Získejte výsledky voláním metody AnnotateApi.annotate()

Následující ukázka kódu ukazuje, jak anotovat dokument PDF a přidat více anotací pomocí REST API.

# inicializovat api
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)

# anotace vzdálenosti
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 anotace vzdálenosti"
a1.creator_name = "Anonym A."

# oblastní anotace
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 oblastní anotace"
a2.creator_name = "Anonym A."

# anotace šipky
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 anotace šipky"
a3.creator_name = "Anonym A."

# vložte soubor
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"

# definovat možnosti anotace
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1, a2, a3]
options.output_path = "output.pdf"

# vytvořit požadavek na anotaci
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)         

print("AddMultipleAnnotations: Multiple Annotations added: " + result['href'])
Přidejte více anotací do dokumentu PDF pomocí REST API v Pythonu

Přidejte více anotací do dokumentu PDF pomocí REST API v Pythonu

Více o podporovaných typech anotací si můžete přečíst v sekci přidávání anotací v dokumentaci.

Stáhněte si soubor s poznámkami

Výše uvedená ukázka kódu uloží anotovaný soubor PDF do cloudu. Můžete si jej stáhnout pomocí následující ukázky kódu:

# inicializace api
file_api = groupdocs_annotation_cloud.FileApi.from_config(configuration)
my_storage = ""

# vytvořit požadavek na stažení
request = groupdocs_annotation_cloud.DownloadFileRequest("output.pdf", my_storage)
response = file_api.download_file(request)

# Přesuňte stažený soubor do svého pracovního adresáře
shutil.move(response, "C:\\Files\\")

Přidejte poznámky TextField pomocí Pythonu

Anotace textových polí můžete do dokumentů PDF přidat programově podle následujících kroků:

  • Vytvořte instanci AnnotateApi
  • Vytvořte instanci AnnotationInfo
  • Definujte pozici anotace
  • Definujte polohu, výšku a šířku obdélníku
  • Nastavte různé vlastnosti anotace, např. text, výšku, šířku atd.
  • Nastavte typ anotace jako TextField
  • Vytvořte instanci FileInfo a nastavte cestu k vstupnímu souboru
  • Vytvořte instanci AnnotateOptions a nastavte informace o souboru na AnnotateOptions
  • Přiřaďte anotaci k AnnotateOptions
  • Vytvořte požadavek voláním metody AnnotateRequest
  • Získejte výsledky voláním metody AnnotateApi.annotate()

Následující ukázka kódu ukazuje, jak přidat anotace textových polí do dokumentu PDF pomocí REST API. Chcete-li nahrát a stáhnout soubor, postupujte podle výše uvedených kroků.

# inicializovat api
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)

# poskytnout anotační informace
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."

# cesta k vstupnímu souboru
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"

# definovat možnosti anotace
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1]
options.output_path = "output.pdf"

# vytvořit požadavek na anotaci
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)         

print("AddTextFieldAnnotation: Text Field Annotation added: " + result['href'])
Přidejte poznámky k textovým polím pomocí Pythonu

Přidejte poznámky k textovým polím pomocí Pythonu

Přidejte anotace obrázků pomocí Pythonu

Do dokumentů PDF můžete přidat anotace obrázků programově podle následujících kroků:

  • Vytvořte instanci AnnotateApi
  • Vytvořte instanci AnnotationInfo
  • Definujte obdélník a nastavte jeho polohu, výšku a šířku
  • Nastavte různé vlastnosti anotace, např. pozici, text, výšku, šířku atd.
  • Nastavte typ anotace jako Obrázek
  • Vytvořte instanci FileInfo a nastavte cestu k vstupnímu souboru
  • Vytvořte instanci AnnotateOptions a nastavte informace o souboru na AnnotateOptions
  • Přiřaďte anotaci k AnnotateOptions
  • Vytvořte požadavek voláním metody AnnotateRequest
  • Získejte výsledky voláním metody AnnotateApi.annotate()

Následující ukázka kódu ukazuje, jak přidat anotace obrázku do dokumentu PDF pomocí REST API. Chcete-li nahrát a stáhnout soubor, postupujte podle výše uvedených kroků.

# inicializovat api
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)

# definovat anotaci
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"

# cesta k vstupnímu souboru
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"

# definovat anotaci options
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1]
options.output_path = "output_img.pdf"

# vytvořit žádost o anotaci
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)         

print("AddImageAnnotation: Image Annotation added: " + result['href'])
Přidejte anotace obrázků pomocí Pythonu

Přidejte anotace obrázků pomocí Pythonu

Do dokumentů PDF můžete přidat anotace hypertextových odkazů programově podle následujících kroků:

  • Vytvořte instanci AnnotateApi
  • Vytvořte instanci AnnotationInfo
  • Definujte anotační body a nastavte polohu pro každý bod
  • Nastavte různé vlastnosti anotace, např. text, výšku, šířku atd.
  • Nastavte typ anotace jako Odkaz
  • Vytvořte instanci FileInfo a nastavte cestu k vstupnímu souboru
  • Vytvořte instanci AnnotateOptions a nastavte informace o souboru na AnnotateOptions
  • Přiřaďte anotaci k AnnotateOptions
  • Vytvořte požadavek voláním metody AnnotateRequest
  • Získejte výsledky voláním metody AnnotateApi.annotate()

Následující ukázka kódu ukazuje, jak přidat anotace hypertextového odkazu do dokumentu PDF pomocí REST API. Chcete-li nahrát a stáhnout soubor, postupujte podle výše uvedených kroků.

# inicializovat api
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)

# poskytnout anotační informace
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/"

# cesta k vstupnímu souboru
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "sample.pdf"

# definovat možnosti anotace
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1]
options.output_path = "output.pdf"

# vytvořit požadavek na anotaci
request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)         

print("AddLinkAnnotation: Link Annotation added: " + result['href'])
Anotace pomocí anotací odkazů pomocí Pythonu

Anotace pomocí anotací odkazů pomocí Pythonu

Vyzkoušejte online

Vyzkoušejte prosím následující bezplatný online nástroj pro anotaci PDF, který je vyvinut pomocí výše uvedeného API. https://products.groupdocs.app/annotation/pdf

Závěr

V tomto článku jste se naučili přidávat různé typy anotací do dokumentů PDF v cloudu. Dále jste se naučili, jak programově nahrát soubor PDF do cloudu a poté stáhnout soubor s poznámkami z cloudu. Více o GroupDocs.Annotation Cloud API se můžete dozvědět pomocí dokumentace. Poskytujeme také sekci API Reference, která vám umožní vizualizovat a pracovat s našimi API přímo prostřednictvím prohlížeče. V případě jakýchkoliv nejasností nás neváhejte kontaktovat na fóru.

Viz také