クラウドPython SDKでPDF内のリンクを置換する方法
PDF内のリンクを置換するために、 Aspose.PDF Cloud Python SDKを使用します。このクラウドSDKは、PythonプログラマーがAspose.PDF REST APIを介してクラウドベースのPDFクリエーター、アノテーター、エディター、コンバーターアプリを開発するのに役立ちます。Aspose for Cloudでアカウントを作成し、アプリケーション情報を取得してください。App SID & キーを取得したら、Aspose.PDF Cloud Python SDKを試す準備が整います。PythonパッケージがGithubにホストされている場合、Githubから直接インストールできます:
Githubからのインストール
pip install git+https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-python.git
パッケージマネージャーコンソールコマンド
pip install asposepdfcloud
Python SDKを使用してPDF内のリンクを置換する手順
Aspose.PDF Cloudの開発者は、わずか数行のコードでPDF内のリンクを簡単に読み込み、置換できます。
- Python SDKをインストール
- Aspose CloudサーバーにPDFドキュメントをアップロード
- Aspose Cloudサーバーから処理済みのPDFドキュメントをダウンロード
- 特定のPDFドキュメントのすべてのハイパーリンク注釈を表示
- 特定のPDFドキュメントのすべてのハイパーリンク注釈を取得
- リンク注釈を置換
システム要件
Aspose.PDF Cloud Python SDKは、インストールが不要で簡単に始められます。Aspose for Cloudでアカウントを作成し、アプリケーション情報を取得してください。App SID & キーを取得したら、Aspose.PDF Cloud Python SDKを試す準備が整います。
- Python 2.7 および 3.4+
Pythonを使用してPDF内のリンクを置換
import shutil
import json
import logging
from pathlib import Path
from asposepdfcloud import ApiClient, PdfApi, LinkAnnotationsResponse, LinkAnnotationResponse
class Config:
"""Configuration parameters."""
CREDENTIALS_FILE = Path(r"C:\\Projects\\ASPOSE\\Pdf.Cloud\\Credentials\\credentials.json")
LOCAL_FOLDER = Path(r"C:\\Samples")
PDF_DOCUMENT_NAME = "sample.pdf"
LOCAL_RESULT_DOCUMENT_NAME = "output_sample.pdf"
NEW_LINK_ACTION = "https://reference.aspose.cloud/pdf/"
PAGE_NUMBER = 2
LINK_FIND_ID = "GI5UO32UN5KVESKBMN2GS33OHMZTEMJMGUYDQLBTGYYCYNJSGE"
# Configure logging
logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s")
class PdfLinks:
"""Class for managing PDF links using Aspose PDF Cloud API."""
def __init__(self, credentials_file: Path = Config.CREDENTIALS_FILE):
self.pdf_api = None
self._init_api(credentials_file)
def _init_api(self, credentials_file: Path):
"""Initialize the API client."""
try:
with credentials_file.open("r", encoding="utf-8") as file:
credentials = json.load(file)
api_key, app_id = credentials.get("key"), credentials.get("id")
if not api_key or not app_id:
raise ValueError("Error: Missing API keys in the credentials file.")
self.pdf_api = PdfApi(ApiClient(api_key, app_id))
except (FileNotFoundError, json.JSONDecodeError, ValueError) as e:
logging.error(f"Failed to load credentials: {e}")
def upload_document(self):
"""Upload a PDF document to the Aspose Cloud server."""
if self.pdf_api:
file_path = Config.LOCAL_FOLDER / Config.PDF_DOCUMENT_NAME
try:
self.pdf_api.upload_file(Config.PDF_DOCUMENT_NAME, str(file_path))
logging.info(f"File {Config.PDF_DOCUMENT_NAME} uploaded successfully.")
except Exception as e:
logging.error(f"Failed to upload file: {e}")
def download_result(self):
"""Download the processed PDF document from the Aspose Cloud server."""
if self.pdf_api:
try:
temp_file = self.pdf_api.download_file(Config.PDF_DOCUMENT_NAME)
local_path = Config.LOCAL_FOLDER / Config.LOCAL_RESULT_DOCUMENT_NAME
shutil.move(temp_file, str(local_path))
logging.info(f"download_result(): File successfully downloaded: {local_path}")
except Exception as e:
logging.error(f"download_result(): Failed to download file: {e}")
def show_links_array(self, links, prefix):
"""Show all hyperlink annotations for a specific PDF document."""
for item in links:
logging.info(f"{prefix} Link ID: '{item.id}' - Link Action: '{item.action}'")
def get_all_links(self):
"""Get all hyperlink annotations for a specific PDF document."""
if self.pdf_api:
try:
response = self.pdf_api.get_page_link_annotations( Config.PDF_DOCUMENT_NAME, Config.PAGE_NUMBER)
if response.code == 200:
self.show_links_array(response.links.list, "All: ")
else:
logging.error(f"Failed to add link to the page. Response code: {response.code}")
except Exception as e:
logging.error(f"Error while adding link: No links found - {e}")
def get_link_by_id(self) -> LinkAnnotationResponse:
if self.pdf_api:
result_link: LinkAnnotationResponse = self.pdf_api.get_link_annotation(Config.PDF_DOCUMENT_NAME, Config.LINK_FIND_ID)
if result_link.code == 200:
return result_link
print("Link not found.")
return None
def replace_link(self):
if self.pdf_api:
link_annotation: LinkAnnotationResponse = self.get_link_by_id()
if not link_annotation:
return
link_annotation.link.action = Config.NEW_LINK_ACTION
response: LinkAnnotationsResponse = self.pdf_api.put_link_annotation(
Config.PDF_DOCUMENT_NAME,
Config.LINK_FIND_ID,
link_annotation.link,
)
if response.code == 200:
print("Link annotation replaced successfully.")
else:
print("Failed to replace link annotation.")
if __name__ == "__main__":
pdf_links = PdfLinks()
pdf_links.upload_document()
pdf_links.get_all_links()
pdf_links.replace_link()
pdf_links.download_result()
PDF内のリンクを操作
定期的にPDFドキュメント内のハイパーリンクをレビューして更新することで、その関連性、正確性、およびセキュリティを維持し、読者により良い体験を提供できます。 Aspose.PDF Cloud Python SDKでPDFドキュメント内のリンクを置換。
Pythonライブラリでできること:
- PDFドキュメントを結合。
- PDFファイルを分割。
- PDFを他の形式に変換、またその逆も可能。
- 注釈を操作。
- PDF内の画像を操作、など。
- 機能をオンラインでテストするために、無料アプリを試すことができます。